BuhDuy256/deck-agent / .agents/skills/flow-tracker-update
flow-tracker-update
VerifiedUpdate the flow tracker issue for a UC. Reads current issue statuses from GitHub and updates the tracker's phase checklists. Used after any ticket closes.
Flow tracker update
Update the flow tracker issue to reflect current ticket statuses.
Input
- The UC identifier (e.g., UC-001).
- The flow tracker issue number.
- The version (milestone
vN), from the tracker's scope ordev/versions/README.md.
Process
1. Get current ticket statuses
A milestone holds every build of the version, so filter by the UC label too, and keep only the tickets the tracker body lists (several builds of one UC can coexist).
gh issue list --milestone "vN" --label "uc:XXX" --state all --json number,title,state,labels,assignees
2. Group by phase
Using the phase:* labels, group tickets into their phases. Show the tier of test
tickets (tier:*) and the test author of implementation tickets.
3. Update the flow tracker issue
For each ticket:
[x]if the issue state isclosed[ ]if the issue state isopen
gh issue edit TRACKER_NUMBER --body "..."
4. Check phase gates
The gates are defined in WORKFLOW.md "Phases". This skill reports whether their ticket-based parts hold; it never closes a gate (the PO does).
- Phase 1: all
phase:researchtickets closed. - Phase 2: all
phase:test-stubstickets closed (each test approved by the PO). - Phase 3: the implementation plan is approved by the PO.
- Phase 4: every implementation ticket exists and names a test author who is not its assignee. Report any separation-rule conflict.
- Phase 5: all
phase:implandphase:post-impltickets closed. - Phase 6: every row in
dev/versions/vN/builds/UC-XXX-label/traceability-matrix.mdhas Verified ticked;eval-runs/has a run for every eval-tier AC;as-built.mdhas a prediction, an actual flow and a drift section. Mirror the per-AC checklist under "Verified per AC" from the matrix rows.
Report a gate as "ready for the PO" rather than "complete".
5. Update the local mirror
Update dev/versions/vN/builds/UC-XXX-label/flow-tracker.md to match the GitHub issue.
Linking convention
All #N references in local plan files must be clickable Markdown links (see
WORKFLOW.md "Linking convention"). At the start, derive the repo base URL:
git remote get-url origin
# https://github.com/{owner}/{repo}.git → base = https://github.com/{owner}/{repo}
When updating dev/versions/vN/builds/UC-XXX-label/flow-tracker.md, write every ticket reference as
[#N]({base}/issues/N). The GitHub issue body uses bare #N (auto-linked).
Rules
- Do not close tickets — only update the tracker display.
- Do not change ticket labels or assignments.
- Report the current phase and any blocked tickets in the output.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 117k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |