commitlore-commitslisted
Install: claude install-skill MongLong0214/commitlore
# CommitLore commits
A CommitLore record is the trailer block at the end of a commit message —
ordinary git trailers, parsed by `git interpret-trailers`. It captures what
the diff itself cannot show: the conditions that shaped the decision, the
alternatives that were dropped and why, and warnings for the next person (or
agent) who touches this code.
## When to record, and when not to
Trivial commits — typo fixes, formatting, a rename with no behavior change —
get no trailers. A record costs a future reader attention; spending that on
noise is worse than recording nothing. Only write one when there's a real
constraint, a real alternative that was seriously considered and rejected, or
a real warning to leave behind.
## The vocabulary
Sixteen keys, all optional, no others accepted. Anything outside this list
(other than an `X-<Name>:` extension) is rejected by `commitlore validate`.
### Decision context
| Key | Value grammar | Repeatable | Meaning |
|---|---|---|---|
| `Limit:` | free text | yes | An external condition that constrained the decision and may still be active |
| `Ruled-out:` | `alternative \| reason` — the `\|` separator is required | yes | An alternative that was evaluated and dropped, with why |
| `Warn:` | free text (folding allowed) | yes | An instruction for whoever modifies this next |
| `Blast:` | `local` \| `module` \| `system` | no | How far the change reaches |
| `Undo:` | `easy` \| `costly` \| `permanent` | no | What reverting this costs |
| `Cert