Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/protected-head-refresh-ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,6 @@ jobs:
# candidate contracts without projecting a false reviewed authority.
- name: Verify deterministic candidate contracts
run: |
npm run agentic-sdlc:policy:check
npm run adlc:policy:check
npm run agenticrag:guidelines-map:check
npm run git-guidelines:test
6 changes: 3 additions & 3 deletions docs/documents/agentcos-tech-stack-document.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ traceability:
# Agentic OS (agentcos) — Tech Stack Document

**Context**: Solo-dev, AI-native startup. `agentcos` is the Agentic OS — the harness/orchestration plane that supervises, verifies, and delivers multiple target product repositories. First targets: `agntgrph` (knowledge-graph canvas product) and `gamexr` (game/XR product). Runtime topology: Dev (`GitHub/agntgrph`, `GitHub/gamexr`, `npm run dev`; Home Apex supervisor `npm run dev:apex`) → Prod mirrors (`GitHub/huijoohwee/content/agntgrph`, `GitHub/huijoohwee/content/gamexr`) → Delivery (`airvio.co`, `airvio.co/agntgrph`, `airvio.co/gamexr`).
**Intent**: Provide the end-to-end reference for agentcos user flow, orchestration/harness flow, workflow, and data flow — evaluated through the four compounding lenses (min-viable-max-value, TCO-zero, token economics, harness-first) and the governing Agentic SDLC execution contract (roles, budgets, gates, receipts).
**Intent**: Provide the end-to-end reference for agentcos user flow, orchestration/harness flow, workflow, and data flow — evaluated through the four compounding lenses (min-viable-max-value, TCO-zero, token economics, harness-first) and the governing ADLC execution contract (roles, budgets, gates, receipts).
**Directive**: Treat `agentic-canvas-os/docs` (Git, frontmatter-first) as the invocation and contract SSOT. Resolve `/`, `#`, `@` only through the three invocation dictionaries. Every AI pipeline runs in a typed harness with a cost log; every loop carries a max-iteration bound and circuit-breaker; every verdict comes from an Evaluator mechanism distinct from the Implementer; every promotion toward a delivered surface passes a closed-by-default Deploy Boundary.

### Reference Implementation Note
Expand Down Expand Up @@ -280,7 +280,7 @@ flowchart TB
| Memory log | `memory-log/v1` append-only shards | Durable agent history at $0 TCO | ✓ Git |
| Planning records | `todo-context-record/v2` immutable per-task records | Cross-repo planning authority | ✓ Git |
| Runtime-readiness validators | Deterministic receipt evaluators (exit-zero gates) | Fail-closed readiness derivation | ✓ Internal |
| SDLC execution contract | Orchestrator/Implementer/Evaluator/Operator roles + four bounds | Self-grade-proof verdicts; finite tasks | ✓ Internal |
| ADLC execution contract | Orchestrator/Implementer/Evaluator/Operator roles + four bounds | Self-grade-proof verdicts; finite tasks | ✓ Internal |

### Orchestration Runtime

Expand Down Expand Up @@ -500,4 +500,4 @@ Routes are **owned and declared** by the three invocation dictionaries in the in

---

*Document created 2026-08-20. Adherent to [PRD, TAD & ADR Guidelines v1.7.0](../../guidelines/prd-tad-adr-guidelines.md) and [Agentic SDLC Guidelines v1.16.0](../../guidelines/agentic-sdlc-guidelines.md); session posture per `agentic-canvas-os/docs/START-WORKFLOW.md` (authoring lane, Dev-only, deploy boundaries closed).*
*Document created 2026-08-20. Adherent to [PRD, TAD & ADR Guidelines v1.7.0](../../guidelines/prd-tad-adr-guidelines.md) and [ADLC Guidelines v1.16.0](../../guidelines/adlc-guidelines.md); session posture per `agentic-canvas-os/docs/START-WORKFLOW.md` (authoring lane, Dev-only, deploy boundaries closed).*
2 changes: 1 addition & 1 deletion docs/documents/agentic-game-os-prd-tad-adr.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ research_input_digest: "sha256:5fb8f9f4a0c4bc6d7e96866ff5224cbb46f937368f8f22bb9

# Agentic Game OS — Persistent Strategy and Shared-World Reopening — PRD/TAD/ADR

Governed by PRD, TAD & ADR Guidelines v1.7.0 (2026-07-28). The Agentic SDLC Guidelines separately own task decomposition, tool blast radius, verification, integration, and release.
Governed by PRD, TAD & ADR Guidelines v1.7.0 (2026-07-28). The ADLC Guidelines separately own task decomposition, tool blast radius, verification, integration, and release.

Status boundary: this is a spec-complete source contract. It is not an implementation receipt, protected integration result, browser result, Xcode or Simulator result, physical-device result, Production authorization, or Cloudflare deployment result. Present-tense criteria describe required behavior, not observed behavior. Every Evidence Reference remains none recorded.

Expand Down
16 changes: 8 additions & 8 deletions docs/documents/git-guidelines.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ local_rung: "spec-complete"
delivered_rung: "undocumented"
lane: "authoring"
universal_scope: false
companion_of: "guidelines/agentic-sdlc-guidelines.md"
companion_of: "guidelines/adlc-guidelines.md"
invocation_token: "/git.guidelines"
semantic_filters: ["#git-collaboration"]
bindings: ["@git-guidelines"]
Expand All @@ -23,14 +23,14 @@ This git-layer companion projects the execution set into byte-preserving, provid

| ID | Rule family | Disposition | Owner | Class |
|---|---|---|---|---|
| C1 | claim identity | consumes | [Collaboration Module](../../guidelines/agentic-sdlc-cloud-collaboration.md) | advisory |
| C2 | authority order | consumes | [Collaboration Module](../../guidelines/agentic-sdlc-cloud-collaboration.md) | advisory |
| C3 | write-scope comparison | consumes | [Collaboration Module](../../guidelines/agentic-sdlc-cloud-collaboration.md) | advisory |
| C4 | fence meaning | consumes | [Collaboration Module](../../guidelines/agentic-sdlc-cloud-collaboration.md) | advisory |
| C5 | handoff semantics | consumes | [Collaboration Module](../../guidelines/agentic-sdlc-cloud-collaboration.md) | advisory |
| C6 | additive lane admission and preservation proof | consumes | [Lane Admission Module](../../guidelines/agentic-sdlc-scoped-lane-admission.md) | advisory |
| C1 | claim identity | consumes | [Collaboration Module](../../guidelines/adlc-cloud-collaboration.md) | advisory |
| C2 | authority order | consumes | [Collaboration Module](../../guidelines/adlc-cloud-collaboration.md) | advisory |
| C3 | write-scope comparison | consumes | [Collaboration Module](../../guidelines/adlc-cloud-collaboration.md) | advisory |
| C4 | fence meaning | consumes | [Collaboration Module](../../guidelines/adlc-cloud-collaboration.md) | advisory |
| C5 | handoff semantics | consumes | [Collaboration Module](../../guidelines/adlc-cloud-collaboration.md) | advisory |
| C6 | additive lane admission and preservation proof | consumes | [Lane Admission Module](../../guidelines/adlc-scoped-lane-admission.md) | advisory |
| C7 | frontmatter, Rule_ID, findings, and readiness rungs | consumes | [Authoring Authority](../../guidelines/prd-tad-adr-guidelines.md) | advisory |
| C8 | task model, roles, independence, blast radius, and budgets | consumes | [Execution Companion](../../guidelines/agentic-sdlc-guidelines.md) | advisory |
| C8 | task model, roles, independence, blast radius, and budgets | consumes | [Execution Companion](../../guidelines/adlc-guidelines.md) | advisory |
| C9 | commit, push, and deploy command sequences | consumes | [Delivery Guidelines](../../guidelines/commit-push-deploy-guidelines.md) | advisory |
| O1 | git lane projection and branch naming | owns | — | advisory |
| O2 | coordination artifact layout and schemas | owns | — | advisory |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
---
title: "Agentic SDLC Execution Anti-Pattern Guards"
title: "ADLC Execution Anti-Pattern Guards"
doc_type: "Guideline Module"
version: "1.0.0"
date: "2026-08-27"
version: "1.1.0"
date: "2026-09-05"
lang: "en-US"
frontmatter_contract: "required"
owner: "Orchestrator function"
local_rung: "spec-complete"
delivered_rung: "undocumented"
lane: "authoring"
universal_scope: "true"
provider_neutral: "true"
universal_scope: true
provider_neutral: true
runtime_readiness_policy: "fail-closed"
lifecycle_status: "proposed"
---
Expand All @@ -21,12 +21,12 @@ lifecycle_status: "proposed"
|---|---|
| An Implementer marking its own task complete; a `done` state any role may set; a verdict derived from state the Evaluator cannot see | `verified` as the only success state, set only by an Evaluator that is a distinct mechanism, judging surfaced output only |
| Tasks invented at task-authoring time to cover behaviour the specification never stated | Every task derived from a VCC; a behaviour gap returned to the authoring loop as a specification defect |
| Picking among several equally-ready candidates by convenience, recency, or an unstated preference, with no recorded reason | Constraint satisfaction filters infeasible candidates first, outranking eliminates the dominated, and argumentation settles what remains — with the trail recorded |
| Picking among several equally-ready candidates by convenience, recency, or an unstated preference, with no recorded reason | Hard constraints gate a bounded Constraints ↔ Argumentation ↔ Outranking loop; changed evidence reopens affected checks, preserves incomparability, and records a supported choice or unresolved decision |
| Tasks dispatched with no token, iteration, wall-clock, or context bound; bounds raised mid-run to rescue a failing task | All four bounds stated before dispatch with a circuit-breaker; overruns trigger re-decomposition, not a larger bound |
| Session-wide capability grants; an agent widening its own permissions mid-task; a standing approval for irreversible operations | Narrowest sufficient class granted per task; escalation via `blocked` and re-dispatch; an explicit Operator decision per irreversible occurrence |
| Tasks that reach a mirror or delivery surface, or transmit project content outward, because it was convenient | Execution confined to the authoring lane; promotion is the Deploy Boundary's job and never a task |
| Success asserted without a named check and a recorded result; a check named after the fact to match what happened | Named check stated before dispatch, run during the task, and its result surfaced in the Implementer's own output |
| Bug fixes with no check that failed on the unfixed state; stated correctness properties with no executable property test | Failing-first witness per fix; one property test per stated property with its class named and shrinking enabled |
| Behavioral defects fixed without a failing witness; a general correctness claim unsupported by a meaningful check | A behavioral defect needs a bounded failing witness and passing result; use property tests when a general invariant and meaningful generated cases justify them |
| Long runs that cannot resume, discovering the context boundary by losing work at it | Run state persisted after every terminal transition; checkpoint before the context bound; resume from persisted state, not memory |
| Operator decisions inferred, defaulted, simulated, or accepted through a non-interactive confirmation flag because the run would otherwise stall | Absent decisions produce `blocked`; the configured interaction adapter records the exact human challenge response before the authority adapter can authorize |
| A green merge automatically deploying the current protected ref, one interaction transport treated as universal, or a release rebuilding after human approval | Protected integration emits no deployment authority; the configured interaction and authority adapters record one authenticated exact-candidate decision, and the controller deploys those reviewed bytes without rebuild |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
title: "Agentic SDLC Artifact Continuity Module"
title: "ADLC Artifact Continuity Module"
doc_type: "Guidelines Module"
version: "1.0.0"
date: "2026-08-22"
version: "1.1.0"
date: "2026-09-05"
lang: "en-US"
frontmatter_contract: "required"
owner: "Orchestrator function"
local_rung: "spec-complete"
delivered_rung: "undocumented"
lane: "authoring"
schema: "agentic-artifact-continuity/v1"
universal_scope: "true"
universal_scope: true
runtime_readiness_policy: "fail-closed"
lifecycle_status: "proposed"
---

# Agentic SDLC Artifact Continuity Module
# ADLC Artifact Continuity Module

## Scope and Ownership

Expand All @@ -24,24 +24,20 @@ Context-Intent-Directives (CID) remain joined to Role-Action-Outcome (RAO) execu
demonstration, and successor planning. It defines semantic roles and joins, never file names, directory layouts,
document products, providers, tools, storage formats, or workflow transports.

The main Agentic SDLC Guidelines own execution roles, task state, budgets, permissions, and evidence emission. The
The main ADLC Guidelines own execution roles, task state, budgets, permissions, and evidence emission. The
Specification Chain Module owns the requirements-design-tasks chain and its two coverage seams. This module owns
only the continuity envelope around that chain: CID-to-RAO coverage, companion-artifact joins, outcome evidence,
revision freshness, and feedback into a successor Context.

## Semantic Separation

CID is the policy plane. RAO is the accountable transformation plane. Artifacts carry state. Evidence records an
observation and verdict. None substitutes for another.
The shared [CID/RAO/SVO contract](./cid-guidelines.md#shared-field-contract) owns message fields across PRD, TAD,
ADR, and execution. This module adds joins, not another schema: CID frames intent and constraints, RAO assigns
transformation, SVO expresses that same action. Artifacts carry state; evidence records observations and verdicts.

| Concept | Owns | Must not own |
|---|---|---|
| **Context** | Applicability, conditions, and bounded scope | A solution, implementation mechanism, or completion claim |
| **Intent** | One desired future state | An observed result or self-issued verdict |
| **Directive** | One required constraint, safeguard, or prohibition | A provider, tool, file path, or hidden implementation choice |
| **Role** | One accountable function | A person, product identity, or mutable session identity |
| **Action** | One atomic transformation over declared inputs | Multiple independently closable transformations |
| **Outcome** | One concrete, measurable result directly produced by the Action | The verdict that the result satisfies an Intent |
| **CID/RAO/SVO fields** | Meanings owned by the shared field contract | Additional aliases or narrower local definitions |
| **Artifact** | Versioned state consumed or produced by an Action | Authority, approval, or evidence by existence alone |
| **Evidence** | A recorded observation, surface, check, result, and independent verdict | New behaviour, structure, or task scope |
| **Successor Context** | Findings, changed conditions, and the next bounded Intent | Retrospective mutation of prior Context, Outcome, or Evidence |
Expand Down Expand Up @@ -92,6 +88,7 @@ which evidence supports its result.
- Bind every consumed and produced artifact to an immutable revision or digest; forbid mutable labels as evidence of sameness
- Record derivation revisions on consumers; forbid accepting a stale join because its prose still appears plausible
- Preserve prior records and append a successor reference; forbid rewriting history to manufacture continuity
- Preserve owner-authored bytes and reconstructable history through migration; a reviewed successor may remove or replace obsolete content with exact provenance. Lossless continuity forbids silent loss, not intentional scoped cleanup

## CID-to-RAO Coverage Seam

Expand All @@ -113,7 +110,7 @@ execution vocabulary rather than creating a parallel authority model.

| Role | Atomic Action | Measurable Outcome |
|---|---|---|
| **Operator** | Authorizes one CID revision or phase transition | One exact decision reference bound to the authorized revision |
| **Operator** | Authorizes a bounded objective or exact effect | Decision reference joined to each covered revision or phase transition; exact effect identities remain bound where required |
| **Orchestrator** | Derives one bounded set of grounded RAO Steps | One acyclic graph with complete joins and declared bounds |
| **Implementer** | Executes one declared Action | Enumerated produced artifacts and recorded results |
| **Evaluator** | Evaluates one Outcome against named conditions | One independent verdict with Evidence References and findings |
Expand Down
Loading