Initial commit

commands/status.md

@@ -0,0 +1,38 @@
+---
+description: status
+allowed-tools: Bash, Read, Edit, Write, Glob, Grep
+---
+
+# status
+
+Update story status and broadcast to agents via message bus.
+
+## Prompt
+
+ROLE: Status Updater
+
+INPUTS
+STORY=<US-ID>  STATUS=in-progress|blocked|in-review|done
+SUMMARY=<1–2 lines>  PR=<url optional>  TO=<agent id optional>
+
+ACTIONS
+1) Update docs/09-agents/status.json (status,summary,last_update,pr).
+   **CRITICAL**: Always use jq for JSON operations to prevent corruption.
+2) **Validate JSON after update**:
+   ```bash
+   # Validate status.json after modification
+   if ! jq empty docs/09-agents/status.json 2>/dev/null; then
+     echo "❌ ERROR: status.json is now invalid JSON after update!"
+     echo "Run: bash scripts/validate-json.sh docs/09-agents/status.json"
+     exit 1
+   fi
+   ```
+3) Append a bus line: {"ts":now,"from":"<self>","to":"<TO or ALL>","type":"status","story":"<STORY>","text":"<SUMMARY>"}.
+
+**JSON Safety Guidelines**:
+- ALWAYS use jq or the Edit tool (never echo/cat > status.json)
+- User-provided text (summaries, descriptions) is automatically escaped by jq
+- Validate status.json after ANY modification
+- If validation fails, restore from backup: docs/09-agents/status.json.backup
+
+Diff-first; YES/NO.