Mcpbridge Workflow

mcpbridge-workflow

Task tracking for the mcpbridge-wrapper project development.

Quick Start

Get the next task:

python3 scripts/pick_next_task.py

Mark a task done:

python3 scripts/pick_next_task.py --done P1-T1

Show progress:

python3 scripts/pick_next_task.py --progress
# Or use calc_progress.py for different output formats:
python3 scripts/calc_progress.py --markdown

List all tasks:

python3 scripts/pick_next_task.py --list

Workplan Structure

The workplan at SPECS/Workplan.md contains 66 tasks across 8 phases.

When to read the full workplan:

• Before starting work on a task (to see full acceptance criteria)
• To understand task dependencies in detail
• To review the dependency graph or traceability matrix

For task format details, see references/task-format.md.

Task IDs follow the pattern P{phase}-T{task} (e.g., P1-T1, P3-T5).

Priority Levels

• P0: Must complete for MVP (critical path)
• P1: Should complete (important but not blocking)
• P2: Nice to have (polish and enhancements)
• P3: Future work (post-MVP)

Scripts

Two scripts are available for task management:

pick_next_task.py

Main task tracker with state persistence.

Location: scripts/pick_next_task.py

calc_progress.py

Calculate and display progress from workplan (no state tracking).

Location: scripts/calc_progress.py

Additional options:

python3 scripts/calc_progress.py --json       # JSON output
python3 scripts/calc_progress.py --markdown   # Markdown table
python3 scripts/calc_progress.py --todo       # Pending tasks only
python3 scripts/calc_progress.py --phase P1   # Phase 1 tasks

Default: Show Next Task

Without arguments, shows the highest-priority available task with unmet dependencies:

python3 scripts/pick_next_task.py

Output includes:

• Task ID and description
• Phase and priority
• Dependency status (done/pending)
• Acceptance criteria
• Overall progress

Mark Task Complete

python3 scripts/pick_next_task.py --done TASK_ID

Example:

python3 scripts/pick_next_task.py --done P1-T1

Validates task ID exists in workplan before saving.

Show Progress

python3 scripts/pick_next_task.py --progress

Displays progress bars for each phase and P0 task completion counts.

List Tasks

python3 scripts/pick_next_task.py --list
python3 scripts/pick_next_task.py --list --phase 1

Shows all tasks with status (DONE/TODO) and blocking indicators.

Task Selection Logic

Tasks are selected based on:

1. All dependencies complete - Task is available
2. Phase order - Earlier phases take precedence
3. Priority - P0 before P1 before P2 before P3
4. Task ID - Alphabetical for tie-breaking

Blocked tasks (incomplete dependencies) are shown with [BLOCKED].

State Files

• .task_state.json - Completed task IDs
• .current_task - Current task suggestion (updated by script)

Both are gitignored.

Working a Task

1. Get the next task:

   python3 scripts/pick_next_task.py
   

2. Read the full task details in SPECS/Workplan.md

3. Implement the task

4. Run tests to verify:

   python3 -m pytest tests/ -v
   

5. Mark complete:

   python3 scripts/pick_next_task.py --done P1-T1
   

6. Commit with message referencing task ID:

   git add .
   git commit -m "P1-T1: Create project directory structure"
   

Completion Criteria

Project is complete when:

• All P0 tasks: 100% complete
• All P1 tasks: ≥80% complete
• Test coverage: ≥90%
• All 20 Xcode MCP tools verified (P5-T13)
• Overhead <5ms verified (P5-T11)