handofflisted
Install: claude install-skill NAVNAV221/ai-native-codebase
# Handoff - task doc generator
Turn the user's feature description (the skill args + anything already established in this
conversation) into `docs/<kebab-name>.md`, ready to hand to a fresh agent session with zero context.
## Rules
1. **Self-contained or it failed.** The assigned session must never redo research this
conversation already did. Fold established findings into a "Research conclusions (verified - do
not redo)" section with concrete evidence and `file:line` pointers. Verify pointers against the
current tree before writing them.
2. **Ask at most 3 questions**, and only for decisions that change the doc (scope boundary,
acceptance threshold, user-sim scenarios). Everything else: pick the sensible default and state it.
3. **Acceptance criteria are executable checks**, not aspirations - each one something the assigned
session can run or observe. Include at least one negative case (what must NOT happen).
4. Cross-reference sibling task docs in `docs/` that touch the same files, so parallel sessions
coordinate instead of colliding.
5. **Dependent subtasks get a father task.** If subtasks have a real dependency (D blocked by C),
don't list them as flat parallel items - name a father task that owns sequencing: it launches one
subagent per unblocked subtask, and launches each blocked subtask's subagent once its blocker lands.
## Doc skeleton (use exactly this shape)
```markdown
# Task: <title>
**Status:** ready to start · **Owner:** unassigned