02 — Commit Message

AI-attributable, semantically rich commit format, extending Conventional Commits 1.0.0.

Format

<type>[scope]: <description>

[body]

[footer]
feat(auth): add OAuth 2.0 login flow

AI-assisted: true
AI-tool: GitHub Copilot
AI-scope: auth module, token refresh logic
AI-review: pending
AI-confidence: high
Ticket: PROJ-1234
Risk: medium
Field Required Values
AI-assisted Yes true / false
AI-tool If AI true e.g., GitHub Copilot
AI-scope Recommended Free text
AI-review If AI true pending / passed / failed
AI-confidence Optional low / medium / high
Ticket Recommended Issue ID
Risk Optional low / medium / high

CLI Usage

# Validate
git log -1 --format=%B | ods validate commit --stdin

# Generate
ods generate commit --type feat --scope auth --ai-tool "Copilot"

View full spec → View schema →