Skip to main content
skill CX Codex

gsd-autonomous — Claude Code skill: setup and workflow

The gsd-autonomous Claude Code skill runs the remaining project phases through discussion, planning, and execution. It updates progress after each phase and closes the milestone.

MIT 577 installs ★ 11,761 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add open-gsd/gsd-core --skill gsd-autonomous -a claude-code
Open on GitHub

What gsd-autonomous does

gsd-autonomous moves through the unfinished phases of a milestone, discussing each one before planning and carrying out the work. It finds phases and project state through ROADMAP.md and gsd-tools commands.

Once the phases are done, the skill audits and completes the milestone, then cleans up. It updates .planning/STATE.md and .planning/ROADMAP.md and creates phase artifacts such as CONTEXT.md, plans, and summaries. It pauses for user decisions, blockers, and validation requests.

Use --from N and --to N to set a phase range, or --only N to run one phase. With --interactive, questions go to the user; --converge routes planning through gsd-plan-review-convergence. The --cross-ai flag is an alias for --converge.

What it helps with

  • run every unfinished milestone phase in sequence
  • limit a run to a selected phase
  • set the first and last phases for a run
  • carry project state and progress across phases

Example prompts for the agent

  • Run gsd-autonomous to work through the remaining milestone phases.
  • Run only phase 3 with gsd-autonomous --only 3.
  • Run phases 2 through 4 interactively with gsd-autonomous --from 2 --to 4 --interactive.

How to install gsd-autonomous

1Skills CLI (Vercel)

npx skills add open-gsd/gsd-core --skill gsd-autonomous -a claude-code

2Manually: put the files in place

~/.claude/skills/gsd-autonomous/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gsd-autonomous/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about gsd-autonomous

How do I install gsd-autonomous in Claude Code?

Run npx skills add open-gsd/gsd-core --skill gsd-autonomous -a claude-code. The skill file is at ~/.claude/skills/gsd-autonomous/SKILL.md.

What does gsd-autonomous do?

It works through the unfinished phases of a milestone, discussing, planning, and executing each one. It then audits and completes the milestone and cleans up.

How can I control which phases gsd-autonomous runs?

--from N sets the starting phase, --to N sets the stopping point, and --only N runs a single phase. --interactive leaves questions for the user, while --converge uses gsd-plan-review-convergence for planning.

Source text

SKILL.md · MIT
---
name: gsd-autonomous
description: "Run all remaining phases autonomously — discuss→plan→execute per phase"
argument-hint: "[--from N] [--to N] [--only N] [--interactive] [--converge]"
allowed-tools:
  - Read
  - Write
  - Bash
  - Glob
  - Grep
  - AskUserQuestion
  - Agent
---


<arguments>$ARGUMENTS</arguments>

The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.

<objective>
Execute all remaining milestone phases autonomously. For each phase: discuss → plan → execute. Pauses only for user decisions (hard-to-reverse and preference grey areas, blockers, validation requests).

Uses ROADMAP.md phase discovery and Skill() flat invocations for each phase command. After all phases complete: milestone audit → complete → cleanup.

**Creates/Updates:**
- `.planning/STATE.md` — updated after each phase
- `.planning/ROADMAP.md` — progress updated after each phase
- Phase artifacts — CONTEXT.md, PLANs, SUMMARYs per phase

**After:** Milestone is complete and cleaned up.
</objective>

<execution_context>
@~/.claude/gsd-core/workflows/autonomous.md
@~/.claude/gsd-core/references/ui-brand.md
</execution_context>

<context>
Optional flags:
- `--from N` — start from phase N instead of the first incomplete phase.
- `--to N` — stop after phase N completes (halt instead of advancing to next phase).
- `--only N` — execute only phase N (single-phase mode).
- `--interactive` — run discuss inline with questions (not auto-answered), then dispatch plan→execute as background agents. Keeps the main context lean while preserving user input on decisions.
- `--converge` — run each phase's planning step through `gsd-plan-review-convergence` instead of plain `gsd-plan-phase`. Works even when `workflow.plan_review_convergence` is `false` — the explicit flag overrides the gate; the gate (`workflow.plan_review_convergence=true` enables it) governs the standalone `gsd-plan-review-convergence` command. Without the flag, planning runs `gsd-plan-phase`.
- `--cross-ai` — compatibility alias for `--converge`.

When `--converge` or `--cross-ai` is set, reviewer selector flags supported by `gsd-plan-review-convergence` may be passed through: `--codex`, `--claude`, `--opencode`, `--ollama`, `--lm-studio`, `--llama-cpp`, `--all`, and `--max-cycles N`.

Project context, phase list, and state are resolved inside the workflow using init commands (`gsd-tools query init.milestone-op`, `gsd-tools query roadmap.analyze`). No upfront context loading needed.
</context>

<process>
Execute end-to-end.
Preserve all workflow gates (phase discovery, per-phase execution, blocker handling, progress display).
</process>

© open-gsd · MIT · open-gsd/gsd-core

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set72

The whole set →
gsd-complete-milestone gsd-complete-milestone — a skill for Claude Code that archives completed development milestones and prepares the project for the next version. It runs when closing a milestone to record progress and update documentation. CX Codex +1 577installs gsd-mempalace-capture The gsd-mempalace-capture skill for Claude Code stores phase artifacts in MemPalace and mirrors decision facts into a temporal knowledge graph. CX Codex +1 577installs gsd-ns-review The gsd-ns-review Claude Code skill routes requests to the right review or audit skill. It activates for code checks, security reviews, UI evaluation, and debugging. CX Codex +1 577installs gsd-health gsd-health is a Claude Code skill that checks the integrity of the .planning/ directory and finds configuration issues or orphaned plans. CX Codex +1 577installs gsd-extract-learnings gsd-extract-learnings is a Claude Code skill that analyzes completed-phase artifacts and saves structured insights to a separate file. It runs after tasks finish to capture engineering lessons. CX Codex +1 577installs gsd-resume-work The gsd-resume-work Claude Code skill restores project context after an earlier session. It checks unfinished work and selects a context-aware next step. CX Codex +1 577installs gsd-docs-update gsd-docs-update is a Claude Code skill that creates or revises project docs against the codebase. It can audit existing files or run a full documentation pass. CX Codex +1 576installs gsd-review-backlog The gsd-review-backlog Claude Code skill reviews backlog entries and offers to move them into the active milestone or delete them. It handles 999.x phases in a project. CX Codex +1 576installs

Project sponsors

Companies that keep this analytics open