Skip to content

Latest commit

 

History

History
34 lines (29 loc) · 2.99 KB

glossary.md

File metadata and controls

34 lines (29 loc) · 2.99 KB

Glossary

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, or owner/repo#42 for an issue of another repository. A branch starts with it (42-short-name) and a pull request says Fixes #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.

Related