The words the AI-SDLC uses, each with one plain sentence.
- AI-SDLC: the shared way of working in which an agent does the work and a person decides at two human checkpoints.
- APM: the Agent Package Manager, the tool that installs the packages into a repository.
- Artifact: a document that records the work. It is a page in the docs of a repository, such as an ADR or a discovery page. It can also be a story, bug or epic in GitHub Issues. The code is not an artifact; the tests link it to the story.
- Checkpoint Alpha: the moment a person approves a story or another document, before it is written to an issue or a page.
- Checkpoint Bravo: the moment a person reviews the pull request and merges it. The merge is the approval.
- Consumer: a repository that installs the AI-SDLC from AI.SDLC.
- Core: the package every consumer installs, with the workflow skills, the agents, the hooks and the core gates.
- Functional layer: the docs that say what a repository gives its users, in plain words.
- Gate: a check that a script runs the same way on a machine and in the workflow, and that can stop a change.
- Human checkpoint: a moment where a person decides and no script does. There are two: Checkpoint Alpha and Checkpoint Bravo.
- Grilling: the questions an agent asks, in rounds and each with a recommended answer, before it writes a story or another document.
- Handoff: a short document that lets a fresh session go on with the work after a compact.
- Internal step: a skill that other skills call and that a person does not type, such as the pre-flight.
- Issue key: the number of a GitHub issue, such as
#42, orowner/repo#42for an issue of another repository. A branch starts with it (42-short-name) and a pull request saysFixes #42. - Knowledge repository: a private repository next to the others that holds the facts about what you run, such as servers and notes. A shared file never holds such a fact.
- Pack: a package for one technology, such as .NET or Bicep, that a consumer installs when it needs it.
- Pre-flight: the local run of the pull request checks before a push.
- Private term list: the private list of names and patterns that no file of a public repository may hold. It lives in the knowledge repository and in a repository secret.
- Skill: a set of instructions an agent follows for one kind of work.
- Technical layer: the docs that say how a repository is built.
- Unit: a part of a repository that a reader looks for by name and that has its own technical page.
- Update pull request: the pull request that moves a consumer to a new release tag of AI.SDLC. The consumer opens it itself, on the branch
ai-sdlc-<tag>.
The overview says what the AI-SDLC gives a team.
- What the AI-SDLC gives a team - where these words are used.
- Complete documentation - what the two layers and a unit mean in practice.
- Index - every page of this layer.