| name | start-task |
| description | Start a task (phase implementation, incident response, or improvement) |
| disable-model-invocation | true |
| argument-hint | [task-id] |
Start a task (phase implementation, incident response, or improvement)
Arguments
$TASK_ID - Task identifier (e.g., 3E, 4, incident-xxx)
Project Detection
Determine the docs location based on the current project:
- LangChain projects (langchain-stack, litellm-stack, open-webui-stack, portable-llm-server):
- Docs:
../ai-specs/projects/engineering/langchain/
- General projects: Docs:
docs/ within the project root
Procedure
- Read project docs (follow path resolution from project detection above):
architecture.md, todo.md (and other existing docs)
- Read the target repo's
CLAUDE.md
- Read
.context-private/handoff-phase{$TASK_ID}.md (if exists)
- Read
.context-private/completion-phase{prev}.md (if exists — determine prev from todo.md Status Summary or history.md)
- Read
ops.md (for incident/infrastructure tasks)
- Cross-check handoff against higher-priority documents:
- Priority 1: Project docs (
architecture.md, todo.md, CLAUDE.md)
- Priority 2: Previous completion report
- Priority 3: Current handoff
- If conflicts found, present them to the user before proceeding
- Present a work plan to the user and wait for approval before starting implementation
Rules
- If no handoff document exists, ask the user for task scope
- Never start implementation without presenting the plan first
.context-private/ is gitignored — Glob and Grep cannot see it.
Use ls (Bash) to list files, and Read to read them directly by path.
