Project Plan Updater Skill

Automated workflow for updating PILOT project plans with task completion, document classification, and git integration.

When to Use This Skill

• After completing tasks that need to be reflected in PILOT plan
• When task status changes (pending → in_progress → completed)
• After creating/modifying documentation
• Before session end to capture all progress
• When track percentages need recalculation

What It Automates

Before (Manual):

# Find PILOT plan
find . -name "PILOT*.md"
# Open and edit manually
# Update checkboxes, percentages, dates
# Create commit manually
# Update session log manually

After (Automated):

/update-plan --tasks "F.2.1, F.2.2" --commit --session-log
# Or via agent:
/agent project-plan-updater "Mark F.2.1 and F.2.2 complete"

Execution Steps

Step 1: Locate PILOT Plan

# Find active PILOT plan
Glob("**/PILOT*.md")
# Typical location:
# internal/project/plans/PILOT-PARALLEL-EXECUTION-PLAN.md

Step 2: Update Task Checkboxes

# Pattern: [ ] Task → [x] Task ✅ (Date)
old: "- [ ] F.2.1: Add @extend_schema decorators"
new: "- [x] F.2.1: Add @extend_schema decorators ✅ (Jan 8, 2026)"

Step 3: Add Completion Details

- [x] F.2.1: Add @extend_schema decorators ✅ (Jan 8, 2026)
  - **Fixed:** 64 errors → 0 errors
  - **Modified:** api/v1/views/*.py
  - **Generated:** openapi-schema-generated.yaml

Step 4: Update Progress Percentage

# Calculate track progress
tasks_complete = count("[x]" in track_section)
tasks_total = count("- [" in track_section)
percentage = (tasks_complete / tasks_total) * 100

# Update status table
| Documentation | 75% | 25% | No |
→
| Documentation | 85% | 15% | No |

Step 5: Add Progress Update Entry

**Progress Update (Jan 8):** Track F.2 (API Documentation)
advanced to **66%**. F.2.1 COMPLETE: Added @extend_schema
decorators...

Step 6: Increment Version

**Document Version:** 1.9.3 → 1.9.4
**Updated:** January 6, 2026 → January 8, 2026

Step 7: Classify Modified Documents

python3 scripts/moe_classifier/classify.py docs/API-REFERENCE.md --update-frontmatter

Step 8: Git Workflow

git add internal/project/plans/PILOT-PARALLEL-EXECUTION-PLAN.md
git add docs/session-logs/SESSION-LOG-2026-01-08.md
git commit -m "docs(F.2): Update PILOT plan with F.2.1, F.2.2 completion

- Mark F.2.1, F.2.2 tasks complete
- Update Documentation track: 75% → 85%
- Add progress update entry
- Update session log

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
git push

Step 9: Update Session Log

### 2026-01-08T12:00:00Z - [F.2] API Documentation Progress

**Tasks Completed:**
| Task ID | Description | Status |
|---------|-------------|--------|
| F.2.1 | Add @extend_schema decorators | ✅ |
| F.2.2 | Generate API reference docs | ✅ |

Input Parameters

Parameter	Type	Required	Description
tasks	string[]	Yes	Task IDs to mark complete
details	object	No	Completion details per task
commit	boolean	No	Create git commit
push	boolean	No	Push to remote
session_log	boolean	No	Update session log
classify	string[]	No	Files to classify

Example Invocations

Basic Task Update

/agent project-plan-updater "Mark F.2.1 complete with details: Fixed 64 schema errors"

Full Workflow

/agent project-plan-updater "Complete workflow:
  Tasks: F.2.1, F.2.2
  Files modified: api/v1/views/*.py
  Files created: docs/API-REFERENCE.md
  Commit: docs(F.2): Add API reference documentation
  Session log: Update with F.2 progress"

Via Script

python3 ~/.coditect/scripts/update-project-plan.py \
  --tasks F.2.1 F.2.2 \
  --track F \
  --new-percent 85 \
  --commit \
  --session-log

Success Output

✅ SKILL COMPLETE: project-plan-updater

Completed:
- [x] Located PILOT plan
- [x] Updated 2 task checkboxes
- [x] Added completion details
- [x] Updated track percentage: 75% → 85%
- [x] Added progress update entry
- [x] Incremented version: 1.9.3 → 1.9.4
- [x] Created git commit: abc1234
- [x] Updated session log

Outputs:
- PILOT plan updated: internal/project/plans/PILOT-PARALLEL-EXECUTION-PLAN.md
- Session log updated: docs/session-logs/SESSION-LOG-2026-01-08.md
- Git commit: abc1234

Completion Checklist

Before marking complete, verify:

• PILOT plan file found and readable
• Task checkboxes updated with dates
• Completion details added
• Track percentage recalculated
• Progress update entry added
• Document version incremented
• Git commit created (if requested)
• Session log updated (if requested)

Failure Indicators

This skill has FAILED if:

• ❌ PILOT plan not found
• ❌ Task ID not found in plan
• ❌ Git commit fails
• ❌ Session log not found
• ❌ Percentage calculation error

Anti-Patterns

Anti-Pattern	Problem	Solution
Update without reading	Overwrites changes	Always Read before Edit
Skip version bump	Version drift	Always increment version
Generic commit messages	Lost history	Use semantic commits
Skip session log	Lost context	Always update session log

Related Components

• Agent: project-plan-updater
• Command: /update-plan
• Hook: task-completion-trigger.py
• Script: update-project-plan.py

---

Version: 1.0.0 | Created: 2026-01-08