a5eceb1faf
Extends the canonical runtime-launcher snippet with a third resolution arm
that probes $HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME} between the
PATH check and the hard-error exit. Global Claude-Code installs (--claude
without --local) with no PATH wiring and no RUNTIME_DIR no longer hit the
hard-error path.
Resolution order: local/RUNTIME_DIR -> PATH -> ~/.claude/... -> hard error.
Propagated to 76 workflow .md files via sync-runtime-launcher.cjs. Parity
test (G) and bug-211 regression test (4 assertions) added.
111 lines
3.5 KiB
Markdown
111 lines
3.5 KiB
Markdown
<purpose>
|
|
Cross-phase audit of all UAT and verification files. Finds every outstanding item (pending, skipped, blocked, human_needed), optionally verifies against the codebase to detect stale docs, and produces a prioritized human test plan.
|
|
</purpose>
|
|
|
|
<process>
|
|
|
|
<step name="initialize">
|
|
Run the CLI audit:
|
|
|
|
```bash
|
|
_GSD_SHIM_NAME="gsd-tools.cjs"; GSD_TOOLS="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}/get-shit-done/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/get-shit-done-redux@latest --claude --local" >&2; exit 1; fi
|
|
AUDIT=$(gsd_run query audit-uat --raw)
|
|
```
|
|
|
|
Parse JSON for `results` array and `summary` object.
|
|
|
|
If `summary.total_items` is 0:
|
|
```
|
|
## All Clear
|
|
|
|
No outstanding UAT or verification items found across all phases.
|
|
All tests are passing, resolved, or diagnosed with fix plans.
|
|
```
|
|
Stop here.
|
|
</step>
|
|
|
|
<step name="categorize">
|
|
Group items by what's actionable NOW vs. what needs prerequisites:
|
|
|
|
**Testable Now** (no external dependencies):
|
|
- `pending` — tests never run
|
|
- `human_uat` — human verification items
|
|
- `skipped_unresolved` — skipped without clear blocking reason
|
|
|
|
**Needs Prerequisites:**
|
|
- `server_blocked` — needs external server running
|
|
- `device_needed` — needs physical device (not simulator)
|
|
- `build_needed` — needs release/preview build
|
|
- `third_party` — needs external service configuration
|
|
|
|
For each item in "Testable Now", use Grep/Read to check if the underlying feature still exists in the codebase:
|
|
- If the test references a component/function that no longer exists → mark as `stale`
|
|
- If the test references code that has been significantly rewritten → mark as `needs_update`
|
|
- Otherwise → mark as `active`
|
|
</step>
|
|
|
|
<step name="present">
|
|
Present the audit report:
|
|
|
|
```
|
|
## UAT Audit Report
|
|
|
|
**{total_items} outstanding items across {total_files} files in {phase_count} phases**
|
|
|
|
### Testable Now ({count})
|
|
|
|
| # | Phase | Test | Description | Status |
|
|
|---|-------|------|-------------|--------|
|
|
| 1 | {phase} | {test_name} | {expected} | {active/stale/needs_update} |
|
|
...
|
|
|
|
### Needs Prerequisites ({count})
|
|
|
|
| # | Phase | Test | Blocked By | Description |
|
|
|---|-------|------|------------|-------------|
|
|
| 1 | {phase} | {test_name} | {category} | {expected} |
|
|
...
|
|
|
|
### Stale (can be closed) ({count})
|
|
|
|
| # | Phase | Test | Why Stale |
|
|
|---|-------|------|-----------|
|
|
| 1 | {phase} | {test_name} | {reason} |
|
|
...
|
|
|
|
---
|
|
|
|
## Recommended Actions
|
|
|
|
1. **Close stale items:** `/gsd:verify-work {phase}` — mark stale tests as resolved
|
|
2. **Run active tests:** Human UAT test plan below
|
|
3. **When prerequisites met:** Retest blocked items with `/gsd:verify-work {phase}`
|
|
```
|
|
</step>
|
|
|
|
<step name="test_plan">
|
|
Generate a human UAT test plan for "Testable Now" + "active" items only:
|
|
|
|
Group by what can be tested together (same screen, same feature, same prerequisite):
|
|
|
|
```
|
|
## Human UAT Test Plan
|
|
|
|
### Group 1: {category — e.g., "Billing Flow"}
|
|
Prerequisites: {what needs to be running/configured}
|
|
|
|
1. **{Test name}** (Phase {N})
|
|
- Navigate to: {where}
|
|
- Do: {action}
|
|
- Expected: {expected behavior}
|
|
|
|
2. **{Test name}** (Phase {N})
|
|
...
|
|
|
|
### Group 2: {category}
|
|
...
|
|
```
|
|
</step>
|
|
|
|
</process>
|