sdd-starter
AGENTS.md1 starsChanged 4 months agoUnlicenseView on GitHub
- 007-claude-skills-experiment: 限定 skill 実験: /status・/analyze を .claude/skills に同名展開(自発起動可・analyze は保存前承認・段階遷移の起動禁止)——Claude 固有領域に閉じた2コマンド限定の別実験 - 006-agent-expansion: 対応エージェントを8種に拡充(Windsurf/.windsurf/workflows・opencode/.opencode/commands・Qwen/.qwen/commands・Codex/.agents/skills)——入口は薄いラッパのみ・両肺ゲート拡張 - 005-hook-cwd-independence: フックを if 全廃の単一エントリに集約し発火と起動を CWD 非依存化(毎回検査・${CLAUDE_PROJECT_DIR} 起動) - 004-analyze-freshness-gate: analyze-report の鮮度を git hash-object の内容ハッシュで検査するゲートを両肺に追加(mtime は不採用) - 002-claude-hooks-automation: 構造対象パスへの書き込み直後に check.sh を自動実行するフックを .claude/settings.json に追加 <!-- AUTO:END --> memory/constitution.md は 下流プロダクト向けの雛形 だ。テンプレを採用した者が /constitution で自分の原則に置き換える起点であり、テンプレ本体のリポジトリでは 空(プレースホルダのまま)に保つ——ここをテンプレ自身の原則で埋めると、下流が clone したとき SDD テンプレの憲法を引き継いでしまう(雛形の役割が壊れる)。 そのため、テンプレ自身を SDD ワークフローで開発するとき(specs/NNN-*/ を切って spec §7 / plan §6 の Constitution Check を書くとき)は、雛形の空条項ではなく、以下の *運用原則を憲法相当*として照合する。実体は CLAUDE.md / この AGENTS.md / prompts/*.md に既に散在しており、ここはその集約だ。 - 両肺主義: 検査ロジックは bash と PowerShell に同じものを刻み、CI で両…
The file
Files
AGENTS.md - Project context (shared memory for AI agents)
<!-- All agents (Claude / Cursor / Copilot / Gemini, etc.) read this persistent
context. The AUTO block below is maintained by scripts/update-agent-context
on every /plan. Anything OUTSIDE the AUTO markers is yours to edit by hand
and is preserved across updates. --><!-- AUTO:BEGIN (managed by scripts/update-agent-context; manual edits here are overwritten) -->Active tech stack
- bash
- Windows PowerShell 5.1
- GitHub Actions (ubuntu + windows)
- shellcheck / PSScriptAnalyzer (CI lint)
- Claude Code hooks (PostToolUse)
- git (hash-object)
Recent changes
- 007-claude-skills-experiment: 限定 skill 実験: /status・/analyze を .claude/skills に同名展開(自発起動可・analyze は保存前承認・段階遷移の起動禁止)——Claude 固有領域に閉じた2コマンド限定の別実験
- 006-agent-expansion: 対応エージェントを8種に拡充(Windsurf/.windsurf/workflows・opencode/.opencode/commands・Qwen/.qwen/commands・Codex/.agents/skills)——入口は薄いラッパのみ・両肺ゲート拡張
- 005-hook-cwd-independence: フックを if 全廃の単一エントリに集約し発火と起動を CWD 非依存化(毎回検査・${CLAUDE_PROJECT_DIR} 起動)
- 004-analyze-freshness-gate: analyze-report の鮮度を git hash-object の内容ハッシュで検査するゲートを両肺に追加(mtime は不採用)
- 002-claude-hooks-automation: 構造対象パスへの書き込み直後に check.sh を自動実行するフックを .claude/settings.json に追加
<!-- AUTO:END -->憲法の扱い(テンプレ本体の開発)
memory/constitution.md は 下流プロダクト向けの雛形 だ。テンプレを採用した者が
/constitution で自分の原則に置き換える起点であり、テンプレ本体のリポジトリでは
空(プレースホルダのまま)に保つ——ここをテンプレ自身の原則で埋めると、下流が
clone したとき SDD テンプレの憲法を引き継いでしまう(雛形の役割が壊れる)。
そのため、テンプレ自身を SDD ワークフローで開発するとき(specs/NNN-*/ を切って
spec §7 / plan §6 の Constitution Check を書くとき)は、雛形の空条項ではなく、以下の
運用原則を憲法相当として照合する。実体は CLAUDE.md / この AGENTS.md / prompts/*.md
に既に散在しており、ここはその集約だ。
- 両肺主義: 検査ロジックは bash と PowerShell に同じものを刻み、CI で両 OS を回す。
- ゼロ依存: Python 製 CLI に依存しない。ゼロ依存で Spec Kit の型を再現する。
- 真実の源は
prompts/: ロジックを二重に書かない。各エージェントの入口は薄いラッパに留める。 - 1機能 = 1ブランチ = 1 PR: 段階を人間に断りなく飛ばさない。
- 自律実行の禁則: 人間の承認を奪う段階遷移(specify→plan 等の自動起動)はしない。 中立の足場(prompts/)を高くする方向と、Claude 固有自動化を settings.json に閉じる方向のみ歓迎。
この扱いは、ルート
CLAUDE.mdが「SDD テンプレとして作業する指針であって下流プロダクトの ルールではない(下流では差し替え可)」と立ち位置を分けたのと同型だ。憲法も雛形は下流の ために無傷にし、テンプレ本体の照合先は運用原則で与える。
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.

