🎯 omptask

Hub: 🔌 OMP Extensions · Contract: 🧭 Extension UX Contract · Runtime: omp only · MCP taskmaster-ai disabled — this replaces it locally.

1. 💎 Blueprint

id: omptask                 # display/SSOT id
runtime_file: ~/.omp/agent/extensions/taskmaster.ts
rebrand: planned separately; wrapper re-exports src/taskmaster.ts
source: ~/.omp/agent/extensions/src/taskmaster.ts
state: .taskmaster/tasks.yml
hook: before_agent_start → systemPrompt append
tool: backlog          # NOT task — collides with OMP subagent spawner
human_command: /tm
command_owner: omptask
human_ui: "bare command status · subcommands for fast paths"
schema: pi.zod         # not TypeBox / StringEnum
status: shipped

2. 🎯 Purpose

Personal Taskmaster-lite: one YAML file, dependency-aware next, auto-inject active task every turn.

3. 🚨 Critical invariant

Tool	Owner
task	OMP built-in — spawns subagents
backlog	omptask — YAML backlog

// ❌ pi.registerTool({ name: "task", … })
// ✅
pi.registerTool({ name: "backlog", label: "OMP Tasker", … });

Update all prompt hints: call backlog tool, not task.

4. 🛠️ API surface

Surface	Actions
backlog tool	init · list · next · add · update · expand · parse_prd
/tm	empty = status · list · init · init <prd-path> · help
Auto	## 🎯 Active Task appended to system prompt

5. 🗄️ State (tasks.yml)

tasks:
  - id: 1
    title: "Overstand feature X"
    status: pending      # pending | in-progress | done | blocked | deferred | cancelled
    priority: high       # high | medium | low
    deps: []             # unblocks when deps are done|cancelled
    subtasks: []

next logic: in-progress first → highest-priority unblocked pending (deps satisfied).

parse_prd: only - [ ] / - [x] checkbox lines.

6. 🏗️ Flow

flowchart LR
  Y[tasks.yml] --> L[loadTasks]
  L --> H[before_agent_start]
  H --> SP[systemPrompt + active task]
  L --> T[backlog tool]
  T --> Y
  U[/tm] --> L

7. 🧪 Smoke

/tm init
/tm
# ask model: "use backlog action list"
# ask model: "use backlog action update id 1 status done"

8. ✅ Verified

• Tool named backlog; no Taskmaster name: "task" registration remains
• /tm shows next pending task
• Prompt guidance sends backlog work to backlog
• Native OMP help still exposes task for subagent spawning

9. vs Taskmaster MCP

	omptask	MCP
Storage	single YAML	multi-file
PRD	checkboxes	full expansion
Tools	1 × 7 actions	many