Menu
Standard workflow for fixing a GitHub issue. Fetches issue details, creates a branch, implements the fix with tests, and prepares a PR.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Switch model mid-session preserving thinking blocks. Used by /model command and by BRD §6.2 failover when the primary provider rate-limits or fails.
Six-phase ReAct loop (pre-check, thinking, self-critique, action, tool, post). Activates per-workflow via the thinking_level knob in config/workflows.yaml. Replaces standard ReAct for workflows where independent verification of the reasoning improves outcomes.
Mines completed sessions for repeating {tool sequence → outcome} tuples. Scores by frequency × success_rate × novelty. High-scoring tuples become "instincts" — candidate skill seeds — in instincts/pending/.
Walk-back algorithm for the Spec-Auditor subagent. Given a failure at phase N, identifies the earliest phase whose spec, if tightened, would have prevented the failure. Proposes a surgical amendment.
Sessions stored as trees (not lists). /fork creates a branch from any point; /tree navigates; /branch labels a path; /export produces HTML for review. All branches live in one session file under sessions/<project>/<session_id>.json.
Progressive context refinement for subagents. Don't dump everything; retrieve in passes. Start with a list of file paths and one-line abstracts; load full content only when the abstract proves insufficient.
| name | fix-issue |
| description | Standard workflow for fixing a GitHub issue. Fetches issue details, creates a branch, implements the fix with tests, and prepares a PR. |
| disable-model-invocation | true |
| argument-hint | [issue-number] |
Fetch issue details
gh issue view <issue-number> --json title,body,labels,assignees
Create a branch
git checkout -b fix/<short-description>
Understand the problem
Implement the fix
Verify
uv run pytest -x -q # Python tests pass
uv run ruff check . # No lint errors
uv run mypy src/ # No type errors
npm test # TypeScript tests pass (if applicable)
npm run typecheck # TypeScript types (if applicable)
Commit and push
git add -A
git commit -m "fix: <description> (closes #<issue-number>)"
git push -u origin fix/<short-description>
Create PR
gh pr create --title "fix: <description>" --body "Closes #<issue-number>"
git pull origin main.git add -A if all changes should be committed), the PR will be incomplete. Use git diff to verify all intended changes are staged.