Private
Public Access
feat(directives): harvest 6 process anti-pattern directives from AGENTS.md + workflow.md
This commit is contained in:
@@ -0,0 +1,14 @@
|
||||
# verbose_commit_message_ban — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #7 (lines 170-173). This is the baseline encoding — the symptom-rule-pair style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, tabular) against this baseline.
|
||||
|
||||
**Source:** `AGENTS.md:170-173`
|
||||
|
||||
---
|
||||
|
||||
### 7. The Verbose-Commit-Message Pattern (kill it)
|
||||
|
||||
**Symptom:** Your commit message is 50 lines. It contains the root cause analysis, the alternatives you considered, the side effects you considered, the cross-references, the "what this doesn't fix", the "what to verify", and a personal essay. The commit message is longer than the diff it describes.
|
||||
|
||||
**Rule:** A commit message is a 1-3 sentence summary. The body is for non-obvious "why" details, not for re-stating what the diff shows. If your commit message is longer than 15 lines, you are writing a report, not a commit message. Save the report for `docs/reports/`.
|
||||
Reference in New Issue
Block a user