FAQ
Do I need to know the commands?
Section titled “Do I need to know the commands?”No. Say what you want in plain language - “plan the next sprint”, “extract the spec from this code”. The commands shown throughout the docs are the explicit form for people who prefer them.
What do PRD, epic, story and acceptance criteria mean?
Section titled “What do PRD, epic, story and acceptance criteria mean?”A PRD is the product requirements - what to build and why. Epics are the big chunks of that work; stories are the small, testable pieces. Acceptance criteria are the checkable conditions that say a story is done. SDLC Studio writes them all as plain files you can read and edit.
What is the two-backlog model?
Section titled “What is the two-backlog model?”A discovery backlog holds requests (change requests and RFCs) - ideas, not committed work. A delivery backlog holds sized epics, stories and bugs. A request becomes delivery work only when refine decomposes and sizes it. See the two-backlog model.
Refine or triage - what is the difference?
Section titled “Refine or triage - what is the difference?”refine turns an accepted CR or RFC into sized delivery work (epics + stories). triage turns an untriaged issue into bugs (or closes it). Both cross a request from discovery into delivery.
Issue or bug - which do I file?
Section titled “Issue or bug - which do I file?”A bug is delivery work: a defect with a severity and a size, fixed through its Done gate. An issue is a discovery-tier report you have not yet triaged into bugs.
How is “Done” decided?
Section titled “How is “Done” decided?”Two conditions. The story’s executable acceptance criteria must pass (verify_ac runs them), and - past the two-role threshold - an independent reviewer who is not the author must sign it off. You cannot simply write Status: Done; conformance re-checks it. See executable acceptance criteria and two-role review.
Greenfield or brownfield - which path?
Section titled “Greenfield or brownfield - which path?”Greenfield is a new project: /sdlc-studio init then prd create. Brownfield is existing code: /sdlc-studio prd generate, which extracts a spec and validates it by running tests against your real implementation.
Where does it put files?
Section titled “Where does it put files?”Plain markdown under sdlc-studio/ in your project, so everything is reviewable and version-controlled - prd.md, epics/, stories/, bugs/, reviews/, and more. Generated test code goes under tests/.
Which agents does it work in?
Section titled “Which agents does it work in?”Claude Code, Cursor, OpenAI Codex, GitHub Copilot, opencode and Gemini CLI - one install covers them. It is a standard Agent Skill. See Works with your agent.
Is it an npm package or an SDK?
Section titled “Is it an npm package or an SDK?”No. It is a curl-installed Agent Skill - a folder of instructions, templates and scripts. There is nothing to import into your code, no account, and no server.
What is the sprint loop?
Section titled “What is the sprint loop?”sprint drives a prioritised batch of work along a goal ladder (triage → plan → design → done), stops when its acceptance criteria are met, and closes with a reconcile and review. Run a single rung for a checkpoint, or --goal done to take it all the way. See sprint planning.
How do I upgrade an existing project?
Section titled “How do I upgrade an existing project?”Re-run the installer, or /sdlc-studio skill-update. It is a drop-in - existing projects keep working, and the v5 workflow gates are off until you turn them on. See upgrading.