@ktpartners/dgs-platform 2.6.2

package/deliver-great-systems/workflows/list-specs.md

@@ -0,0 +1,101 @@
+<purpose>
+Display all specs grouped by status (Draft, Final) with version, implementation status, source ideas, and dates. Read-only command -- no file modifications.
+</purpose>
+
+<context_tier>lite</context_tier>
+
+<required_reading>
+Read all files referenced by the invoking prompt's execution_context before starting.
+</required_reading>
+
+<process>
+
+<step name="load_context" priority="first">
+Load project context via tier system:
+
+```bash
+TIER_FILES=$(node "$HOME/.claude/deliver-great-systems/bin/dgs-tools.cjs" context load-tier lite --raw 2>/dev/null)
+```
+
+Use `TIER_FILES` JSON `files` array for project context (PROJECT.md, STATE.md, config.json).
+</step>
+
+<step name="parse_arguments">
+Check `$ARGUMENTS` for status filter flags:
+
+- `--draft` -> set `status_filter = draft`
+- `--review` -> set `status_filter = review`
+- `--final` -> set `status_filter = final`
+- No flag -> set `status_filter = null` (show all)
+
+If multiple flags present, use the first one found.
+</step>
+
+<step name="load_specs">
+Fetch specs from the specs library:
+
+```bash
+node ~/.claude/deliver-great-systems/bin/dgs-tools.cjs specs list [--status $status_filter]
+```
+
+Only include `--status` if `status_filter` is not null.
+
+Parse JSON result: `{ specs: [...], counts: { draft, review, final, total } }`.
+</step>
+
+<step name="display_results">
+**If `total = 0`:**
+```
+No specs yet. Run `/dgs:write-spec` to create one from your pending ideas.
+```
+Stop execution.
+
+**Otherwise, display specs grouped by status:**
+
+```
+## Specs
+
+### Draft (N)
+| ID | Title | Version | Implementation | Source Ideas | Created |
+|----|-------|---------|----------------|-------------|---------|
+| spec-review-config | Review Configuration | 1.0 | v5.0 (completed) | #001, #003 | 2026-02-25 |
+
+### Final (N)
+| ID | Title | Version | Implementation | Source Ideas | Created |
+|----|-------|---------|----------------|-------------|---------|
+| ... | ... | ... | ... | ... | ... |
+
+**Total: N specs** (D draft, F final)
+```
+
+**Formatting rules:**
+- Group specs by status: Draft, Final
+- Only show groups that have specs (skip empty groups)
+- Format `source_ideas` as comma-separated `#ID` references (extract the zero-padded number from filename, e.g., "001-slug.md" -> "#001")
+- Format `created` as date only (YYYY-MM-DD), not full ISO timestamp
+- Format `Version` from the spec's `version` field (show `--` if empty)
+- Format `Implementation` column from `milestone_details` array:
+  - No milestones: show `--`
+  - Single milestone: `v5.0 (completed)` or `v13.0 (in-progress)`
+  - Multiple milestones: comma-separated, e.g., `v5.0 (completed), v13.0 (in-progress)`
+  - Use the `state` field from each entry in `milestone_details` array
+- If a status filter is active, only show that single section
+- Remove "In Review" group header (review status is normalized to draft in the two-state machine)
+
+**If filtered and no matches:**
+```
+No specs with status "$status_filter". Run `/dgs:list-specs` to see all specs.
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Specs listed and grouped by status
+- [ ] Source ideas formatted as #ID references
+- [ ] Status filter works (--draft, --review, --final)
+- [ ] Empty state shows helpful hint
+- [ ] Read-only: no files modified
+- [ ] Implementation column shows milestone versions with state
+- [ ] Version column shows spec version
+</success_criteria>