Why
After specflow init, the "Next steps" output tells users to run /backlog add "<first task title>" as their first action. The public docs quickstart at specflow.makerlabs.dev says the first thing to do is open the project in Claude Code and run /specflow.specify. The /specflow.specify command is correctly scaffolded at .claude/commands/specflow.specify.md — the docs are not wrong. The init message just steers the user to a different starting point, inverting the intended specify-before-backlog conceptual flow.
Acceptance criteria
- The init "Next steps" output aligns with the docs quickstart order. Suggested bullets:
- Edit
AGENTS.md and .specflow/memory/constitution.md to describe your project.
- Open the project in Claude Code.
- Run
/specflow.specify to describe your first feature, then /backlog add for follow-up tasks.
- The docs quickstart and the CLI output are consistent — a user reading both in parallel gets the same first command.
Out of scope
- Redesigning the slash-command surface or what
/backlog does.
- Changing docs content (the docs are already correct; only the CLI output needs updating).
Notes
See src/cli/handlers/init_handler.ts (Next steps emission). Friction finding from QA reports test/qa-report-20260501-215352.md (v0.7.1) and test/qa-report-20260501-222916.md (v0.7.2) — still present in both.
Why
After
specflow init, the "Next steps" output tells users to run/backlog add "<first task title>"as their first action. The public docs quickstart atspecflow.makerlabs.devsays the first thing to do is open the project in Claude Code and run/specflow.specify. The/specflow.specifycommand is correctly scaffolded at.claude/commands/specflow.specify.md— the docs are not wrong. The init message just steers the user to a different starting point, inverting the intended specify-before-backlog conceptual flow.Acceptance criteria
AGENTS.mdand.specflow/memory/constitution.mdto describe your project./specflow.specifyto describe your first feature, then/backlog addfor follow-up tasks.Out of scope
/backlogdoes.Notes
See
src/cli/handlers/init_handler.ts(Next steps emission). Friction finding from QA reportstest/qa-report-20260501-215352.md(v0.7.1) andtest/qa-report-20260501-222916.md(v0.7.2) — still present in both.