@ktpartners/dgs-platform 2.6.2

package/commands/dgs/validate-phase.md

@@ -0,0 +1,35 @@
+---
+name: dgs:validate-phase
+description: Retroactively audit and fill Nyquist validation gaps for a completed phase
+argument-hint: "[phase number]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Audit Nyquist validation coverage for a completed phase. Three states:
+- (A) VALIDATION.md exists — audit and fill gaps
+- (B) No VALIDATION.md, SUMMARY.md exists — reconstruct from artifacts
+- (C) Phase not executed — exit with guidance
+
+Output: updated VALIDATION.md + generated test files.
+</objective>
+
+<execution_context>
+@~/.claude/deliver-great-systems/workflows/validate-phase.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS — optional, defaults to last completed phase.
+</context>
+
+<process>
+Execute @~/.claude/deliver-great-systems/workflows/validate-phase.md.
+Preserve all workflow gates.
+</process>

package/commands/dgs/verify-work.md

@@ -0,0 +1,39 @@
+---
+name: dgs:verify-work
+description: Validate built features through conversational UAT
+argument-hint: "[phase number, e.g., '4'] [--auto]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Edit
+  - Write
+  - Task
+---
+<objective>
+Validate built features through conversational testing with persistent state.
+
+Purpose: Confirm what Claude built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
+
+Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /dgs:execute-phase
+</objective>
+
+<execution_context>
+@~/.claude/deliver-great-systems/workflows/verify-work.md
+@~/.claude/deliver-great-systems/templates/UAT.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS (optional)
+- If provided: Test specific phase (e.g., "4")
+- If not provided: Check for active sessions or prompt for phase
+- If `--auto` flag provided: Auto-pass all tests (rubber stamp for jobs)
+
+Context files are resolved inside the workflow (`init verify-work`) and delegated via `<files_to_read>` blocks.
+</context>
+
+<process>
+Execute the verify-work workflow from @~/.claude/deliver-great-systems/workflows/verify-work.md end-to-end.
+Preserve all workflow gates (session management, test presentation, diagnosis, fix planning, routing).
+</process>

package/commands/dgs/write-spec.md

@@ -0,0 +1,49 @@
+---
+name: dgs:write-spec
+description: Draft a structured PRD spec from pending ideas with cross-LLM review
+argument-hint: [idea-ids...] [--auto]
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - AskUserQuestion
+---
+
+<objective>
+Draft a structured PRD spec from one or more pending ideas, send it through a cross-LLM review loop, and finalize it. Supports two modes:
+
+- **Interactive mode** (default): Select ideas interactively or pass IDs as args, Claude drafts PRD with clarifying questions, user reviews draft before sending to reviewers, user approves final spec
+- **Auto mode** (`--auto`): Requires idea IDs as arguments, Claude drafts PRD without clarifying questions, review loop runs normally, spec auto-finalizes without user approval
+
+The spec covers the full lifecycle: idea selection, PRD generation with all required sections, cross-LLM review loop, convergence detection, and finalization with idea movement to done.
+</objective>
+
+<execution_context>
+@~/.claude/deliver-great-systems/workflows/write-spec.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (optional idea IDs and `--auto` flag)
+
+Codebase context for Technical Considerations:
+@.planning/codebase/ARCHITECTURE.md
+@.planning/codebase/STACK.md
+@.planning/codebase/STRUCTURE.md
+</context>
+
+<process>
+**Follow the write-spec workflow** from `@~/.claude/deliver-great-systems/workflows/write-spec.md`.
+
+The workflow handles all logic including:
+1. Argument parsing (detect `--auto` mode, extract idea IDs)
+2. Loading pending ideas via `dgs-tools.cjs ideas list`
+3. Interactive idea selection or validation of provided IDs
+4. Loading codebase context for Technical Considerations
+5. Collaborative PRD drafting with clarifying questions (interactive) or silent drafting (auto)
+6. Draft saving via `dgs-tools.cjs specs create`
+7. Draft review and approval (interactive only)
+8. Cross-LLM review loop (sends to OpenAI/Gemini reviewers)
+9. Finalization with spec status transition and idea movement
+</process>

package/deliver-great-systems/.planning/phases/09-backend-wiring-and-error-handling/09-01-SUMMARY.md

@@ -0,0 +1,84 @@
+---
+phase: 09-backend-wiring-and-error-handling
+plan: 01
+subsystem: cli
+tags: [error-handling, cli-routing, repos, project-context]
+
+requires:
+  - phase: 04-multi-repo-planning-and-execution
+    provides: autoPopulateReposTags, validateReposConsistency functions
+  - phase: 03-project-lifecycle
+    provides: PROJECT_COMPLETED error type in getProjectRoot
+provides:
+  - PROJECT_COMPLETED guard handler in resolveProjectContext
+  - CLI routes for repos auto-populate and validate-consistency
+affects: [execute-plan, plan-phase]
+
+tech-stack:
+  added: []
+  patterns: [guard-object error handling, cmd-wrapper CLI pattern]
+
+key-files:
+  created: []
+  modified:
+    - get-shit-done/bin/lib/init.cjs
+    - get-shit-done/bin/lib/repos.cjs
+    - get-shit-done/bin/gsd-tools.cjs
+
+key-decisions:
+  - "PROJECT_COMPLETED handler mirrors exact shape of PROJECT_NOT_FOUND guard — root: null, gsd_mode, current_project, guard, v2_hint"
+  - "cmdReposAutoPopulate writes updated content back to plan file; cmdReposValidateConsistency is read-only"
+  - "Both cmd wrappers check for REPOS.md presence before calling library functions"
+
+patterns-established:
+  - "Guard handler pattern: catch error prefix, extract name, return guard object with action and message"
+  - "CLI cmd wrapper pattern: validate args, read file, load repos, call function, output JSON"
+
+requirements-completed: [FOUN-04, PLAN-02, PLAN-03]
+
+duration: 3min
+completed: 2026-02-24
+---
+
+# Phase 9 Plan 01: Backend Wiring & Error Handling Summary
+
+**PROJECT_COMPLETED guard handler in resolveProjectContext plus CLI routes for repos auto-populate and validate-consistency**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-02-24
+- **Completed:** 2026-02-24
+- **Tasks:** 2
+- **Files modified:** 3
+
+## Accomplishments
+- resolveProjectContext() now catches PROJECT_COMPLETED errors and returns a guard object instead of crashing
+- repos auto-populate CLI route reads a plan file, auto-populates <repos> tags from <files> paths, and writes the result
+- repos validate-consistency CLI route validates <repos>/<files> consistency and returns mismatches as JSON
+
+## Files Created/Modified
+- `get-shit-done/bin/lib/init.cjs` - Added PROJECT_COMPLETED catch clause in resolveProjectContext
+- `get-shit-done/bin/lib/repos.cjs` - Added cmdReposAutoPopulate and cmdReposValidateConsistency wrappers
+- `get-shit-done/bin/gsd-tools.cjs` - Added repos auto-populate and validate-consistency routes, updated usage docs
+
+## Decisions Made
+- PROJECT_COMPLETED guard returns same shape as existing guards for consistency
+- cmd wrappers validate REPOS.md presence to avoid crashes on v1 installs
+
+## Deviations from Plan
+None - plan executed exactly as written.
+
+## Issues Encountered
+None.
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- FOUN-04, PLAN-02, PLAN-03 satisfied
+- All 203 tests pass across core, repos, and execution suites
+
+---
+*Phase: 09-backend-wiring-and-error-handling*
+*Completed: 2026-02-24*

package/deliver-great-systems/.planning/phases/09-backend-wiring-and-error-handling/09-02-SUMMARY.md

@@ -0,0 +1,86 @@
+---
+phase: 09-backend-wiring-and-error-handling
+plan: 02
+subsystem: cli
+tags: [commit-routing, workflow-integration, preflight, detect-manual]
+
+requires:
+  - phase: 04-multi-repo-planning-and-execution
+    provides: detectManualResolution, cmdCommitPreflight, cmdCommitMultiRepo
+provides:
+  - --phase-dir flag in commit routing
+  - detect-manual CLI subcommand
+  - Pre-flight check reference in execute-plan workflow
+  - .planning/ commit guard in execute-plan workflow
+affects: [execute-plan, execute-phase]
+
+tech-stack:
+  added: []
+  patterns: [advisory preflight, commit guard]
+
+key-files:
+  created: []
+  modified:
+    - get-shit-done/bin/gsd-tools.cjs
+    - get-shit-done/workflows/execute-plan.md
+
+key-decisions:
+  - "detect-manual subcommand placed before --multi-repo check in commit routing to avoid flag collision"
+  - "--phase-dir parsed in both single-repo and multi-repo paths; passed through to cmdCommitMultiRepo options"
+  - "Preflight check is advisory only — warns but does not block execution"
+  - ".planning/ commit guard warns on partial failure but proceeds to track progress"
+
+patterns-established:
+  - "Advisory preflight pattern: check before execution, warn, continue regardless"
+  - "Commit guard pattern: check prior results, warn on failure, proceed for progress tracking"
+
+requirements-completed: [EXEC-03, EXEC-06]
+
+duration: 3min
+completed: 2026-02-24
+---
+
+# Phase 9 Plan 02: Commit Routing & Workflow Integration Summary
+
+**--phase-dir flag and detect-manual subcommand in CLI, plus pre-flight and .planning/ commit guard in execute-plan workflow**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-02-24
+- **Completed:** 2026-02-24
+- **Tasks:** 2
+- **Files modified:** 2
+
+## Accomplishments
+- --phase-dir flag parsed in both single-repo and multi-repo commit paths
+- detect-manual subcommand routes to detectManualResolution and returns JSON
+- execute-plan workflow references commit preflight as advisory pre-execution check for multi-repo projects
+- execute-plan workflow guards .planning/ metadata commit with warning when repo commits have failures
+
+## Files Created/Modified
+- `get-shit-done/bin/gsd-tools.cjs` - Added --phase-dir flag, detect-manual subcommand, updated usage docs
+- `get-shit-done/workflows/execute-plan.md` - Added preflight_check step and multi-repo guard in git_commit_metadata step
+
+## Decisions Made
+- Preflight is advisory — displays warning but never blocks execution
+- .planning/ commit proceeds even on partial failure to track progress
+- detect-manual reference included near preflight for retry scenarios
+
+## Deviations from Plan
+None - plan executed exactly as written.
+
+## Issues Encountered
+None.
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- EXEC-03, EXEC-06 satisfied
+- All 203 tests pass
+- All v2 CLI routes are now wired to their backend functions
+
+---
+*Phase: 09-backend-wiring-and-error-handling*
+*Completed: 2026-02-24*

package/deliver-great-systems/.planning/phases/10-v1-to-v2-migration-flow/10-01-SUMMARY.md

@@ -0,0 +1,85 @@
+---
+phase: 10-v1-to-v2-migration-flow
+plan: 01
+subsystem: cli
+tags: [migration, workflow, init-product, v1-to-v2]
+
+requires:
+  - phase: 07-v1-to-v2-migration
+    provides: migration.cjs with cmdMigrateV1ToV2, detectV1Install
+  - phase: 08-missing-slash-command-entry-points
+    provides: init-product.md workflow with v1_detected placeholder
+provides:
+  - v1-to-v2 migration prompt in init-product workflow
+  - Decline persistence guard in cmdReposInitProduct
+  - Three v1 paths: migrate, decline, previously-declined
+affects: [init-product]
+
+tech-stack:
+  added: []
+  patterns: [config-flag persistence, workflow user prompting]
+
+key-files:
+  created: []
+  modified:
+    - get-shit-done/workflows/init-product.md
+    - get-shit-done/bin/lib/repos.cjs
+
+key-decisions:
+  - "Config flag v1_decline_migration checked BEFORE detectV1Install to skip prompting entirely"
+  - "v1_declined response shape distinct from v1_detected for separate workflow handling"
+  - "Migration failure shows rollback info and retry instructions"
+
+patterns-established:
+  - "Config-flag guard pattern: check config before expensive operation, skip if flag set"
+  - "Decline persistence: write config immediately, check on subsequent runs"
+
+requirements-completed: [MIGR-01, MIGR-04]
+
+duration: 3min
+completed: 2026-02-24
+---
+
+# Phase 10 Plan 01: v1-to-v2 Migration Flow Summary
+
+**Migration prompt in init-product workflow with decline persistence and three v1 handling paths**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-02-24
+- **Completed:** 2026-02-24
+- **Tasks:** 2
+- **Files modified:** 2
+
+## Accomplishments
+- init-product workflow prompts v1 users to migrate or decline (replaces placeholder message)
+- Migration path calls `repos migrate <slug>` and shows results with backup tag info
+- Decline path persists choice via config-set, preventing re-prompts on subsequent runs
+- Previously-declined users see direct v1-mode message without being prompted
+
+## Files Created/Modified
+- `get-shit-done/workflows/init-product.md` - Replaced v1_detected placeholder with migration prompt, added v1_declined handler
+- `get-shit-done/bin/lib/repos.cjs` - Added v1_decline_migration config check guard in cmdReposInitProduct
+
+## Decisions Made
+- Config flag checked before detectV1Install to skip prompting entirely for declined users
+- v1_declined response is distinct from v1_detected for clear workflow routing
+
+## Deviations from Plan
+None - plan executed exactly as written.
+
+## Issues Encountered
+None.
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- MIGR-01, MIGR-04 satisfied
+- 93 repos tests + 38 migration tests pass
+- All v1 paths handled: migrate, decline, previously-declined
+
+---
+*Phase: 10-v1-to-v2-migration-flow*
+*Completed: 2026-02-24*