Sprint Progress Auto-Tracking Skill

When you create or modify sprint-related files, you must update the sprint progress tracker accordingly. This skill defines the rules for detecting events and updating the progress table.

Application Targets

This skill applies when writing or editing files matching these patterns:

• •docs/blueprints/*.md (not overview.md) — blueprint event
• •docs/database/database-design.md — DB design event
• •docs/tests/test-cases/*.md — test case event
• •docs/tests/test-reports/*.md — test report event
• •src/**/*.{java,ts,tsx,py,js,jsx,kt,go,rs} — implementation event

Current Sprint Detection

1. •Look in docs/sprints/ for directories matching sprint-{N}/
2. •The highest {N} is the current sprint number
3. •The tracker file is docs/sprints/sprint-{N}/progress.md

Update Procedures

Procedure 1: After Blueprint Creation/Modification

When a file under docs/blueprints/ (excluding overview.md) is written:

1. •Open docs/sprints/sprint-{N}/progress.md
2. •Find the feature row that matches the blueprint filename
3. •Set the Blueprint column to Done
4. •If no matching feature row exists (ad-hoc feature), add a new row with the feature name derived from the filename
5. •Recalculate the Summary section

Procedure 2: After DB Design Modification

When docs/database/database-design.md is modified:

1. •Open the sprint progress tracker
2. •Identify which feature(s) the DB changes relate to (check the section headers or table names in the modified content)
3. •Set the DB Design column to Done for the relevant feature(s), or WIP if only partial tables were added
4. •Recalculate the Summary section

Procedure 3: After Test Case Creation/Modification

When a file under docs/tests/test-cases/ is written:

1. •Open the sprint progress tracker
2. •Match the test case filename to a feature (e.g., user-auth-test-cases.md → user-auth feature)
3. •Set the Test Cases column to Done
4. •Recalculate the Summary section

Procedure 4: After Implementation File Write

When a source file under src/ is written:

1. •Open the sprint progress tracker
2. •Determine which feature the source file belongs to (by module directory, class name, or import relationships)
3. •Set the Implementation column to WIP
4. •Never set Implementation to Done from a single write — implementation is only Done when:
   • •The user explicitly confirms implementation is complete, OR
   • •A test report for the feature has been created, OR
   • •All files referenced in the blueprint exist and are non-empty
5. •Recalculate the Summary section

Procedure 5: After Test Report Creation

When a file under docs/tests/test-reports/ is written:

1. •Open the sprint progress tracker
2. •Match the test report to a feature
3. •Set the Test Report column to Done
4. •Check if the feature is now fully complete (all columns are Done or N/A)
5. •If fully complete, set the Status column to Completed
6. •Recalculate the Summary section

Tracker File Auto-Creation

If the tracker file docs/sprints/sprint-{N}/progress.md does not exist when an event occurs:

1. •Read the sprint prompt map docs/sprints/sprint-{N}/prompt-map.md
2. •Extract feature names from ## Feature {N}: {name} headers
3. •Create the tracker file using the template below
4. •Then apply the appropriate update procedure

Tracker Template

# Sprint {N} Progress Tracker

## Sprint Information
- **Sprint Number**: {N}
- **Sprint Goal**: [from prompt map Sprint Goal section]
- **Start Date**: {YYYY-MM-DD}
- **End Date**: {YYYY-MM-DD} (+7 days)
- **Status**: In Progress

<!-- PROGRESS_TABLE_START -->
## Feature Progress

| Feature | Blueprint | DB Design | Test Cases | Implementation | Test Report | Status |
|---------|-----------|-----------|------------|----------------|-------------|--------|
| {feature-1} | - | - | - | - | - | Not Started |
| {feature-2} | - | - | - | - | - | Not Started |

**Legend**: `-` Not Started, `WIP` In Progress, `Done` Completed, `N/A` Not Applicable
<!-- PROGRESS_TABLE_END -->

<!-- SUMMARY_START -->
## Summary
- **Total Features**: {N}
- **Completed**: 0
- **In Progress**: 0
- **Overall Progress**: 0%
- **Last Updated**: {YYYY-MM-DD HH:MM}
<!-- SUMMARY_END -->

<!-- ACTIVITY_LOG_START -->
## Activity Log

| Timestamp | Event | File | Details |
|-----------|-------|------|---------|
<!-- ACTIVITY_LOG_END -->

Feature-to-File Matching Rules

When matching files to features:

1. •Exact name match: Blueprint filename matches feature name (e.g., user-auth.md → user-auth)
2. •Prefix match: Test case/report filename starts with feature name (e.g., user-auth-test-cases.md → user-auth)
3. •Directory match: Source files in a directory named after the feature (e.g., src/modules/user-auth/ → user-auth)
4. •Content match: If no name match, check if the file content references the feature by name

Summary Recalculation

After each update to the progress table:

1. •Count features with Status = Completed → Completed count
2. •Count features with any column as WIP or Done but Status ≠ Completed → In Progress count
3. •Calculate Overall Progress = (Completed / Total Features) × 100%
4. •Update Last Updated to the current timestamp