create-agdf 0.14.5 → 0.20.0

package/generated/plugins/copilot/agdf/control/README.md

@@ -0,0 +1,125 @@
+# AGDF Control Scaffold
+
+AGDF is primarily a control system for AI-assisted delivery. The skills guide the agent during a run; these files make the run state durable in a repository.
+
+Use this scaffold when a target repository should keep AGDF state outside chat history and tool memory.
+
+## Files
+
+| File | Purpose |
+|---|---|
+| `config.json` | Project language preference for generated AGDF artefacts and user-facing chat |
+| `templates/RUN_STATE.md` | Canonical version-2 template for isolated per-run state |
+| `templates/AGDF_RUN.md` | Legacy migration-input and compatibility-projection template |
+| `templates/MASTER_BACKLOG.md` | Template for the living backlog pointer: active initiatives and current UR/Brownfield/PRD/SD/TP/QA/OR artefacts |
+| `templates/artefacts/UR.md` | Template for the durable user requirement artefact of a work item |
+| `templates/artefacts/BROWNFIELD_REVIEW.md` | Template for the durable Brownfield Review and Mode/Slice Decision |
+| `templates/artefacts/VERIFIED_CHANGE.md` | Compact fail-closed record for an eligible Verified Change |
+| `templates/artefacts/PRD.md` | Template for the durable product requirements artefact |
+| `templates/artefacts/SD.md` | Template for the durable solution design artefact |
+| `templates/artefacts/TP.md` | Template for the durable task and test plan artefact |
+| `templates/artefacts/QA_REPORT.md` | Template for the durable QA decision report |
+| `templates/artefacts/OR.md` | Template for the durable Orchestration Report closeout |
+| `templates/SOT_REGISTRY.md` | Template for the source-of-truth registry: one primary owner per domain |
+| `templates/CONTEXT_GRAPH.md` | Template for project memory: durable decisions, Brownfield findings, risks, evidence and exit criteria |
+| `templates/AGENT_QUALITY_CONTRACTS.json` | Template for machine-readable warning, revise and block contracts for review and QA |
+
+## Recommended Target Layout
+
+```text
+.agdf/
+  control/
+    runs/
+      <run_id>/
+        RUN_STATE.md
+    config.json
+    AGDF_RUN.md
+    MASTER_BACKLOG.md
+    artefacts/
+      <work-item>/
+        UR.md
+        BROWNFIELD_REVIEW.md
+        PRD.md
+        SD.md
+        TP.md
+        QA_REPORT.md
+        OR.md
+    SOT_REGISTRY.md
+    CONTEXT_GRAPH.md
+    AGENT_QUALITY_CONTRACTS.json
+```
+
+Keep these files small and reviewable. They are control artefacts, not a second documentation site.
+
+Create the live files with:
+
+```bash
+npx --yes @agdf/cli@latest init
+```
+
+If only the project language preference is missing or should change after plugin installation, write just the config file:
+
+```bash
+npx --yes @agdf/cli@latest config --language en
+```
+
+Then check whether the live state is actionable:
+
+```bash
+agdf doctor
+agdf doctor --json
+agdf gate-check --json
+```
+
+`doctor` does not replace agent judgment. It catches basic control failures: missing live files, missing current gate, missing next allowed action, empty evidence, empty backlog pointer, empty source-of-truth registry, duplicate active SoT rows and invalid quality contracts.
+`gate-check` consumes the doctor result and live run state to report whether the next process step is `open` or `blocked`.
+
+## Operating Rules
+
+- Canonical mutable state is isolated per run at `runs/<run_id>/RUN_STATE.md`. Run discovery is
+  derived; do not maintain a writable active-run index. When several runs are active, discovery
+  presents the most recently updated run first and lists the others, but requires an explicit run
+  selection for read-only status or explicit run-selection requests. Implementation intake first
+  provides canonical UR evidence to the coding agent for scope assignment, even with one active
+  run: resume one same-scope continuation, start a new UR run for an independent scope, or clarify
+  genuinely overlapping work. If no active run exists during a status request, ask whether to start
+  one or do something else. Status never creates a run. `updated_at` is recorded with
+  every canonical run write; older runs use file modification time until their next recorded update.
+- Migrate legacy state explicitly with `run-migrate`; read-only commands never migrate. A retained
+  `AGDF_RUN.md` is migration input or a non-authoritative projection, not a second writable owner.
+- A run created by `run-create` is sealed. Record every change to it or to a listed artefact with
+  `run-update`, and record exact gate replies only with `run-approve`; an unrecorded edit blocks
+  `doctor` and `gate-check` until it is recorded.
+  If a run lists its own `RUN_STATE.md`, the seal covers its body directly and uses a self-reference
+  marker for that artefact entry. This avoids circular on-disk hashing; references to other runs
+  remain fully hashed. Old self-reference failures require a verified restoration, never a blind re-seal.
+- Record the standard small-path steps with one `run-step` call each instead of editing the run state
+  and `MASTER_BACKLOG.md` by hand: `--step ur --title` after writing `artefacts/<run_id>/UR.md`;
+  `--step route --route <mode> --reason --evidence` after writing `BROWNFIELD_REVIEW.md`;
+  `--step evidence` for test or check results; `--step review --decision --evidence` for Code Review;
+  and `--step closeout --result --evidence --risk --next` to close a `quick_task` with OR-lite. Each
+  call maintains the tables, the backlog pointer and the next allowed action and prints the next step.
+
+- The selected `runs/<run_id>/RUN_STATE.md` is the current run dashboard.
+- `config.json` stores the project preference for artefact and chat language; runtime rules stay English.
+- `MASTER_BACKLOG.md` points to active delivery work; detailed artefacts live beside the work item.
+- Brownfield Review records the post-UR Mode/Slice Decision before PRD depth, Verified Change execution or Quick Task execution is chosen.
+- UR, PRD, SD, TP and QA decisions require durable artefacts or links to the authoritative repository source of truth before the next gate can open.
+- OR records the run closeout and next permissible step; it does not approve later gates.
+- `SOT_REGISTRY.md` decides which document owns which domain.
+- `CONTEXT_GRAPH.md` records durable project knowledge only when it has evidence and an exit criterion.
+- `AGENT_QUALITY_CONTRACTS.json` names reusable block, revise and warning conditions.
+- Never assign `merge=union` to canonical `runs/<run_id>/RUN_STATE.md` records. Concurrent edits to the
+  same run must remain conflict-visible; independent runs naturally change different files. After a
+  merge or pull, rerun `doctor` and `gate-check` for the selected run.
+
+Do not duplicate full product documentation in this scaffold. Link to the authoritative artefact instead.
+
+## Planned outputs during recovery
+
+A missing file explicitly declared `missing` or `pending` under the selected run's own
+`.agdf/control/artefacts/<run_id>/` directory is a planned output, not lost completed evidence.
+Recovery retains its path and absence in the integrity snapshot and leaves its status pending.
+It does not create evidence or approve a gate. Completed or ready evidence, unsafe paths and
+descriptive placeholders still require repair. Creating a planned file after a recovery preview
+invalidates that preview; creating it after recovery changes the seal until a canonical update.

package/generated/plugins/copilot/agdf/control/templates/AGDF_RUN.md

@@ -0,0 +1,139 @@
+# AGDF Run State
+
+## Run Meta
+
+- run_id:
+- started_at:
+- mode: `quick_task | verified_change | structured_delivery`
+- current_gate: `none | UR | Brownfield Review | Mode/Slice Decision | PRD | SD | TP | Quick Task Execution | Verified Change Execution | Brownfield Analysis | CD+Tests | CR | QA | UAT | OR`
+- decision: `pass | revise | block | in_progress`
+- owner:
+
+## Objective
+
+What outcome is this run trying to make trustworthy?
+
+## Current Control State
+
+| Question | Answer |
+|---|---|
+| What is known? |  |
+| What is approved? |  |
+| What is missing? |  |
+| What is the next allowed action? |  |
+| What is explicitly forbidden right now? |  |
+
+## Source And Scope State
+
+- normative_instruction_source:
+- multi_scope_state: `clear | ambiguous | blocked`
+- active_scope_evidence:
+- competing_scope_lines:
+- branch_workspace_evidence:
+- branch_workspace_scope_effect: `supports | conflicts | insufficient | not_checked`
+
+## Run Status Card
+
+This is a compact projection of the control state. It does not replace gate-check, QA, OR or approvals.
+
+| Run status | Value |
+|---|---|
+| Status |  |
+| Current gate |  |
+| Allowed now |  |
+| Blocked by |  |
+| Missing approval |  |
+| Next step |  |
+| Quality outlook |  |
+
+## Approvals
+
+Valid approval format for new runs: `Approval: <GateName>`.
+
+| Gate | Status | Evidence |
+|---|---|---|
+| UR | `missing | approved | not_applicable` |  |
+| PRD | `missing | approved | not_applicable` |  |
+| SD | `missing | approved | not_applicable` |  |
+| TP | `missing | approved | not_applicable` |  |
+| QA | `missing | approved | not_applicable` |  |
+| UAT | `missing | approved | not_applicable` |  |
+
+## Artefacts
+
+| Type | Path | Status | Notes |
+|---|---|---|---|
+| UR |  | `draft | approved | superseded | not_applicable` |  |
+| PRD |  | `draft | approved | superseded | not_applicable` |  |
+| SD |  | `draft | approved | superseded | not_applicable` |  |
+| TP |  | `draft | approved | superseded | not_applicable` |  |
+| Brownfield Review |  | `missing | draft | done | not_applicable | superseded` |  |
+| Verified Change |  | `missing | draft | eligible | executed | escalated` |  |
+| Review |  | `missing | done | not_applicable` |  |
+| QA |  | `missing | pass | revise | block | not_applicable` |  |
+| OR |  | `missing | done | not_applicable` |  |
+
+## Mode / Slice Decision
+
+Set this after Brownfield Review. Do not assume the full gate chain before the existing-system impact is understood.
+Quick Task execution or implementation is not allowed until this decision is visible with scope reason and evidence.
+
+- decision: `undecided | quick_task | verified_change | structured_slice | structured_delivery | block`
+- required_next_gate: `none | PRD | SD | TP | Brownfield Analysis`
+- scope_reason:
+- evidence:
+- transparency_note:
+
+## Artefact Chain
+
+Keep the active work item traceable. A gate may open only when the previous gate has both exact approval and a durable or linked artefact.
+
+| From | Relationship | To | Evidence |
+|---|---|---|---|
+| UR | `approved_by` | `Approval: UR` |  |
+| PRD | `derived_from` | UR |  |
+| SD | `derived_from` | PRD |  |
+| TP | `derived_from` | SD |  |
+| QA_REPORT | `tests` | TP |  |
+
+## Evidence
+
+| Evidence | Source | Covers | Strength |
+|---|---|---|---|
+|  |  |  | `direct | indirect | weak` |
+
+## Missing Evidence
+
+| Missing evidence | Impact | Required next step |
+|---|---|---|
+|  | `warn | revise | block` |  |
+
+## Risks
+
+| Risk | Impact | Mitigation or owner |
+|---|---|---|
+|  | `warn | revise | block` |  |
+
+## Context Graph Impact
+
+- context_graph_impact: `none | link_only | update_existing_node | new_node_required | sot_drift`
+- context_graph_refs:
+- context_graph_reconciliation: `resolved | not_applicable | open_gap`
+- context_graph_required_action: `none | link | update | create | resolve_drift`
+- context_graph_gate_effect: `none | warning | revise | block`
+- context_graph_evidence:
+
+## Knowledge Persistence Decision
+
+- memory_target: `context_graph | sot_registry | scope_artifact | open_questions | none`
+- memory_reason:
+- memory_refs:
+
+## Closeout
+
+- delivered:
+- not_delivered:
+- verification_performed:
+- unverified:
+- next_allowed_action:
+- quality_outlook:

package/generated/plugins/copilot/agdf/control/templates/AGENT_QUALITY_CONTRACTS.json

@@ -0,0 +1,126 @@
+{
+  "schema_version": "1",
+  "updated_at": "",
+  "contracts": [
+    {
+      "code": "AGDF_GATE_BYPASS",
+      "category": "agent_process",
+      "impact": "block",
+      "title": "Gate bypass",
+      "description": "A later artefact or implementation was produced without the required exact approval.",
+      "applies_to_modes": ["structured_delivery"],
+      "gate_effect": ["prd", "sd", "tp", "qa", "uat"],
+      "required_evidence": ["approval_log", "artifact_status"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_QA_WITHOUT_TASK_PLAN_REVIEW",
+      "category": "agent_process",
+      "impact": "block",
+      "title": "QA without task-plan review",
+      "description": "QA is evaluated for Structured Delivery without prior task-plan coverage evidence.",
+      "applies_to_modes": ["structured_delivery"],
+      "gate_effect": ["qa"],
+      "required_evidence": ["task_plan_review"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_PARALLEL_SOT",
+      "category": "architecture_integrity",
+      "impact": "block",
+      "title": "Parallel source of truth",
+      "description": "A second source of truth was introduced for product intent, runtime behavior, visible state, policy or persistent domain data.",
+      "applies_to_modes": ["structured_delivery", "quick_task"],
+      "gate_effect": ["prd", "sd", "tp", "qa"],
+      "required_evidence": ["brownfield_analysis", "source_of_truth_reference"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_DOC_IMPACT_UNCHECKED",
+      "category": "doc_spec_drift",
+      "impact": "revise",
+      "title": "Documentation or SoT impact unchecked",
+      "description": "A behavior, architecture, API, UX, policy or runtime change was completed without checking the affected source-of-truth artefacts.",
+      "applies_to_modes": ["structured_delivery", "quick_task"],
+      "gate_effect": ["qa"],
+      "required_evidence": ["sot_impact_review"],
+      "evaluation": "review",
+      "owner": "docs"
+    },
+    {
+      "code": "AGDF_TEST_SCOPE_UNCLEAR",
+      "category": "tp_coverage",
+      "impact": "revise",
+      "title": "Test scope unclear",
+      "description": "Tests were cited but are not traceable to affected acceptance criteria, tasks or risk paths.",
+      "applies_to_modes": ["structured_delivery", "quick_task"],
+      "gate_effect": ["qa"],
+      "required_evidence": ["test_result", "acceptance_mapping"],
+      "evaluation": "review",
+      "owner": "test"
+    },
+    {
+      "code": "AGDF_QUICK_TASK_EVIDENCE_LIGHT",
+      "category": "agent_process",
+      "impact": "warn",
+      "title": "Quick task evidence light",
+      "description": "A Quick Task has minimal evidence that may be acceptable for scope and risk but must remain visible.",
+      "applies_to_modes": ["quick_task"],
+      "gate_effect": ["none"],
+      "required_evidence": ["closeout_note"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_SCOPE_AMBIGUOUS",
+      "category": "agent_process",
+      "impact": "revise",
+      "title": "Ambiguous active scope",
+      "description": "Multiple active work lines are plausible and the agent must not choose one silently.",
+      "applies_to_modes": ["structured_delivery", "quick_task"],
+      "gate_effect": ["ur", "prd", "sd", "tp", "qa"],
+      "required_evidence": ["competing_scope_lines", "active_scope_evidence"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_BRANCH_NOT_SCOPE_PROOF",
+      "category": "agent_process",
+      "impact": "warn",
+      "title": "Branch or workspace is not scope proof",
+      "description": "Branch names and workspace deltas may support a scope only when they do not conflict with durable artefacts or approvals.",
+      "applies_to_modes": ["structured_delivery", "quick_task"],
+      "gate_effect": ["ur", "prd", "sd", "tp", "qa"],
+      "required_evidence": ["branch_workspace_evidence", "artefact_status"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_MEMORY_TARGET_MISSING",
+      "category": "agent_process",
+      "impact": "warn",
+      "title": "Knowledge persistence decision missing",
+      "description": "A relevant run ended without deciding whether new durable knowledge belongs in the Context Graph, SoT registry, scope artefact, open questions or nowhere.",
+      "applies_to_modes": ["structured_delivery", "quick_task"],
+      "gate_effect": ["or"],
+      "required_evidence": ["memory_target", "memory_reason"],
+      "evaluation": "review",
+      "owner": "governance"
+    },
+    {
+      "code": "AGDF_BUG_LIGHTWEIGHT_SCOPE_UNEVIDENCED",
+      "category": "scope_control",
+      "impact": "revise",
+      "title": "Bug Lightweight Track lacks bug evidence",
+      "description": "A lightweight defect path requires durable reproduction, actual behavior, expected behavior, fix boundary, open questions and evidence plan.",
+      "applies_to_modes": ["quick_task"],
+      "gate_effect": ["qa"],
+      "required_evidence": ["bug_artifact_or_issue", "reproduction", "expected_behavior", "evidence_plan"],
+      "evaluation": "review",
+      "owner": "governance"
+    }
+  ]
+}

package/generated/plugins/copilot/agdf/control/templates/CONTEXT_GRAPH.md

@@ -0,0 +1,51 @@
+# AGDF Context Graph
+
+This file keeps durable delivery knowledge discoverable. It is not a second PRD, SD or task plan.
+
+## Admission Rules
+
+A node belongs here only when it has:
+
+- concrete evidence
+- affected artefacts or paths
+- a visible risk, decision, invariant or reusable Brownfield finding
+- a next clean step
+- an exit criterion
+
+Do not add nodes for general opinions, one-off chat summaries or local observations without future decision value.
+
+## Node Index
+
+| ID | Type | Status | Title | Evidence | Next Step |
+|---|---|---|---|---|---|
+| CG-001 | `decision | brownfield_finding | quality_node | sot_invariant | cleanup_obligation | integration_surface` | `draft | active | resolved | superseded | rejected` |  |  |  |
+
+## Relationship Language
+
+| Relationship | Meaning |
+|---|---|
+| `derived_from` | An artefact was derived from another artefact |
+| `satisfies` | A task or implementation satisfies a requirement or acceptance criterion |
+| `tests` | A test checks a criterion or risk |
+| `mitigates` | Evidence reduces a risk |
+| `depends_on` | A decision or artefact depends on another |
+| `changes` | A requirement changes a component, artefact or behavior |
+| `supersedes` | A newer artefact replaces an older basis |
+| `blocks` | A defect or risk blocks a gate |
+| `approved_by` | An artefact was approved by a gate |
+| `evidenced_by` | A claim is backed by evidence |
+
+## Nodes
+
+### CG-001 Example
+
+- type:
+- status:
+- title:
+- introduced_by:
+- affects:
+- evidence:
+- risk_or_value:
+- next_clean_step:
+- exit_criterion:
+- links:

package/generated/plugins/copilot/agdf/control/templates/MASTER_BACKLOG.md

@@ -0,0 +1,39 @@
+# AGDF Master Backlog
+
+This file is the living control pointer for active AGDF delivery work. Detailed UR, Brownfield Review, PRD, SD, TP, QA and OR artefacts should live in stable paths and be linked from here.
+
+## Rules
+
+1. New product semantics, functional change or user-visible behaviour change starts as a new UR draft in a stable local artefact path, for example `.agdf/control/artefacts/<key>/UR.md`, unless an authoritative repository SoT already exists and is linked here.
+2. `Approval: UR` adds or updates exactly one steering row with a document-relative Markdown link to the UR.
+3. Brownfield Review is created for the same work item after UR approval when existing-system impact must be sized before PRD depth or Quick Task execution.
+4. PRD, SD, TP and QA report artefacts are created for the same work item after the previous gate is approved and persisted or linked.
+5. `Approval: PRD`, `Approval: SD`, `Approval: TP` and `Approval: QA` require the corresponding durable artefact or linked repository SoT before the next gate can open.
+6. Generic consent such as "ok", "go ahead", "do it", "continue", "leg los" or "approved" does not update a gate. Only `Approval: <GateName>` does.
+7. Keep only steering-relevant work in `Active Backlog`.
+8. Every active item has exactly one linked current spec and a visible linked artefact chain.
+9. Historical artefacts remain linkable but do not override the current pointer.
+10. If an item is superseded, mark the replacement.
+11. If active work grows beyond roughly ten items, triage the backlog.
+12. `Status` must be one of the human-readable labels normalized by `packages/core/lib/control-evaluation/shared.js`: Needs UR, Awaiting Brownfield Review, Awaiting PRD, Awaiting PRD Approval, Awaiting SD, Awaiting SD Approval, Awaiting TP, Awaiting TP Approval, In Progress, Blocked, Awaiting QA, Awaiting UAT, Awaiting OR, Completed, Superseded, Abandoned. Generated observations also use Work pending, Approval pending, QA report pending, QA evidence open, QA correction open, QA source decision required, QA blocked, Source unconfirmed, Closeout pending, Unconfirmed, and phase-specific Brownfield Analysis/CD+Tests/CR/Quick Task Execution/Verified Change Execution/Mode/Slice Decision work pending. The parser module is authoritative; this list only mirrors it for readability.
+13. `Artefacts` link labels must be one of the labels normalized by the same parser module: `ur`, `brownfield`, `prd`, `sd`, `tp`, `qa`, `or` (case-insensitive). Do not invent other labels such as a raw artefact filename.
+14. After writing or updating this file, run `doctor --json` (or the locally available equivalent) and resolve any `AGDF_BACKLOG_STATUS_UNKNOWN` or `AGDF_BACKLOG_ARTEFACT_LABEL_UNKNOWN` finding before treating the edit as done.
+15. A `Work item` cell may optionally start with a bracketed scope tag, one of `[framework-maintenance]` or `[external-delivery]`, so the split between AGDF's own maintenance work and external product delivery stays visible at a glance. The tag is never required retroactively on `Completed / Superseded Pointers` rows. `packages/core/lib/control-evaluation/shared.js` is authoritative for the accepted values.
+16. After writing or updating this file, also resolve any `AGDF_BACKLOG_SCOPE_LABEL_UNKNOWN` finding, which fires only for a present-but-unrecognized bracketed tag, never for an absent one.
+
+17. Core writers may place a bounded `agdf-backlog-summary-v1` comment after a complete table, separated by a blank line. It records the addressed row, target, actual Run revision, observation time and consumed source digests; it never authorizes. Preserve it with its row. Older rows remain readable without it. Invalid/foreign/ambiguous observations remain visibly unconfirmed; reading does not synchronize or scan all Runs.
+
+## Active Backlog
+
+| Priority | Key | Work item | Status | Artefacts | Current spec | Next step |
+|---:|---|---|---|---|---|---|
+
+## Planned / Parking Lot
+
+| Priority | Key | Work item | Status | Artefacts | Current spec | Next step |
+|---:|---|---|---|---|---|---|
+
+## Completed / Superseded Pointers
+
+| Key | Work item | Final status | Historical record | Outcome |
+|---|---|---|---|---|

package/generated/plugins/copilot/agdf/control/templates/RUN_STATE.md

@@ -0,0 +1,93 @@
+# AGDF Run State
+
+## Run Meta
+
+- control_state_version: 2
+- run_id:
+- lifecycle: active
+- revision: 1
+- revision_id:
+- updated_at:
+- mode: structured_delivery
+- current_gate: UR
+- decision: in_progress
+- owner: agent
+
+## Objective
+
+Describe the trustworthy outcome.
+
+## Current Control State
+
+| Question | Answer |
+|---|---|
+| What is known? |  |
+| What is approved? |  |
+| What is missing? |  |
+| What is the next allowed action? |  |
+| What is explicitly forbidden right now? |  |
+
+## Approvals
+
+| Gate | Status | Evidence |
+|---|---|---|
+| UR | missing |  |
+| PRD | missing |  |
+| SD | missing |  |
+| TP | missing |  |
+| QA | missing |  |
+| UAT | missing |  |
+
+## Artefacts
+
+| Type | Path | Status | Notes |
+|---|---|---|---|
+| UR |  | draft |  |
+| Brownfield Review |  | missing |  |
+| Verified Change |  | missing |  |
+| PRD |  | missing |  |
+| SD |  | missing |  |
+| TP |  | missing |  |
+| Brownfield Analysis |  | missing |  |
+| CD+Tests |  | missing |  |
+| CR |  | missing |  |
+| QA |  | missing |  |
+
+## Mode/Slice Decision
+
+- decision: `quick_task | verified_change | structured_slice | structured_delivery | block`
+- required_next_gate:
+- scope_reason:
+- evidence:
+
+## Parent Reconciliation Handoff
+
+Optional. Omit this section when no explicit `OR | reconciles_with | parent_run:<run_id>` Artefact
+Chain row exists. The relationship row owns the Parent ID and evidence; do not copy them here.
+
+- parent_reconciliation_disposition: `action_required | accepted_open`
+- parent_reconciliation_next_action:
+
+## Programme Aggregation Readiness
+
+Optional. Use only on an explicit Parent/programme run with evidenced
+`Aggregate | includes | child_run:<run_id>` rows.
+
+- programme_acceptance_ref:
+- programme_aggregation_evidence:
+- programme_aggregation_missing_evidence: `none`
+
+## Artefact Chain
+
+| From | Relationship | To | Evidence |
+|---|---|---|---|
+
+## Evidence
+
+| Evidence | Source | Covers | Strength |
+|---|---|---|---|
+
+## Closeout
+
+- next_allowed_action: Draft the current allowed artefact and preserve evidence.
+- quality_outlook: Keep one mutable authority for this run.

package/generated/plugins/copilot/agdf/control/templates/SOT_REGISTRY.md

@@ -0,0 +1,25 @@
+# AGDF Source-of-Truth Registry
+
+Use this file to prevent parallel sources of truth. Each domain should have one primary owner.
+
+## Primary Sources of Truth
+
+| Domain | SoT Document | Status | Owner | Last Verified |
+|---|---|---|---|---|
+| Product intent |  | `active | draft | superseded` |  |  |
+| Architecture |  | `active | draft | superseded` |  |  |
+| Runtime contracts |  | `active | draft | superseded` |  |  |
+| UX / user flows |  | `active | draft | superseded` |  |  |
+| Operations / release |  | `active | draft | superseded` |  |  |
+
+## Secondary References
+
+Secondary references may support decisions, but they do not override the primary SoT.
+
+| Reference | Purpose | Limit |
+|---|---|---|
+|  |  |  |
+
+## Conflict Rule
+
+When a secondary document, generated output, old snapshot or chat summary conflicts with the primary SoT, the primary SoT wins until a new approved artefact changes it.