feat: add prdy-status command and PRD status injection into system prompt

- Add prdy-status.sh for quick one-liner PRD health check (short/json output)
- Inject PRD section count and assumption count into agent system prompt
  so the agent knows PRD state at session start without running validate
- Add status subcommand to mosaic prdy routing and help text

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-23 18:33:33 -06:00
parent abead17e0e
commit b1403703b1
2 changed files with 133 additions and 0 deletions

View File

@@ -56,6 +56,7 @@ PRD:
init Create docs/PRD.md via guided runtime session init Create docs/PRD.md via guided runtime session
update Update existing PRD via guided runtime session update Update existing PRD via guided runtime session
validate Check PRD completeness (bash-only) validate Check PRD completeness (bash-only)
status Quick PRD health check (one-liner)
Coordinator (r0): Coordinator (r0):
coord <subcommand> Manual coordinator tools coord <subcommand> Manual coordinator tools
@@ -183,6 +184,40 @@ MISSION_EOF
fi fi
fi fi
# Inject PRD status so the agent knows requirements state
local prd_file="docs/PRD.md"
if [[ -f "$prd_file" ]]; then
local prd_sections=0
local prd_assumptions=0
for entry in "Problem Statement|^#{2,3} .*(problem statement|objective)" \
"Scope / Non-Goals|^#{2,3} .*(scope|non.goal|out of scope|in.scope)" \
"User Stories / Requirements|^#{2,3} .*(user stor|stakeholder|user.*requirement)" \
"Functional Requirements|^#{2,3} .*functional requirement" \
"Non-Functional Requirements|^#{2,3} .*non.functional" \
"Acceptance Criteria|^#{2,3} .*acceptance criteria" \
"Technical Considerations|^#{2,3} .*(technical consideration|constraint|dependenc)" \
"Risks / Open Questions|^#{2,3} .*(risk|open question)" \
"Success Metrics / Testing|^#{2,3} .*(success metric|test|verification)" \
"Milestones / Delivery|^#{2,3} .*(milestone|delivery|scope version)"; do
local pattern="${entry#*|}"
grep -qiE "$pattern" "$prd_file" 2>/dev/null && prd_sections=$((prd_sections + 1))
done
prd_assumptions=$(grep -c 'ASSUMPTION:' "$prd_file" 2>/dev/null || echo 0)
local prd_status="ready"
(( prd_sections < 10 )) && prd_status="incomplete ($prd_sections/10 sections)"
cat <<PRD_EOF
# PRD Status
- **File:** docs/PRD.md
- **Status:** $prd_status
- **Assumptions:** $prd_assumptions
PRD_EOF
fi
cat <<'EOF' cat <<'EOF'
# Mosaic Launcher Runtime Contract (Hard Gate) # Mosaic Launcher Runtime Contract (Hard Gate)
@@ -639,6 +674,9 @@ run_prdy() {
validate|check) validate|check)
MOSAIC_PRDY_RUNTIME="$runtime" exec bash "$tool_dir/prdy-validate.sh" "$@" MOSAIC_PRDY_RUNTIME="$runtime" exec bash "$tool_dir/prdy-validate.sh" "$@"
;; ;;
status)
exec bash "$tool_dir/prdy-status.sh" "$@"
;;
help|*) help|*)
cat <<PRDY_USAGE cat <<PRDY_USAGE
mosaic prdy — PRD creation and validation tools mosaic prdy — PRD creation and validation tools
@@ -647,6 +685,7 @@ Commands:
init [--project <path>] [--name <feature>] Create docs/PRD.md via guided runtime session init [--project <path>] [--name <feature>] Create docs/PRD.md via guided runtime session
update [--project <path>] Update existing docs/PRD.md via guided runtime session update [--project <path>] Update existing docs/PRD.md via guided runtime session
validate [--project <path>] Check PRD completeness against Mosaic guide (bash-only) validate [--project <path>] Check PRD completeness against Mosaic guide (bash-only)
status [--project <path>] [--format short|json] Quick PRD health check (one-liner)
Runtime: Runtime:
--claude Use Claude runtime (default) --claude Use Claude runtime (default)

94
tools/prdy/prdy-status.sh Executable file
View File

@@ -0,0 +1,94 @@
#!/usr/bin/env bash
set -euo pipefail
#
# prdy-status.sh — Quick PRD health check (one-liner output)
#
# Usage:
# prdy-status.sh [--project <path>] [--format short|json]
#
# Exit codes:
# 0 = PRD ready (all required sections present)
# 1 = PRD incomplete
# 2 = PRD missing
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/_lib.sh"
# ─── Parse arguments ─────────────────────────────────────────────────────────
PROJECT="."
FORMAT="short"
while [[ $# -gt 0 ]]; do
case "$1" in
--project) PROJECT="$2"; shift 2 ;;
--format) FORMAT="$2"; shift 2 ;;
-h|--help)
cat <<'USAGE'
prdy-status.sh — Quick PRD health check
Usage: prdy-status.sh [--project <path>] [--format short|json]
Options:
--project <path> Project directory (default: CWD)
--format <f> Output format: short (default) or json
Exit codes:
0 = PRD ready (all required sections present)
1 = PRD incomplete
2 = PRD missing
USAGE
exit 0
;;
*) echo "Unknown option: $1" >&2; exit 1 ;;
esac
done
PROJECT="${PROJECT/#\~/$HOME}"
# ─── Status check ────────────────────────────────────────────────────────────
PRD_PATH="$(find_prd "$PROJECT")"
if [[ -z "$PRD_PATH" ]]; then
if [[ "$FORMAT" == "json" ]]; then
echo '{"status":"missing"}'
else
echo "PRD: missing"
fi
exit 2
fi
# Count present sections using the shared manifest
PRD_CONTENT="$(cat "$PRD_PATH")"
total=${#PRDY_REQUIRED_SECTIONS[@]}
present=0
for entry in "${PRDY_REQUIRED_SECTIONS[@]}"; do
pattern="${entry#*|}"
if echo "$PRD_CONTENT" | grep -qiE "$pattern"; then
present=$((present + 1))
fi
done
# Count additional metrics
fr_count=$(echo "$PRD_CONTENT" | grep -cE '^\- FR-[0-9]+:|^FR-[0-9]+:' || true)
us_count=$(echo "$PRD_CONTENT" | grep -cE '^#{1,4} US-[0-9]+' || true)
assumptions=$(echo "$PRD_CONTENT" | grep -c 'ASSUMPTION:' || true)
if (( present == total )); then
status="ready"
exit_code=0
else
status="incomplete"
exit_code=1
fi
if [[ "$FORMAT" == "json" ]]; then
printf '{"status":"%s","sections":%d,"total":%d,"frs":%d,"stories":%d,"assumptions":%d}\n' \
"$status" "$present" "$total" "$fr_count" "$us_count" "$assumptions"
else
echo "PRD: $status ($present/$total sections, ${fr_count} FRs, ${us_count} stories, $assumptions assumptions)"
fi
exit "$exit_code"