tracking-progress - SKILL.md Agent Skill

name: tracking-progress description: Update feature progress log and check off completed tasks. Use when user completes implementation tasks, makes commits, or indicates work is done. ASKS BEFORE MODIFYING files. Updates plan.md progress log section and implementation step checkboxes. allowed-tools: Read, Edit

Progress Tracker

Track feature implementation progress by updating plan.md when tasks are completed.

When to Use

Invoke this skill when the user:

Completes a task: "Done with X", "Finished the Y"
Makes a commit related to the feature
Says they've implemented something
Explicitly asks to update progress

State Compatibility

tracking-progress works on active and paused features. It does NOT work on replaced or abandoned features — those are tombstones; no further progress should be tracked. If invoked on a tombstoned feature, refuse and tell the user to run /feature-state <id> active first if they want to resume work.

Important: Ask Before Writing

This skill modifies files. Always ask before making changes.

Instructions

Step 1: Identify the Feature

Read docs/features/DASHBOARD.md and look at the In Progress section to find current features.

If multiple exist, check context or ask which one.

Step 2: Load the Plan

Read docs/features/[id]/plan.md

Locate:

Progress Log section (usually at the end)
Implementation Steps section (checkbox list)

Step 3: Prepare Update

From the user's statement, identify what was completed and match it to implementation steps.

Prepare:

Progress log entry with date and description
Checkbox update: - [ ] → - [x]

Step 4: Confirm and Apply

Show proposed changes, get confirmation, then use Edit tool to apply.

Example

User: "Done with the JWT token refresh logic"

Response:

Update progress in plan.md?

1. Add progress log entry:
   ### 2026-01-15
   - Completed JWT token refresh logic in auth/tokens.ts
   - Next: Implement session timeout handling

2. Mark complete:
   - [x] Implement JWT token refresh logic

Proceed? (yes/no)

After confirmation:

Progress updated in plan.md:
- Added log entry for 2026-01-15
- Marked complete: Implement JWT token refresh logic

Remaining steps: 4 of 7

Error Handling

No plan.md: "No implementation plan found. Run /feature-plan first."
No matching step: "Couldn't find a matching step. Add to progress log only?"
Multiple matches: List options and ask which to check off

Integration Notes

This skill works with:

/feature-review-impl - Uses plan.md checkbox state to auto-generate PR body
/feature-ship - Relies on accurate progress tracking