← ClaudeAtlas

archflow-groomlisted

Use ONLY when the user asks for /archflow-groom or "archflow groom". Detail or refine a story: acceptance criteria, subtasks, gates. Works on a backlog stub or a story already in a release
AZidan/archflow · ★ 27 · AI & Automation · score 81
Install: claude install-skill AZidan/archflow
> Arguments are the text after the skill name. # /archflow-groom — Detail or refine a story Argument (`the text the user wrote after the skill name`): optional story id (e.g. `S2-11`). Empty → list stubs and ask which to groom. Grooming turns a bare stub (title + one line) into a `ready` story with acceptance criteria, subtasks, and gates, and **refines a story that is already in a release** when its scope turns out to be wrong. It is the canonical description of *how a story gets detailed* — `release.md` (feature-planner Mode B) and the phase-3 pull-forward both defer here rather than restating it. Grooming refines scope. It does NOT commit the story to a release or start a build — those stay separate on purpose, so a story can be made ready without anyone deciding when to ship it. ## Usage ``` /archflow-groom → list stubs in backlog.yaml, ask which to groom /archflow-groom S2-11 → groom that story, wherever it lives ``` **Two modes, chosen by where the story is, not by an argument.** A backlog story is groomed into `ready` (**backlog mode**). A story already in a release is refined in place with its gates re-derived (**release mode**). The user's question is "refine this story"; which file it happens to sit in is an implementation detail they should not have to know. ## Flow 1. Read `.archflow/current-phase.yaml` (for `mode`), `.archflow/project-settings.yaml` (for `project_type`) and `.archflow/backlog.yaml`. Resolve the id. With no argument,