{"id":44076585,"url":"https://github.com/sighup/claude-workflow","last_synced_at":"2026-03-04T06:23:42.678Z","repository":{"id":334642662,"uuid":"1142023780","full_name":"sighup/claude-workflow","owner":"sighup","description":"Claude Code plugin for spec-driven development. Takes features from idea to validated implementation using structured specs, dependency-aware task graphs, and parallel agent execution.","archived":false,"fork":false,"pushed_at":"2026-02-08T07:17:29.000Z","size":200,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-08T13:23:08.642Z","etag":null,"topics":["ai-agents","claude","claude-code","developer-tools","spec-driven-development","task-automation"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sighup.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-25T20:38:07.000Z","updated_at":"2026-02-08T05:39:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sighup/claude-workflow","commit_stats":null,"previous_names":["sighup/claude-workflow"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/sighup/claude-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sighup%2Fclaude-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sighup%2Fclaude-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sighup%2Fclaude-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sighup%2Fclaude-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sighup","download_url":"https://codeload.github.com/sighup/claude-workflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sighup%2Fclaude-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29313092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T17:48:59.043Z","status":"ssl_error","status_checked_at":"2026-02-10T17:45:37.240Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude","claude-code","developer-tools","spec-driven-development","task-automation"],"created_at":"2026-02-08T07:40:03.094Z","updated_at":"2026-02-24T17:05:13.645Z","avatar_url":"https://github.com/sighup.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claude-workflow\n\nA Claude Code plugin that unifies spec-driven development, autonomous task execution, and parallel agent dispatch into a single workflow. Takes a feature from idea to validated implementation using structured specifications, dependency-aware task graphs, and evidence-based verification. \n\n## Install\n\n### From Git (recommended)\n\n```bash\n# Add the marketplace\nclaude plugin marketplace add https://github.com/sighup/claude-workflow.git\n\n# Install at project scope (shared with team via .claude/settings.json)\nclaude plugin install claude-workflow@claude-workflow --scope project\n\n# Or install at user scope (personal, across all projects)\nclaude plugin install claude-workflow@claude-workflow --scope user\n```\n\n### Interactive installation\n\n```bash\n/plugin\n# Navigate to Marketplaces tab → Add → paste the git URL\n# Then go to Discover tab → select claude-workflow → choose scope\n```\n\n## Workflow\n\n### Interactive (inside Claude)\n\n```\n/cw-spec  →  [/cw-gherkin]  →  /cw-plan  →  /cw-dispatch  →  /cw-validate\n```\n\nEach step can also be run independently. `/cw-execute` handles single-task execution for manual or shell-scripted loops. `/cw-review` adds a code review gate and `/cw-testing` generates and runs E2E tests.\n\n### Worktrees (manual parallel development)\n\nUse `/cw-worktree` to develop multiple features simultaneously. Each worktree gets its own feature branch and **isolated task list** (via `.claude/settings.local.json`). Tasks persist in `~/.claude/tasks/{worktree-name}/`, enabling seamless resume across sessions. See [examples/workflows.md](examples/workflows.md) for the full multi-terminal walkthrough.\n\n## Skills\n\n| Skill | Purpose |\n|-------|---------|\n| `/cw-spec` | Generate structured specification with demoable units and proof artifacts |\n| `/cw-plan` | Transform spec into native task graph with dependencies and metadata |\n| `/cw-execute` | Execute one task using the 11-phase protocol (orient → commit → clean exit) |\n| `/cw-dispatch` | Spawn parallel subagent workers for independent tasks (no setup required) |\n| `/cw-dispatch-team` | Persistent agent team with lead coordination for parallel task execution |\n| `/cw-validate` | Run 6 validation gates and produce a coverage matrix report |\n| `/cw-review` | Review implementation for bugs, security issues, and quality; creates fix tasks |\n| `/cw-review-team` | Concern-partitioned team review — each reviewer sees all files through a specialized lens (security, correctness, spec compliance) |\n| `/cw-testing` | E2E testing with auto-fix — generate tests from specs, execute, and fix failures |\n| `/cw-gherkin` | Generate Gherkin BDD scenarios from spec acceptance criteria; optionally creates cw-testing task stubs |\n| `/cw-worktree` | Manage git worktrees for multi-feature parallel development |\n\n## Prerequisites\n\nShell scripts require `jq`. The `gh` CLI is needed for PR creation in `cw-pipeline`.\n\nMost skills work out of the box. `/cw-dispatch-team` uses [Claude Code agent teams](https://code.claude.com/docs/en/agent-teams) which requires two env vars:\n\n```json\n// ~/.claude/settings.json (user-level) or .claude/settings.json (project-level)\n{\n  \"env\": {\n    \"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS\": \"1\",\n    \"CLAUDE_CODE_TASK_LIST_ID\": \"your-project-name\"\n  }\n}\n```\n\n`/cw-dispatch` (subagent workers) needs no setup and is the recommended default. `/cw-plan` will offer both options after task graph creation.\n\n## Task Metadata\n\nEvery task on the board carries self-contained metadata enabling autonomous execution:\n\n```json\n{\n  \"task_id\": \"T01\",\n  \"spec_path\": \"docs/specs/01-spec-auth/01-spec-auth.md\",\n  \"scope\": {\n    \"files_to_create\": [\"src/auth/login.ts\"],\n    \"files_to_modify\": [\"src/routes/index.ts\"],\n    \"patterns_to_follow\": [\"src/routes/health.ts\"]\n  },\n  \"requirements\": [\n    { \"id\": \"R01.1\", \"text\": \"POST /auth/login accepts credentials\", \"testable\": true }\n  ],\n  \"proof_artifacts\": [\n    { \"type\": \"test\", \"command\": \"npm test -- src/auth/login.test.ts\", \"expected\": \"All pass\" }\n  ],\n  \"commit\": { \"template\": \"feat(auth): add login endpoint\" },\n  \"verification\": {\n    \"pre\": [\"npm run lint\"],\n    \"post\": [\"npm test\"]\n  },\n  \"role\": \"implementer\",\n  \"complexity\": \"standard\",\n  \"model\": null\n}\n```\n\n## Shell Scripts\n\nShell scripts in `bin/` are optional and enable autonomous (unattended) execution without an interactive Claude session — useful for CI pipelines or scripted workflows. All core functionality is available through the skills above. See [examples/shell-scripts.md](examples/shell-scripts.md) for usage and environment variable reference.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsighup%2Fclaude-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsighup%2Fclaude-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsighup%2Fclaude-workflow/lists"}