ADD Coordinator
Drive an ADD change or unit of work from the request to PRs ready for team review. Artifacts and Git are the only state.
Steps
- Discover. Inspect artifacts, code, instructions, branches, remotes and uncommitted work, then interview the user about need, scope, outcomes and constraints. Ask only for facts that you cannot find. Do not invent domain facts or decisions.
- Assign the tier. Apply the small-tier criteria and record
tierin the change README. When a criterion is unresolved, use medium. - Drive the phases. Start the artifact's single active change on a dedicated branch. Apply the PO skill for Requirement, then the TL skill for Specification and Plan in one capable session. Small: one knowledge commit. Medium and large: one commit per phase and a unit brief.
- Get approval. Medium and large: present the plan, open claims first, and wait for explicit approval, which also confirms the compatibility level. Small: the user's request is the approval. Silence is not approval. A new plan or a material change needs new approval.
- Gate. Dependent implementation waits until required upstream versions are established and internal prerequisites satisfy their DoD.
- Implement. Give each independent task to an implementer in a new context with the task path, governing paths and DoD. Each parallel worker uses its own worktree and branch. Keep knowledge edits under your control. Integrate commits and run combined checks.
- Version. Compute the number from the confirmed level and the protected
current_version. Add the version record, update the identity record, push and open linked PRs. Stop for team review and merge.
Never commit to main or master, merge PRs or deploy. Send each blocker to its owner: requirement gaps to the PO, contract gaps to Specification, task gaps to Plan, code defects to Implementation.
Self-check
- KISS: the scope and plan are the smallest that meet the need.
- KISS: no new state, registry, gate or unused option.
- STE: one instruction or fact in each sentence, in active voice.
- STE: each term has one meaning, and each fact is written once.
- STE: the text changes no technical meaning.
- The validator, when available, reports
ok: truefor the change. - Tier, approval and upstream establishment come from evidence, not assumption.
Read the full kiss and asd-ste-100 skills in ../../../required-skills/ when this checklist does not settle a case.
Read when
| Condition | Read |
|---|---|
| You start, resume, lose context, or a required skill is missing | Load and resume |
| You identify repositories, artifacts or the knowledge layout | Context, artifact model |
| A change is small, or you check its tier | Change tiers, minimal change, small changes |
| Work uses upstream contracts, or you check the task graph | Gates |
| You dispatch implementers or integrate their work | Implementation, working with AI |
| You prepare a version, open PRs, or a repository has no remote | Publication |
| A unit brief is required | Units of work |
| The change affects system journeys | System flows |
| You assess what a change can reach | Change impact |
| A change adds a table, diagram or derived view | Representations |
| A decision, assumption or limit is consequential | Claims |
| Checks run across branches or repositories | Continuous integration |
| A PR of a change merged | After merge |
| The protected branch moved after you prepared the version record | Renumber |
| After plan approval, knowledge is wrong, a claim is refuted or the scope changes | Amendment |
| The owner withdraws or pauses a change | Stop |
| An established version has a defect or must be undone | Reverse |
| A DoD item needs a live harness, a running interface or a relaxed permission | Live check |
| A required check fails | Failed check |