audithandoffdoc
# audithandoffdoc This Claude Code skill generates a comprehensive handoff document named `AUDIT_HANDOFF.md` that enables another agent to rapidly understand project state, decisions, and trajectory. Use it when transitioning work between team members, pausing development, or onboarding collaborators who need deep context about implementation approach, completed work, success metrics, hypotheses, risk factors, and next steps.
git clone --depth 1 https://github.com/sterlingcrispin/claude_slash_commands /tmp/audithandoffdoc && cp -r /tmp/audithandoffdoc/audithandoffdoc ~/.claude/skills/audithandoffdocSKILL.md
Please perform a deep audit of our current task to produce a handoff document that gets another agent fully up to speed. Deliverable: Create a file named `AUDIT_HANDOFF.md` at the project root. Document your current understanding of: - what we are building - why we are building it - the project's telos (ultimate purpose/end-state) - how we are approaching implementation - what has been completed so far - how we define and measure success - current hypotheses - what is true (with evidence) vs what is assumed - what might be wrong - highest-risk areas - what we just tried and the outcome - next hypothesis - open questions Required Structure (use these exact section headers) 1. `# Executive Summary` - 5-10 bullets: current project state, trajectory, and key concerns. 2. `# Product Vision and Telos` - What we are building. - Why it matters. - Desired end-state if the project fully succeeds. 3. `# Implementation Approach` - Architecture and strategy. - Key technical decisions and tradeoffs. - Why this approach was chosen over alternatives. 4. `# Progress So Far` - Completed work. - In-progress work. - Deferred/not started work. - Include concrete references (files, PRs, commits, tests, docs) where possible. 5. `# Success Metrics` - Define primary and secondary metrics. - For each metric include: baseline, current value (if known), target, and measurement method. 6. `# Hypotheses` - Current main hypothesis. - Supporting sub-hypotheses. - What would confirm or falsify each one. 7. `# Evidence vs Assumptions` Include a table with columns: `Claim | Type (Evidence/Assumption) | Source | Confidence (Low/Med/High) | Notes` 8. `# Failure Modes and Risk Register` - What could be wrong. - Highest-risk areas (ranked by impact x likelihood). - Detection signals and mitigation options for each risk. 9. `# Most Recent Experiment/Attempt` - What was just tried. - Expected result. - Actual result. - Interpretation. - Artifacts (logs, test outputs, benchmark data, screenshots, etc.). 10. `# Next Hypothesis and Immediate Plan` - Next best hypothesis to test. - Why this is the highest-leverage next step. - Step-by-step plan for the next iteration. 11. `# Open Questions` - Unresolved technical, product, and operational questions. - For each: why it matters, blocking status, and who/what can resolve it. ## Quality Bar - Clearly separate **facts**, **inferences**, and **assumptions**. - Prefer concrete evidence over narrative. - Cite sources directly (file paths, line refs, commands, outputs, tickets, PR links). - Be explicit about uncertainty and confidence. - Keep it concise but complete; optimize for fast onboarding and auditability.
Send recent work to OpenAI Codex CLI for an independent audit/review
Send specific files to OpenAI Codex CLI for an independent audit/review
Concise checkpoint on hypothesis, changes, metrics, and next action
Pair programming continuation
Commit and push changes with auto-generated summary
Start a ralph style looping session
Work on a single highest-priority feature from current_ documents, test it, update docs, and commit
Write a structured research prompt document — questions only, no answers