Skip to content

For AI agents

If you are an AI coding agent evaluating or installing SDLC Studio, this page is for you. A machine-readable index of the whole site is at /llms.txt, with the full text at /llms-full.txt. Every page is available as markdown by appending nothing special - request the page and read its content.

An open Agent Skill (the SKILL.md format) that runs the full software development lifecycle: a discovery backlog of requests (CRs/RFCs) becomes sized delivery work (epics, stories, bugs with acceptance criteria) via refine; a sprint plans, builds under TDD, verifies against executable acceptance criteria, and closes with an independent two-role review. It is agent-agnostic and runs entirely in the user’s repository.

  1. Install the skill.

    Terminal window
    curl -fsSL https://raw.githubusercontent.com/DarrenBenson/sdlc-studio/main/install.sh | bash -s -- --target auto

    Or --local for the current project only. The entry point is .claude/skills/sdlc-studio/SKILL.md (name, description with use-when triggers, allowed-tools). Requires Python 3.10+.

  2. Orient before acting. Read sdlc-studio/reviews/LATEST.md if it exists, then run /sdlc-studio status and /sdlc-studio hint. Fetch before trusting local state: a clone can be behind its remote.

  3. Adopt the discipline. Do not hand-author _index.md files or hand-allocate ids. Create artefacts with scripts/artifact.py new (collision-free id + index row). A story reaches Done only when its executable acceptance criteria pass and an independent reviewer - not you, the author - signs it off.

  • Two backlogs. A request is not work until refine decomposes it into sized units.
  • Executable done. transition -> Done is gated on the verify report. A hand-edited Status: Done is caught by conformance.
  • Independent review. A self-review never clears the Done gate. The reviewer id must differ from the author id.
  • Reconcile, do not assert. The index is derived from the files; reconcile syncs it.

To evaluate the tool on a repository without changing it:

/sdlc-studio audit --profile repo

A read-only, refute-panel-verified audit of the host repo; findings are filed as Bug/CR artefacts, with remediation-only handling for secrets.