kf-g-code-how-what-why-why-not-principles
Installation
SKILL.md
How / What / Why / Why not — 責務マップ
この skill は4原則の入口。詳細規約は各 SoT skill へ委譲する。
4原則
| 成果物 | 原則 | 説明 | SoT |
|---|---|---|---|
| コード | How | コード自体が実現方法を示す | （本 skill の指針のみ） |
| テストコード | What | 呼び出し側から観測可能な結果、振る舞い、仕様、契約を内部実装に依存せず示す | tdd/SKILL.md, tdd/tests.md |
| コミットログ | Why | なぜこのように実装・変更したかを示す | kf-g-git-commit-japanese-commit-message |
| コードコメント | Why not | なぜ別案を採らなかったか、なぜ単純化・削除できないかを示す | kf-g-code-comment-rules |
読み進め方
- 作業対象（コード / テスト / commit / コメント）に対応する原則行を特定する
- 該当 SoT skill を Read する
- How（コード）は SoT を持たない。実装そのもので方法を示す