/update-plan - PILOT Project Plan Updater

Update the PILOT project plan with task completions, progress tracking, and optional git workflow.

Track Assignment Reference

When adding new tasks to the plan, search the MASTER-TRACK-INDEX.md to ensure correct track assignment.

Track System: 37 tracks (A-N Technical, O-AA PCF Business, AB-AK Extensions)

Usage

/update-plan                                    # Interactive mode
/update-plan --auto-discover                    # Auto-discover session work (RECOMMENDED)
/update-plan --auto-discover --commit --push    # Auto-discover with git workflow
/update-plan --tasks F.2.1 F.2.2               # Mark specific tasks complete
/update-plan --session-log                      # Update session log only

Options

Option	Short	Description
--auto-discover	-a	Auto-discover completed tasks from context database, git, TodoWrite
--tasks	-t	Task IDs to mark complete (space-separated)
--details	-d	Completion details (JSON or inline)
--track		Track letter (A-N) for percentage update
--percent	-p	New track percentage (auto-calculated if omitted)
--commit	-c	Create git commit
--push		Push to remote
--session-log	-s	Update session log
--classify		Files to classify (space-separated)
--dry-run	-n	Preview changes without applying
--verbose	-v	Show detailed discovery output

Examples

Auto-Discover (Recommended)

/update-plan --auto-discover --commit --session-log
# Automatically discovers:
# - Tasks from context database (task_tracking table)
# - Tasks from TodoWrite state
# - Tasks from git commits and modified files
# - Tasks from today's session log

Auto-Discover with Verbose Output

/update-plan --auto-discover --verbose
# Shows discovery sources and task details

Mark Single Task Complete

/update-plan --tasks F.2.1

Mark Multiple Tasks with Details

/update-plan --tasks F.2.1 F.2.2 --details '{"F.2.1": "Fixed 64 errors", "F.2.2": "Created API-REFERENCE.md"}'

Full Workflow (Manual)

/update-plan \
  --tasks F.2.1 F.2.2 \
  --track F \
  --percent 85 \
  --commit \
  --push \
  --session-log \
  --classify docs/API-REFERENCE.md

Dry Run

/update-plan --auto-discover --dry-run
# Shows what would be changed without applying

Interactive Mode

/update-plan
# Prompts for:
# - Task IDs to complete
# - Completion details
# - Whether to commit
# - Whether to update session log

What It Does

1. Auto-Discovers Work - Queries context database, git, TodoWrite for completed tasks
2. Locates PILOT Plan - Finds **/PILOT*.md in project
3. Updates Checkboxes - Changes [ ] to [x] with dates
4. Adds Details - Appends completion notes under tasks
5. Calculates Progress - Auto-calculates track percentage from checkbox counts
6. Adds Progress Entry - Creates timestamped progress update
7. Bumps Version - Increments document version
8. Classifies Docs - Runs MoE classifier on specified files
9. Git Workflow - Stages, commits, pushes changes
10. Session Log - Updates daily session log

Auto-Discovery Sources

When using --auto-discover, the script queries these sources in priority order:

Priority	Source	Description
1	task_tracking table	Tasks with status='completed' today
2	task_messages table	Tasks linked to recent messages
3	TodoWrite state	Current todo list with completed items
4	Git status/diff	Modified files correlated with task IDs
5	Git commits	Today's commits with task ID patterns
6	Session log	Tasks already recorded in today's log
7	Context messages	Full-text search for task patterns

Task ID Patterns Recognized:

• [A.1.1] - Bracketed format
• A.1.1: - Colon suffix
• A.1.1 - Space suffix
• - [x] A.1.1 - Checkbox format

Output

╔══════════════════════════════════════════════════════╗
║           PILOT Plan Update Complete                  ║
╠══════════════════════════════════════════════════════╣
║ Plan: internal/project/plans/PILOT-PARALLEL-...      ║
║ Version: 1.9.3 → 1.9.4                               ║
║                                                       ║
║ Tasks Updated:                                        ║
║   ✓ F.2.1: Add @extend_schema decorators             ║
║   ✓ F.2.2: Generate API reference documentation      ║
║                                                       ║
║ Track Progress:                                       ║
║   F (Documentation): 75% → 85%                       ║
║                                                       ║
║ Git:                                                  ║
║   ✓ Commit: abc1234                                  ║
║   ✓ Pushed to origin/main                            ║
║                                                       ║
║ Session Log:                                          ║
║   ✓ Updated SESSION-LOG-2026-01-08.md                ║
╚══════════════════════════════════════════════════════╝

Integration

With TodoWrite Hook

# Automatically triggered after TodoWrite marks tasks complete
# hooks/task-plan-sync.py calls /update-plan

With /session-log

# Update session log separately
/session-log --date today

With /classify

# Classify documents separately
/classify docs/API-REFERENCE.md

Error Handling

Error	Resolution
PILOT plan not found	Searches **/PILOT*.md, prompts for path
Task ID not found	Shows available tasks, suggests closest match
Git conflict	Stashes changes, pulls, reapplies
Permission denied	Skips push, notifies user

Related Commands

• /session-log - Update session logs
• /classify - Document classification
• /cx - Context extraction
• /orient - Session orientation

Implementation

# Underlying script
python3 ~/.coditect/scripts/update-project-plan.py "$@"

# Or via agent
/agent project-plan-updater "<parsed arguments>"

---

Version: 2.0.0 | Created: 2026-01-08 | Updated: 2026-01-08