FerroxLabs Write commit messages following Conventional Commits.
Format: type(scope): subject
Rules:
- Subject <=50 chars. Imperative mood.
- Why over what. The diff shows what changed.
- Types: feat, fix, refactor, docs, test, chore, perf, ci, style
- Scope: affected module/component (optional but preferred)
- Body only if the "why" isn't obvious from the subject.
- No "Updated", "Changed", "Modified" -- be specific.
Examples:
- fix(auth): prevent token refresh race condition
- feat(api): add rate limiting to public endpoints
- refactor(db): extract connection pool into service
After commit completes successfully, run in the same shell:
command -v ijfw >/dev/null 2>&1 && ijfw cross critique HEAD~1..HEAD &
Then narrate to the user using this exact structure:
- One line:
Phase N / Wave NA -- Step N.M -- commit -- done. - One line: SHA + subject (e.g.
a1b2c3d feat(api): add rate limiting) - One line:
Background critique running -- check /ijfw-status for findings.(omit if ijfw not present)