Convert markdown planning documents to Overseer tasks via MCP codemode. Use when converting plans, specs, or design docs to trackable task hierarchies.
Use /overseer-plan to convert any markdown planning document into trackable Overseer tasks.
/overseer-plan <markdown-file-path>
/overseer-plan <file> --priority 3 # Set priority (1-5)
/overseer-plan <file> --parent <task-id> # Create as child of existing task
# heading (strips "Plan: " prefix)--parent| Depth | Name | Example |
|---|---|---|
| 0 | Milestone | "Add user authentication system" |
| 1 | Task | "Implement JWT middleware" |
| 2 | Subtask | "Add token verification function" |
Create subtasks when:
Keep single milestone when:
Every task must be:
Every milestone must:
general reviewer if Oracle is unavailable)await tasks.get("<id>"); // TaskWithContext (full context + learnings)
await tasks.list({ parentId: "<id>" }); // Task[] (children without context chain)
await tasks.start("<id>"); // Task (VCS required - creates bookmark, records start commit)
await tasks.complete("<id>", { result: "...", learnings: [...] }); // Task (VCS required - commits, bubbles learnings)
VCS Required: start and complete require git (fail with NotARepository if none found). CRUD operations work without VCS.
Note: Priority must be 1-5. Blockers cannot be ancestors or descendants.
| Task | File |
|---|---|
| Understanding API | @file references/api.md |
| Agent implementation | @file references/implementation.md |
| See examples | @file references/examples.md |
| File | Purpose |
|---|---|
references/api.md | Overseer MCP codemode API types/methods |
references/implementation.md | Step-by-step execution instructions for agent |
references/examples.md | Complete worked examples |