| name | git-workflow |
| description | Defines branch naming conventions, PR template requirements, commit message format, discovered-issues escalation policy, task tracking conventions. Load when committing, pushing, or opening PRs. |
Git Workflow & Delivery
NEVER push directly to main. All changes go through feature/fix branch → PR.
Branch & Commit Rules
| Rule | Detail |
|---|
Branch from main | git checkout -b <type>/<ticket-id>-<slug> |
| Types | fix, feat, chore, refactor, perf, docs |
| Commit messages | Must reference issue ID — TAS-42: Fix token refresh |
| No force-push | Never --force or --amend on shared branches; --force-with-lease on personal only |
| No secrets | No tokens/keys in commits, PR descriptions, or output (rotate immediately if leaked) |
Delivery Checklist (Every Task)
- Branch
<type>/<ticket-id>-<slug> from main
- Atomic commits referencing issue ID
- Push branch to origin
- Open PR (do NOT merge) — write body to temp file first; use
--body-file:
cat > /tmp/pr-body.md << 'EOF'
Resolves TAS-XX
- ...
EOF
GH_PAGER=cat gh pr create --base main --title "TAS-XX: Short description" --body-file /tmp/pr-body.md
Never use inline --body with markdown/backticks/special chars — breaks in zsh heredocs, quoted strings.
- Update issue with PR URL
Discovered Issues Policy
Inherits: discovered-issues-policy
Task Tracking
Tracked in the task tracker (tracker-config.md). Team Lead creates/updates issues via MCP. Load task-management skill for conventions.
If MCP tools unavailable: Document planned issues (title + AC) in output; use "N/A" (no tracker) or "TAS-PENDING" (tracker configured); proceed with work; update IDs when available.