From eb6ce62a76a9ce950e457879e631060f451d25d8 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Mon, 2 Feb 2026 14:00:24 -0500 Subject: [PATCH] feat(projman): add sprint dispatch log for session recovery - progress-tracking.md: new Sprint Dispatch Log section with event types - orchestrator.md: new responsibility to maintain dispatch log - Enables timeline reconstruction after interrupted sessions Co-Authored-By: Claude Opus 4.5 --- .doc-guardian-queue | 1 + plugins/projman/agents/orchestrator.md | 7 ++++ plugins/projman/skills/progress-tracking.md | 43 +++++++++++++++++++++ 3 files changed, 51 insertions(+) diff --git a/.doc-guardian-queue b/.doc-guardian-queue index 7ff06a0..6d59e49 100644 --- a/.doc-guardian-queue +++ b/.doc-guardian-queue @@ -23,3 +23,4 @@ 2026-02-02T13:51:32 | mcp-servers | /home/lmiranda/claude-plugins-work/mcp-servers/contract-validator/tests/test_validation_tools.py | docs/COMMANDS-CHEATSHEET.md CLAUDE.md 2026-02-02T13:51:49 | skills | /home/lmiranda/claude-plugins-work/plugins/contract-validator/skills/validation-rules.md | README.md 2026-02-02T13:52:07 | skills | /home/lmiranda/claude-plugins-work/plugins/contract-validator/skills/mcp-tools-reference.md | README.md +2026-02-02T13:59:09 | skills | /home/lmiranda/claude-plugins-work/plugins/projman/skills/progress-tracking.md | README.md diff --git a/plugins/projman/agents/orchestrator.md b/plugins/projman/agents/orchestrator.md index af3914e..9f48f2e 100644 --- a/plugins/projman/agents/orchestrator.md +++ b/plugins/projman/agents/orchestrator.md @@ -96,6 +96,13 @@ Execute `skills/wiki-conventions.md` - Update implementation status. ### 10. Git Operations (Sprint Close) Execute `skills/git-workflow.md` - Merge, tag, clean up branches. +### 11. Maintain Dispatch Log +Execute `skills/progress-tracking.md` (Sprint Dispatch Log section): +- Create dispatch log header at sprint start +- Append row on every task dispatch, completion, failure, and domain gate check +- On sprint resume: add "Resumed" row with checkpoint context +- Log is posted as comments, one `add_comment` per event + ## Critical Reminders 1. **NEVER use CLI tools** - Use MCP tools exclusively (see `skills/mcp-tools-reference.md`) diff --git a/plugins/projman/skills/progress-tracking.md b/plugins/projman/skills/progress-tracking.md index 0e07d85..2d89bf3 100644 --- a/plugins/projman/skills/progress-tracking.md +++ b/plugins/projman/skills/progress-tracking.md @@ -138,6 +138,49 @@ For resume support, save checkpoints after major steps: --- +## Sprint Dispatch Log + +A single structured comment on the sprint milestone that records all task dispatches and completions. This is the first place to look when resuming an interrupted sprint. + +### Format + +Post as a comment on the milestone (via `add_comment` on a pinned tracking issue, or as milestone description appendix): + +```markdown +## Sprint Dispatch Log + +| Time | Issue | Action | Agent | Branch | Notes | +|------|-------|--------|-------|--------|-------| +| 14:30 | #45 | Dispatched | Executor | feat/45-jwt | Parallel batch 1 | +| 14:30 | #46 | Dispatched | Executor | feat/46-login | Parallel batch 1 | +| 14:45 | #45 | Complete | Executor | feat/45-jwt | 47 tool calls, merged | +| 14:52 | #46 | Failed | Executor | feat/46-login | Auth test failure | +| 14:53 | #46 | Re-dispatched | Executor | feat/46-login | After fix | +| 15:10 | #46 | Complete | Executor | feat/46-login | 62 tool calls, merged | +| 15:10 | #47 | Dispatched | Executor | feat/47-tests | Batch 2 (depended on #45, #46) | +``` + +### When to Log + +| Event | Action Column | Required Fields | +|-------|---------------|-----------------| +| Task dispatched to executor | `Dispatched` | Time, Issue, Branch, Batch info | +| Task completed | `Complete` | Time, Issue, Tool call count | +| Task failed | `Failed` | Time, Issue, Error summary | +| Task re-dispatched | `Re-dispatched` | Time, Issue, Reason | +| Domain gate checked | `Gate: PASS` or `Gate: FAIL` | Time, Issue, Domain | +| Sprint resumed | `Resumed` | Time, Notes (from checkpoint) | + +### Implementation + +The orchestrator appends rows to this log via `add_comment` on the first issue in the milestone (or a dedicated tracking issue). Each append is a single `add_comment` call updating the table. + +**On sprint start:** Create the dispatch log header. +**On each event:** Append a row. +**On sprint resume:** Add a "Resumed" row with checkpoint context. + +--- + ## Sprint Progress Display ```