sdd-starter
CLAUDE.md1 starsChanged 4 months agoUnlicenseView on GitHub
Claude Code がこのリポジトリで作業するときの文脈。これは仕様駆動開発(SDD)テンプレートだ。 このファイルは Claude 固有の運用指針 に絞る。エージェント非依存の文脈は AGENTS.md、 ロジックの本体は prompts/*.md にある(下記)。 このテンプレートを使って自分のプロダクトを作る場合は、このファイルを差し替えてよい。 ここに書くのは「SDD テンプレートとして作業する」ための指針であって、下流プロダクトの ルールではない。移行の全体手順は docs/adopting.md を参照。 AGENTS.md が技術スタックと最近の変更を蓄積する永続文脈だ(AUTO:BEGIN〜AUTO:END は /plan が機械更新する)。Cursor / Copilot / Gemini も同じ AGENTS.md を読む。 - 真実の源は prompts/*.md。各エージェントの入口(.claude/commands/ 等)は、対応する prompt を読むだけの薄いラッパだ。ロジックを二重に書かない。 - ワークフロー: constitution → specify →〔clarify〕→ plan → tasks →〔analyze〕→ implement。各段階は検証可能な Markdown 成果物を残し、次段階の入力になる。人間に断りなく 段階を飛ばして先へ進めない。 - 1機能 = 1ブランチ = 1 PR。scripts/new-feature.{sh,ps1} が次の連番で specs/NNN-*/ を作り、 機能ブランチを切る。 - 品質ゲートは両肺主義。検査ロジックは bash と PowerShell に同じものを刻み、CI で両 OS を回す。 構造に触れる変更の前後で bash scripts/check.sh(Windows は .\scripts\check.ps1)を通す。 - サブエージェント委譲: 重い /analyze・/implement で対象が大きいときは、コンテキスト保全と 独立検証のためサブエージェントに委譲してよい。ただし…
The file
We split this CLAUDE.md into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 40
Write / Edit の直後に check.sh を自動実行する(${CLAUDE_PROJECT_DIR} 起動・セッションの CWD に依らず発火する。発火条件でのパス絞り込みは、その照合が CWD 相対で静かな不発火を生む …
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
CLAUDE.md
Claude Code がこのリポジトリで作業するときの文脈。これは仕様駆動開発(SDD)テンプレートだ。
このファイルは Claude 固有の運用指針 に絞る。エージェント非依存の文脈は AGENTS.md、
ロジックの本体は prompts/*.md にある(下記)。
このテンプレートを使って自分のプロダクトを作る場合は、このファイルを差し替えてよい。 ここに書くのは「SDD テンプレートとして作業する」ための指針であって、下流プロダクトの ルールではない。移行の全体手順は
docs/adopting.mdを参照。
共有文脈(全エージェント共通)
@AGENTS.md
AGENTS.md が技術スタックと最近の変更を蓄積する永続文脈だ(AUTO:BEGIN〜AUTO:END は
/plan が機械更新する)。Cursor / Copilot / Gemini も同じ AGENTS.md を読む。
このプロジェクトの核(変更時に守る)
- 真実の源は
prompts/*.md。各エージェントの入口(.claude/commands/等)は、対応する prompt を読むだけの薄いラッパだ。ロジックを二重に書かない。 - ワークフロー:
constitution→specify→〔clarify〕→plan→tasks→〔analyze〕→implement。各段階は検証可能な Markdown 成果物を残し、次段階の入力になる。人間に断りなく 段階を飛ばして先へ進めない。 - 1機能 = 1ブランチ = 1 PR。
scripts/new-feature.{sh,ps1}が次の連番でspecs/NNN-*/を作り、 機能ブランチを切る。 - 品質ゲートは両肺主義。検査ロジックは bash と PowerShell に同じものを刻み、CI で両 OS を回す。
構造に触れる変更の前後で
bash scripts/check.sh(Windows は.\scripts\check.ps1)を通す。
Claude 固有の運用指針
- サブエージェント委譲: 重い
/analyze・/implementで対象が大きいときは、コンテキスト保全と 独立検証のためサブエージェントに委譲してよい。ただしspec.md/plan.md/tasks.md(真実の源)への書き込みは親が一元管理する。サブエージェントには読み取り・分析・限定的な実装を 任せ、成果物への最終統合は親が担う。これにより複数の書き手が真実の源を奪い合う事態を防ぐ。 - prompts/ はエージェント非依存に保つ。サブエージェント等の Claude 固有概念を
prompts/*.mdに 書かない。それらはこのCLAUDE.mdに留め、prompts/はどのエージェントでも同じ結果を出す 真実の源であり続ける。 - 構造変更の自動検査(フック):
.claude/settings.jsonの PostToolUse フックが、あらゆる Write / Edit の直後にcheck.shを自動実行する(${CLAUDE_PROJECT_DIR}起動・セッションの CWD に依らず発火する。発火条件でのパス絞り込みは、その照合が CWD 相対で静かな不発火を生む ため廃止——specs/005)。検査は読み取り専用・実測 ~1秒。検査が NG なら その内容がエージェントに即時フィードバックされるので、その場で直してから先へ進むこと。- 品質ゲートの本体はあくまで
check.{sh,ps1}と CI 側。フックは気づきを前倒しする便利装置で、 Cursor 等フックの無い環境でも手動実行で同じ結論に至る(この退路を壊さない)。 - 検査は読み取り専用。段階遷移(specify → plan 等)の自動起動はしない——それは唯一の禁則だ。
- 前提は bash(Windows は Claude Code 標準の Git Bash)。個人環境でこの自動化だけ切りたければ、
.claude/settings.local.json(gitignore 済み)に"disableAllHooks": trueを書く。
- 品質ゲートの本体はあくまで
- 限定 skill 実験(specs/007):
.claude/skills/に status / analyze の2つだけを 同名 skill として展開している。同名 skill はコマンドより優先されるため、Claude Code では/status・/analyzeの実体が skill 側になり(同じprompts/*.mdを読む薄いラッパゆえ 結論は不変)、文脈上有用ならモデル判断の自発起動が加わる。境界は三層: ①自発起動が許されるのはこの2コマンドの実行まで(結果を根拠に他の SDD 段階を起動しない) ②analyze のレポート保存は保存前にユーザーの承認を得る(読み取りは skill の自由・ 書き込みは人間の承認)③他9コマンドは skill 化しない——全面 skill 化は自律起動が SDD の教育的価値と衝突するため見送り済み(2026-06-05 の決着)。戻し方:.claude/skills/を削除するだけで完全復元。skills は品質ゲートの入口整合検査(11コマンド全対応前提)の 対象外の意図的サブセット。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

