By wintermaples
Spec-driven development skills: create and revise requirements/basic-design documents, implement from spec, and debug systematically
Use whenever implementation work needs code review, or when review feedback has been received. Combines requesting and receiving review into one loop. Trigger on phrases like "コードレビューして", "review this change", "実装できたのでレビュー", "before I merge", "レビューが返ってきた", "here is the review feedback", "reviewer said...". Dispatches a fresh reviewer subagent, then processes feedback with verify-then-fix discipline (verify each item against the codebase before implementing any fix). Do NOT trigger on T0/T1 tasks unless the user explicitly requests review. This skill is self-contained and MUST NOT delegate to any `superpowers:*` skill.
Use whenever the user wants to CREATE a new basic design document — whole-system (`docs/main-basic-design.md`) or subsystem (`docs/subsystems/{id}_{name}/{name}-design.md`, including nested subsystems like `docs/subsystems/.../subsystems/{id}_{name}/{name}-design.md`). Trigger on phrases like "基本設計を作る", "draft a basic design", "新しい設計書", or any request implying production of a fresh design artifact. This skill MUST NOT update an existing basic design document — it only creates new ones — and MUST halt if the corresponding requirements document does not exist.
Use whenever the user wants to CREATE a new detailed design document — whole-system (`docs/main-detail-design/index.md`) or subsystem (`docs/subsystems/{id}_{name}/detail-design/index.md`, including nested subsystems like `docs/subsystems/.../subsystems/{id}_{name}/detail-design/index.md`). Trigger on phrases like "詳細設計を作る", "詳細設計書を書きたい", "detail design を作って", "draft a detailed design", "create detail design", "モジュールの振る舞いを設計したい". Do NOT trigger for updates to existing detailed design documents — use `spec-coexist:revising` instead. This skill MUST NOT update existing detail design files — it only creates new ones — and MUST halt if the corresponding basic design document does not exist. This skill is self-contained and MUST NOT delegate to any `superpowers:*` skill.
Use whenever the user wants to CREATE a new requirements document — whole-system (`docs/main-requirements.md`) or subsystem (`docs/subsystems/{id}_{name}/{name}-requirements.md`, including nested subsystems like `docs/subsystems/.../subsystems/{id}_{name}/{name}-requirements.md`). Trigger on phrases like "要件定義を作る", "draft requirements", "new requirements doc", "要件をまとめたい", or any request that implies producing a fresh requirements artifact. This skill MUST NOT update an existing requirements document — it only creates new ones.
Use whenever the user wants a point-in-time status report of the project — completed requirements, in-progress work, uncovered REQ-IDs, and a dependency graph. Trigger on phrases like "スナップショットを生成して", "プロジェクトの現状を見たい", "ステークホルダー向けのレポート", "generate a delivery snapshot", "project status report", "what's the current state of requirements". Do NOT trigger for traceability matrix generation alone (use `build_traceability_matrix.sh` directly) or for spec creation/revision. This skill is self-contained and MUST NOT delegate to any `superpowers:*` skill.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Claude Code 向けの 仕様駆動開発 (spec-driven development) スキルスイート です。要件定義から基本設計・詳細設計・実装・仕様変更反映・デバッグまでの一連のワークフローを、Claude Code の Skills として提供します。
このスキルスイートのゴールは、「仕様」と「実装」を常に並走させる (coexist させる) ことです。そのために以下のスキル群を提供します。
| スキル | 用途 |
|---|---|
spec-coexist-router | タスクティアの自動判定 (T0–T3) と適切なスキルへのルーティング |
exploring-problem-space | まだ要件にできないアイデアや課題の整理・問題定義 |
creating-requirements | 新規の要件定義書 (docs/main-requirements.md またはサブシステム単位) を作成 |
creating-basic-design | 新規の基本設計書 (docs/main-basic-design.md またはサブシステム単位) を作成 |
creating-detail-design | 新規の詳細設計書 (detail-design/index.md + モジュール別ファイル) を作成。Mermaid 図で振る舞い・契約を定義し実装ブレを防ぐ |
implementing-from-spec | 既存の要件定義 + 基本設計に沿ってコードを TDD で実装 (詳細設計がある場合は追加入力として参照) |
fast-path | T0/T1 タスク (typo 修正、単関数追加等) を仕様文書なしで最短完了 |
revising | 要件定義 / 基本設計の改訂、および仕様変更の実装反映を統合的に処理 |
systematic-debugging | 仮説駆動の体系的デバッグ |
| スキル | 用途 |
|---|---|
test-driven-implementation | TDD の鉄則 (失敗テスト先行) を強制するサブスキル |
pre-review-self-check | コードレビュー前の自己チェック |
verification-before-completion | 完了宣言前に検証証拠を要求するゲート |
code-review-loop | コードレビューの依頼・フィードバック・修正ループ |
finishing-subsystem-work | 検証済み作業のコミット・プッシュ・マージ |
delivery-snapshot | プロジェクト現状レポートの生成 |
parallelizing-subsystem-work | git worktree による複数サブシステムの並列実装 |
各スキルは「既存ドキュメントを上書きしない」「改訂時は専用スキルを呼ぶ」といったガードレールを備えており、意図しない破壊的変更を防ぎます。要件定義・基本設計の対話を視覚的に進めるための Visual Companion (標準ライブラリだけで動く軽量 HTTP サーバ) も同梱しています。
各スキルの詳細な使い方は
.claude/skills/_docs/README.md(日本語) /.claude/skills/_docs/README.en.md(English) を参照してください。
spec-coexist-router がユーザーのメッセージを自動的に分類し、ティアに応じた最小限のプロセスだけを適用します。
| ティア | 規模 | 必要なプロセス |
|---|---|---|
| T0 | trivial (typo, ≤10行) | 直接編集のみ |
| T1 | small (単関数追加, バグ修正) | TDD + verification |
| T2 | medium (機能追加) | 要件 + 設計 + TDD + レビュー |
| T3 | large (新サブシステム) | フル仕様プロセス |
.
├── .claude/
│ └── skills/ ← 開発用のスキル本体 (ライブリロード対象)
│ ├── _docs/ ← スキルパッケージ利用ガイド (日本語・英語)
│ ├── _meta/ ← スキル作成者向けオーサリングガイド
│ ├── _shared/ ← 複数スキルで共有するスクリプトと参照資料
│ │ ├── scripts/ ← Visual Companion・補助シェルスクリプト等
│ │ ├── references/
│ │ ├── schemas/
│ │ └── templates/
│ ├── _utils/
│ │ └── github-workflows/ ← 利用者向け CI ワークフロー (コピーして使う)
│ ├── spec-coexist-router/ ← タスクティアルーター
│ ├── exploring-problem-space/
│ ├── creating-requirements/
│ ├── creating-basic-design/
│ ├── creating-detail-design/ ← 詳細設計書作成 (Mermaid 図主体)
│ ├── implementing-from-spec/
│ ├── fast-path/
│ ├── revising/
│ ├── systematic-debugging/
│ ├── test-driven-implementation/
│ ├── pre-review-self-check/
│ ├── verification-before-completion/
│ ├── code-review-loop/
│ ├── finishing-subsystem-work/
│ ├── delivery-snapshot/
│ └── parallelizing-subsystem-work/
├── packaging/
│ └── spec-coexist/
│ └── .claude-plugin/
│ └── plugin.json ← 配布用プラグインマニフェスト (バージョン等)
├── scripts/
│ └── package-spec-coexist.sh ← パッケージングスクリプト
└── dist/ ← パッケージングの出力 (git 管理外)
.claude/skills/ 配下なのかClaude Code は .claude/skills/ をライブリロードの対象として扱います (公式ドキュメント)。スキル本体をここに置くと、SKILL.md を編集した瞬間から次のターンに反映されるため、デバッグや試行錯誤がしやすくなります。
一方、プラグインとしてインストールされる配布形態では <plugin>/skills/<skill-name>/SKILL.md への配置が必要です。そのため、配布物はパッケージングスクリプトで組み立てる 構成を取っています。
このリポジトリを Claude Code で開くだけで、.claude/skills/ 以下のスキルが自動的に認識されます。自然言語で話しかければ、spec-coexist-router がタスクの規模を判定し、適切なスキルを呼び出します。
| 発話 | 起動されるスキル |
|---|---|
| 「何を作るか迷ってる」「help me figure out the problem」 | exploring-problem-space |
| 「新しい要件定義書を作りたい」「draft requirements」 | creating-requirements |
| 「基本設計を書きたい」「draft a basic design」 | creating-basic-design |
| 「詳細設計を作りたい」「draft a detailed design」 | creating-detail-design |
| 「この設計書のとおり実装して」「implement from the spec」 | implementing-from-spec |
| 「tier:T0 typo を直して」「quick fix」 | fast-path |
| 「要件を変更したい」「revise the spec」 | revising |
| 「仕様変更を実装に反映して」「update the code to match the new spec」 | revising |
| 「テストが落ちた」「なぜか動かない」 | systematic-debugging |
| 「コードレビューして」「review this change」 | code-review-loop |
| 「マージしたい」「open a pull request」 | finishing-subsystem-work |
| 「プロジェクトの現状を見たい」「delivery snapshot」 | delivery-snapshot |
| 「サブシステムを並列で実装したい」 | parallelizing-subsystem-work |
配布用のプラグインアーカイブは、以下のコマンドで生成できます。
./scripts/package-spec-coexist.sh
実行すると次の処理が走ります。
npx claudepluginhub wintermaples/spec-coexist --plugin spec-coexistComprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Feature development with code-architect/explorer/reviewer agents, CLAUDE.md audit and session learnings, and Agent Skills creation with eval benchmarking from Anthropic.
AI-powered development tools for code review, research, design, and workflow automation.
Design fluency for frontend development. 1 skill with 23 commands (/impeccable polish, /impeccable audit, /impeccable critique, etc.) and curated anti-pattern detection.
Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations on LLM coding pitfalls
Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.