This skill is the entry point for the 4 principles. Detailed rules are delegated to each SoT skill.
4 Principles
| Deliverable | Principle | Description | SoT |
|---|---|---|---|
| Code | How | The code itself shows the method of realization | (Guidelines of this skill only) |
| Test code | What | Show results, behavior, specifications, and contracts observable from the caller without depending on internal implementation | tdd/SKILL.md, tdd/tests.md |
| Commit log | Why | Show why it was implemented or changed this way | kf-g-git-commit-japanese-commit-message |
| Code comments | Why not | Show why alternatives were not adopted, and why it cannot be simplified or removed | kf-g-code-comment-rules |
How to Read Through
- Identify the principle row corresponding to the work target (code / test / commit / comment)
- Read the corresponding SoT skill
- How (code) has no SoT. The implementation itself shows the method
Required Steps by Work Type
Before writing or fixing code
- Confirm the responsibility of How in this skill
- Show the method through the implementation itself (do not offload How to comments or commits)
Before writing or fixing tests
- Confirm the responsibility of What in this skill
- tdd/SKILL.md Read
- If necessary, tdd/tests.md Read
Before writing a commit message
- Confirm the responsibility of Why in this skill
- kf-g-git-commit-japanese-commit-message Read
- When requesting a commit, kf-g-git-commit-staged-only-rules is also used together (canonical)
- User
/genshijin-commitonly when explicitly specified, genshijin-commit is used
Before writing or fixing code comments
- Confirm the responsibility of Why not in this skill
- kf-g-code-comment-rules Read
Final Check
- Each deliverable conforms to the corresponding principle (How / What / Why / Why not)
- Detailed rules are not duplicated in this skill
- The corresponding SoT skill has been read