AI-consumed reference. Optimized for Claude to read during execution. Human-readable explanation: see docs/architecture/HIERARCHICAL_PLANNING.md or docs/getting-started/ depending on topic.
Git Workflow
Token-efficient git: 2-4 tool calls max.
Commit Process
1. Stage + Security Scan
Stage files, check diff stats, scan for secrets (api_key|token|password|secret|credential).
If secrets found: STOP. Show matches. Block commit.
2. Split Decision
Split if: mixed types (feat+fix), FILES >10 unrelated, multiple scopes (frontend+backend). Single if: same type/scope, FILES ≤3 + LINES ≤50, logically related.
3. Commit Message
Format: type(scope): description (<72 chars, present tense, imperative)
Types: feat, fix, docs, chore, refactor, test, perf
4. Commit + Push
Push only if user requests.
PR Workflow
git fetch origin main+ log commits since main + diff statsgh pr create --title "type(scope): description" --body "## Summary\n- bullets\n\n## Test Plan\n- steps"
Output
staged: 3 files (+45/-12 lines) | security: passed | commit: a3f8d92 feat(auth): add token refresh