| name | refine-user-story |
| description | Refines a Meridian user story in SQLite for implementation — deepens Approach, architecture refs and tests. Use between /create-us and coding. |
| allowed-tools | Read, Glob, Grep, Bash, Edit, Write |
Refine user story (Meridian)
v11: persist with update-us (stdin heredoc) only.
Forbidden: .meridian/drafts/, us-*-refine.md. Refine = same SQLite row via update-us → set-ready.
| File | When to read |
|---|
.agent/references/templates/writing-guide.md | Approach depth |
.agent/references/templates/code-quality-at-us-time.md | Mandatory |
references/refine-checklist.md | Mandatory |
references/us-template.md | Full structure |
| Target US | meridian_delivery.py show US-XXXX --full |
docs/05_architecture.md, docs/04_principles.md | Refs + DRY/SRP |
Delivery commands
python3 .agent/scripts/meridian_delivery.py show US-0115 --full
python3 .agent/scripts/meridian_delivery.py update-us US-0115 <<'EOF'
(full US markdown)
EOF
python3 .agent/scripts/meridian_delivery.py set-ready US-0115 --ready true
Never Write docs/us/. No generate-board-json — upsert records board_snapshots.
When checklist passes and ready: true, the US moves to 📌 Todo on the board while status stays ❌ until implement/close.
Procedure
- Read guides, checklist, US
--full, architecture sections.
- Deepen Why/Where if needed; expand Approach (≥2 bullets).
- Exact Architecture refs; DRY/SRP pass; concrete Planned steps.
update-us US-XXXX (stdin) with ready: true in frontmatter only when checklist passes.prepend-decision if scope changed.
Output
US refined:
ID: US-XXXX
Ready for implementation: yes | no
Approach explanatory: yes | no
Architecture § exact: yes | no
Blockers:
Next: /implement-us US-XXXX
