ai-dev-gates
CLAUDE.md0 starsChanged 3 months agoMITView on GitHub
トレース ID: R = 要件、S = 仕様、D = 設計、T = テスト。要件→仕様→設計→テストを ID で相互参照し (例: 「S-01 は R-01 を実現」)、問題が出たとき影響範囲を grep で辿れるようにする。
In this repository9 other files it gives its agents.
- coding-rulesSkill
- cq-reviewSkill
- fix-loopSkill
- kill-procSkill
- prepare-clearSkill
- reworkSkill
- self-reviewSkill
- spec-devSkill
- triageSkill
The file
Files
プロジェクト規約
文章規約
- 日本語の文章中でも括弧は半角
()を使う。全角（）は使わない。
ディレクトリ規約
トレース ID: R = 要件、S = 仕様、D = 設計、T = テスト。要件→仕様→設計→テストを ID で相互参照し (例: 「S-01 は R-01 を実現」)、問題が出たとき影響範囲を grep で辿れるようにする。
| 場所 | 内容 | 運用 |
| TODO.md | やることリスト | 追記し、完了したら削除する (履歴は git と notes/ が持つ) |
| docs/<feature>/ | 要件・仕様・設計 = 現在の正 (R/S/D の ID 付き) | 常に最新に更新する。判断を変えた箇所だけ |
| notes/ | 調査メモ・作業記録 (YYYYMMDD-<topic>.md) | 追記のみ。過去の記録は書き換えない。プログラムを置かない (捨てスクリプトはメモ内のコードブロックとして記録。ビルドツールは .gitignore を見ずにツリーを歩くため) |
| notes/fix-sessions/ | fix-loop の作業台帳 | 同上 |
| notes/reviews/ | ローカルレビュー結果の全文 (冒頭に対象コミット) | 同上 |
| notes/review-log.md | 繰り返し出るレビュー指摘の台帳 | 追記のみ。3 回出た指摘はチェックリストへ昇格 |
TODO 運用
- レビュー指摘のうち今直さないものは 1 行で追記する:
- [ ] 要点 (file:line, S-ID) — 詳細: notes/reviews/YYYYMMDD-<topic>.md - リンクは TODO → notes/ の片方向のみ (TODO は消し込むので逆向きは古くなる)
- TODO を拾って修正するときの規模判定:
- 挙動を変えない小修正 (関数抽出・ガード節化・命名) → fix-loop のみ。docs 不要
- 設計判断を伴う構造変更 (統合・基底クラス化など) → design.md + ADR を書いてから実装
- 挙動が変わる / 仕様起因 → rework で上流文書から直す
- ドキュメントを書くのは「判断があった所」だけ (全部に要件から書き始めない)
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.