Skip to content

Commit 85d6344

Browse files
marcusgollclaude
andcommitted
feat: add task completion tracking and template usage
- Updated tasks-workflow.sh to use tasks-template.md for Progress Summary - Updated implement-workflow.sh specialist prompts to call task-tracker mark-done-with-notes - Added detailed explanations of what task-tracker functions do - Enables automatic velocity tracking, ETA calculation, and bottleneck detection 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 2af0db3 commit 85d6344

File tree

2 files changed

+26
-3
lines changed

2 files changed

+26
-3
lines changed

.spec-flow/scripts/bash/implement-workflow.sh

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -420,7 +420,11 @@ ${batch.tasks.map(t => `- ${t.id} [${t.phase || 'GENERAL'}]: ${t.desc}`).join('\
420420
- GREEN: Minimal implementation to pass test, commit when passing
421421
- REFACTOR: Clean up code while keeping tests green, commit
422422
4. For general tasks: Implement, test, commit
423-
5. Update task status in ${notesFile} with ✅ ${t.id} after completion
423+
5. **Task Completion Tracking** (MANDATORY after EACH successful task):
424+
- Call task-tracker to mark task complete and update Progress Summary
425+
- Format: .spec-flow/scripts/bash/task-tracker.sh mark-done-with-notes -TaskId "TXXX" -Notes "Implementation summary (1-2 sentences)" -Evidence "pytest: NN/NN passing" -Coverage "NN% line, NN% branch" -CommitHash "$(git rev-parse --short HEAD)" -Duration "XXmin" -FeatureDir "${featureDir}"
426+
- Example: .spec-flow/scripts/bash/task-tracker.sh mark-done-with-notes -TaskId "T001" -Notes "Created Message model with validation" -Evidence "pytest: 25/25 passing" -Coverage "92% line, 88% branch" -CommitHash "$(git rev-parse --short HEAD)" -Duration "15min" -FeatureDir "${featureDir}"
427+
- This updates both tasks.md checkbox AND NOTES.md AND Progress Summary velocity metrics
424428
6. **Error Handling** (MANDATORY):
425429
- On test failure: Call task-tracker mark-failed BEFORE rollback
426430
- On linting error: Log to error-log.md with full error output
@@ -702,6 +706,8 @@ Before implementing:
702706
703707
### Task Status Updates (mandatory)
704708
709+
**CRITICAL**: You MUST call task-tracker for EVERY task (success or failure)
710+
705711
After successful task completion:
706712
```bash
707713
.spec-flow/scripts/bash/task-tracker.sh mark-done-with-notes \
@@ -710,9 +716,16 @@ After successful task completion:
710716
-Evidence "pytest: NN/NN passing" or "jest: NN/NN passing, a11y: 0 violations" \
711717
-Coverage "NN% line, NN% branch (+ΔΔ%)" \
712718
-CommitHash "$(git rev-parse --short HEAD)" \
719+
-Duration "XXmin" \
713720
-FeatureDir "$FEATURE_DIR"
714721
```
715722
723+
**What this does**:
724+
- Updates tasks.md checkbox from [ ] to [X]
725+
- Appends to NOTES.md with ✅ TXXX: Description - duration (timestamp)
726+
- Updates Progress Summary section with velocity metrics (avg time, ETA, bottlenecks)
727+
- Enables automatic velocity tracking and bottleneck detection
728+
716729
On task failure:
717730
```bash
718731
# MANDATORY: Log error before rollback
@@ -725,6 +738,11 @@ On task failure:
725738
git restore .
726739
```
727740
741+
**What this does**:
742+
- Appends to error-log.md with ❌ TXXX and error details
743+
- Does NOT update tasks.md (leaves checkbox unchecked for retry)
744+
- Enables debugging with complete error history
745+
728746
---
729747
730748
## Error Handling

.spec-flow/scripts/bash/tasks-workflow.sh

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -259,10 +259,15 @@ echo ""
259259
# - Phase N: Polish & Cross-Cutting Concerns
260260
# - [TEST GUARDRAILS] (if tests requested)
261261
262-
echo "Generating tasks.md..."
262+
echo "Generating tasks.md from template..."
263263
echo ""
264264
265-
# Claude Code writes tasks.md with format:
265+
# Claude Code MUST use .spec-flow/templates/tasks-template.md as the base structure
266+
# Read the template file and populate it with generated tasks
267+
#
268+
# Template sections to populate:
269+
# 1. Progress Summary (leave as template placeholders - auto-updated by task-tracker)
270+
# 2. Task Format (follow this structure):
266271
# - [ ] [TID] [P?] [Story?] Description with file path
267272
# - REUSE: ExistingService (path/to/service.py)
268273
# - Pattern: path/to/similar/file.py

0 commit comments

Comments
 (0)