{"id":47709890,"url":"https://github.com/tsukumogami/shirabe","last_synced_at":"2026-05-17T00:17:29.509Z","repository":{"id":344962346,"uuid":"1183820632","full_name":"tsukumogami/shirabe","owner":"tsukumogami","description":"Structured workflow skills for AI coding agents","archived":false,"fork":false,"pushed_at":"2026-03-25T03:25:13.000Z","size":242,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-25T14:52:10.977Z","etag":null,"topics":["ai-agents","claude-code","developer-tools","plugin","workflow"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tsukumogami.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-03-17T01:30:06.000Z","updated_at":"2026-03-25T03:05:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tsukumogami/shirabe","commit_stats":null,"previous_names":["tsukumogami/shirabe"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/tsukumogami/shirabe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsukumogami%2Fshirabe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsukumogami%2Fshirabe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsukumogami%2Fshirabe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsukumogami%2Fshirabe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tsukumogami","download_url":"https://codeload.github.com/tsukumogami/shirabe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsukumogami%2Fshirabe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"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-code","developer-tools","plugin","workflow"],"created_at":"2026-04-02T18:28:51.985Z","updated_at":"2026-05-17T00:17:29.503Z","avatar_url":"https://github.com/tsukumogami.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# shirabe (調べ)\n\nStructured workflow skills for AI coding agents.\n\nshirabe is a [Claude Code](https://docs.anthropic.com/en/docs/claude-code)\nplugin that adds multi-phase workflows for the thinking that happens *before*\ncoding. Instead of jumping straight from idea to implementation, shirabe guides\nyou through research, requirements, design, planning, and review -- each with\nbuilt-in validation gates so nothing important gets skipped.\n\n**Pronunciation:** shee-RAH-beh\n\n## Skills\n\n| Skill | What it does |\n|-------|-------------|\n| `/explore` | Fan out research agents to investigate options and figure out which artifact to produce next (PRD, design doc, plan, or something else) |\n| `/prd` | Capture product requirements with numbered criteria through conversational scoping and parallel research |\n| `/design` | Produce a technical design document by decomposing the problem into decision questions and evaluating trade-offs |\n| `/decision` | Structured decision-making for contested choices with adversarial agents, cross-examination, and synthesis |\n| `/plan` | Decompose a design doc or PRD into sequenced GitHub issues with dependency graphs and complexity labels |\n| `/review-plan` | Adversarial review of a plan across scope, design fidelity, acceptance criteria, and sequencing |\n| `/work-on` | Implement a GitHub issue, milestone, or full plan end-to-end: branch, analysis, code, three-panel review, tests, and pull request |\n\nSkills are designed to chain together. `/explore` helps you figure out what you\nneed, then hands off to `/prd`, `/design`, or `/plan`. `/review-plan` catches\nproblems in a plan before issues get created. `/work-on` picks up individual\nissues and delivers PRs.\n\n## Example: building a plugin system from scratch\n\nHere's what it looks like to use shirabe for a non-trivial feature -- say you\nneed to add a plugin system to your CLI tool, but you're not sure where to start.\n\n**Step 1 -- Explore.** You run `/explore plugin system` and describe what you're\nthinking. shirabe spins up research agents that look at how your codebase is\nstructured, what plugin approaches exist, and what constraints matter. After a\nfew rounds of convergence, it recommends producing a PRD first (since you\nhaven't nailed down requirements yet) and a design doc after.\n\n**Step 2 -- Requirements.** You run `/prd plugin system`. Through a\nconversational scoping phase, shirabe narrows the feature to concrete\nrequirements: \"plugins must be loadable from a directory\", \"plugins declare\ncapabilities via a manifest file\", etc. Parallel research agents check your\ncodebase for existing patterns. A 3-agent jury reviews the draft for\ncompleteness and consistency.\n\n**Step 3 -- Design.** You run `/design docs/PRD-plugin-system.md`. shirabe\ndecomposes the PRD into decision questions: \"how should plugins be discovered?\",\n\"what's the manifest format?\", \"how do we handle version conflicts?\" Each\nquestion gets a structured trade-off analysis with alternatives. The final\ndesign doc captures the chosen approach with rationale.\n\n**Step 4 -- Plan.** You run `/plan docs/DESIGN-plugin-system.md`. shirabe\nbreaks the design into atomic issues, ordered by dependency. A walking skeleton\nissue comes first so you can validate the end-to-end flow early. Each issue gets\nacceptance criteria specific enough to verify mechanically. `/review-plan` then\nchallenges the plan before any issues are created -- catching gaps in scope,\nweak acceptance criteria, or sequencing problems.\n\n**Step 5 -- Implement.** You run `/work-on M3` (the milestone). shirabe picks\nthe first unblocked issue, creates a branch, analyzes the code, implements\nthe change, runs it through a three-panel review (completeness/justification/intent,\nthen pragmatic/architect/maintainer, then QA), and opens a PR. When that one\nmerges, you run it again for the next issue.\n\nOr you can hand the whole plan to `/work-on docs/plans/PLAN-plugin-system.md`.\nThat mode runs the plan as a batch: shirabe creates one shared branch and\ndraft PR, spawns a child workflow per issue with dependency-aware scheduling,\nand once CI passes on the ready PR it walks the `upstream` chain of artifacts\n(plan → design → PRD → roadmap), applies the lifecycle transition at each\nnode, and pushes those changes as a final commit on the same PR. The PR then\nmerges with the upstream artifacts already transitioned. Issues tagged `docs`\nor `task` skip the code-review panels so documentation-only work doesn't pay\nfor gates it doesn't need.\n\nThe whole process produces a paper trail -- PRD, design doc, plan, and focused\nPRs -- that you can point to later when someone asks \"why did we build it this\nway?\"\n\n## Installation\n\nRegister the shirabe marketplace and install the plugin:\n\n```bash\nclaude plugin marketplace add \"tsukumogami/shirabe\" --scope user\nclaude plugin install shirabe@shirabe --scope project\n```\n\nThe first command registers the marketplace from GitHub (one-time per\nmachine). The second installs the plugin to the current project.\n\nOnce the marketplace is registered, you can also install from inside a\nClaude Code session:\n\n```\n/plugin install shirabe@shirabe\n```\n\n## Requirements\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)\n- [koto](https://github.com/tsukumogami/koto) \u003e= 0.2.1 (for `/work-on`;\n  installed automatically if missing)\n\n## Doc Validation\n\nshirabe ships a `validate` CLI and a reusable GitHub Actions workflow so\ndownstream repos can validate their doc formats on every PR.\n\n### Reusable workflow\n\nAdd this to `.github/workflows/validate-docs.yml` in your repo:\n\n```yaml\nname: Validate doc formats\non:\n  pull_request:\n    paths: ['docs/**']\njobs:\n  validate:\n    uses: tsukumogami/shirabe/.github/workflows/validate-docs.yml@v0.6.0\n```\n\nThe workflow checks out shirabe, builds the `shirabe` binary, diffs the PR's\nchanged files, and runs `shirabe validate` on any recognized doc formats\n(`DESIGN-*.md`, `PRD-*.md`, `VISION-*.md`, `ROADMAP-*.md`, `PLAN-*.md`). Files\nwith an unrecognized schema version are skipped with a `::notice` annotation\nrather than a hard failure, so teams can adopt validation incrementally.\n\nTo allow custom status values beyond the built-in enum, pass a YAML map:\n\n```yaml\n    uses: tsukumogami/shirabe/.github/workflows/validate-docs.yml@v0.6.0\n    with:\n      custom-statuses: |\n        prd: [Draft, Accepted, In Progress, Done, Delivered]\n```\n\nSee `docs/guides/doc-validation.md` for branch protection setup and\nmigration notes for repos with existing docs.\n\n### Local install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/tsukumogami/shirabe/main/install.sh | bash\n```\n\nInstalls `shirabe` to `~/.shirabe/bin/`. Add that directory to `PATH`, then\nrun `shirabe validate docs/designs/DESIGN-foo.md`.\n\n## Roadmap\n\n- **koto integration for remaining skills** -- `/work-on` already uses koto for\n  state machine enforcement; the other skills will follow\n- **Cross-repo workflow state** -- track multi-repo features through a shared\n  workflow state\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsukumogami%2Fshirabe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftsukumogami%2Fshirabe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsukumogami%2Fshirabe/lists"}