# AWP Specifications Index **Status:** **REFERENCE MATERIAL — target-state specification baseline** **Authority:** these specs are reference, not the binding implementation set. See below. **Browse:** markdown is canonical; run `pnpm docs:serve` and open [`view.html?doc=INDEX.md`](view.html?doc=INDEX.md) for the rendered viewer. See [`../README.md`](../README.md). ## Source-of-Truth Rule ```text BINDING (read in full before implementing) adr/*.md the 9 ADRs ../plans/I0-I1-AUTHORITY.md distilled implementation digest ../../GOLIVE.md repo-root go-live journey ../plans/AWP-PAIN-INVARIANTS.md pain chains -> design invariants ../plans/AWP-GOVERNANCE-AMENDMENT-2026-08-21.md REFERENCE (consult for the surface you are touching) every other document indexed below, and everything under ../plans/ PRECEDENCE ADRs + I0-I1-AUTHORITY.md win over any reference spec the governance amendment wins over any clause it names a reference spec governs only where nothing above speaks ``` This index is a **map, not a census.** It deliberately states no document count: counts drift the moment a spec is added, and a stale number is worse than no number. If a file exists under `docs/specs/` it is part of the baseline whether or not it is listed here; if it is listed and missing, the file is authoritative about its own absence. Reference specs are not deprecated and not stale by default. They remain the detailed authority for the surfaces they govern. What changed on 2026-08-21 is that no agent is expected to have read all of them before starting work. **Related entry points:** [`../VISION.md`](../VISION.md) · [`../VISION-EXTENSIONS-2026-08-20.md`](../VISION-EXTENSIONS-2026-08-20.md) · [`../plans/INDEX.md`](../plans/INDEX.md) · [`../mockups/i1/README.md`](../mockups/i1/README.md) ## Governing Rule AWP uses **full-specification-first, incremental-realization, reuse-before-build**. ```text complete target architecture/domain/workflow/UI/schema intent -> linked Markdown + Decisions/ADRs -> explicit I0..I9 realization boundary -> exact project-native / Platform / Overdeck / native / standard / FOSS disposition -> owner-approved deterministic high-fi for the user-facing increment -> incremental implementation and dogfood ``` A later increment means deferred implementation, not undefined intent. Code does not silently supersede the specification. ## Canonical Product Corrections ```text ProjectVision != Goal != Plan GOLIVE is not a primitive; go-live is a Goal use case. hard Task dependency A -> B => B cannot dispatch before A is satisfied => manual Queue priority cannot make that ordering legal Queues Queue view = ordering/readiness/blocker explanation Graph view = compound directed dependency graph Plan groups + Task nodes + prerequisite -> dependent edges Project Overview Current Goals / Attention / Blockers Active Plans / FactoryRuns / Recently Completed Queue / Next Up: Now / Next / Later / Waiting / Blocked ``` ## Specification Site The baseline spans architecture, ADRs, domains, workflows, UI/IA and schema families. Markdown is the canonical and only source; the viewer at `view.html?doc=.md` is a rendering convenience. The specification-completeness gate is **GREEN**. Remaining red items are implementation/source/runtime/security evidence gates, not undefined target behavior — and per the 2026-08-21 governance amendment, those gates are GOLIVE work items rather than start-work blockers. ## Architecture - [Architecture Principles](architecture/principles.md) - [Deployment Topology](architecture/deployment-topology.md) - [Domain Model](architecture/domain-model.md) - [Module Boundaries](architecture/module-boundaries.md) - [Transport and Contracts](architecture/transport-and-contracts.md) - [Persistence and Transactions](architecture/persistence-and-transactions.md) - [Durable Execution](architecture/durable-execution.md) - [Durable Workflow / Transaction Seam](architecture/durable-workflow-transaction-seam.md) - [Events, Audit, Realtime and Telemetry](architecture/event-audit-realtime.md) - [Security and Trust](architecture/security-and-trust.md) - [Configuration and Policy](architecture/configuration-and-policy.md) - [Integrations and Connections](architecture/integrations-and-connections.md) - [Workspace Execution](architecture/workspace-execution.md) - [Adapter Contracts](architecture/adapter-contracts.md) - [CI and Runner Boundary](architecture/ci-and-runner-boundary.md) - [Release and Deployment Boundary](architecture/release-and-deployment-boundary.md) - [Reliability Boundary](architecture/reliability-boundary.md) - [Engineering Practices R1–R5](architecture/engineering-practices.md) - [Platform, FOSS and Proven-Capability Reuse](architecture/platform-reuse.md) - [Control Surfaces — UI/API/aw* CLI/MCP](architecture/control-surfaces.md) - [Advisory Agents](architecture/advisory-agents.md) - [Search and Command Palette](architecture/search-and-command-palette.md) ## Architecture Decisions - [ADR 0001 — Three-Plane Control Topology](adr/0001-control-plane-and-three-plane-topology.md) - [ADR 0002 — Modular Monolith](adr/0002-modular-monolith.md) - [ADR 0003 — Hono Transport](adr/0003-hono-transport.md) - [ADR 0004 — PostgreSQL + Drizzle](adr/0004-postgresql-drizzle.md) - [ADR 0005 — DBOS Durable Workflows](adr/0005-dbos-durable-workflows.md) - [ADR 0006 — Native Kubernetes Workspace](adr/0006-native-kubernetes-workspace.md) - [ADR 0007 — GitHub Actions + ARC](adr/0007-github-actions-arc-ci.md) - [ADR 0008 — Helm + Server-Side Apply](adr/0008-helm-server-side-apply-deployment.md) - [ADR 0009 — Authentication and Session](adr/0009-authentication.md) ## Domains - [Projects](domains/projects.md) - [Goals](domains/goals.md) - [Repositories / VCS](domains/repositories-vcs.md) - [Planning](domains/planning.md) - [Work](domains/work.md) - [Work Queue / Dispatch](domains/work-queue.md) - [Changes](domains/changes.md) - [Reviews](domains/reviews.md) - [Factory](domains/factory.md) - [Agents](domains/agents.md) - [Advisory Personas](domains/advisory-personas.md) - [Accounts, Models and Providers](domains/accounts-models-providers.md) - [Integrations and Connections](domains/integrations-connections.md) - [CI](domains/ci.md) - [Verification](domains/verification.md) - [Artifacts and Provenance](domains/artifacts-provenance.md) - [Releases](domains/releases.md) - [Environments](domains/environments.md) - [Deployments](domains/deployments.md) - [Cluster](domains/cluster.md) - [Configuration](domains/configuration.md) - [Policy and Autonomy](domains/policy-autonomy.md) - [Approvals and Decisions](domains/approvals-decisions.md) - [Incidents and Resolvers](domains/incidents-resolvers.md) - [Communications and Notifications](domains/communications-notifications.md) - [Reliability](domains/reliability.md) ## Workflows - [Project Onboarding](workflows/project-onboarding.md) - [Connection Onboarding](workflows/connection-onboarding.md) - [Interactive Planning](workflows/interactive-planning.md) - [Advisory Conversation](workflows/advisory-conversation.md) - [Plan to Production](workflows/plan-to-production.md) - [Factory Execution](workflows/factory-execution.md) - [Task to Merge](workflows/task-to-merge.md) - [Change to CI](workflows/change-to-ci.md) - [CI Resolution](workflows/ci-resolution.md) - [Merge to Production](workflows/merge-to-production.md) - [Deployment Resolution](workflows/deployment-resolution.md) - [Machine Enrollment](workflows/machine-enrollment.md) - [Human in the Loop](workflows/human-in-the-loop.md) - [Incident to Resolution](workflows/incident-to-resolution.md) ## UI / Product Information Architecture - [Whole-Product IA and Shell](ui/INDEX.md) - [Home / Work Command Center](ui/home-work-command-center.md) - [Project](ui/project.md) - [Plan](ui/plan.md) - [Planning Workspace](ui/planning.md) - [Queues and Dependency Graph](ui/queues-and-dependency-graph.md) - [Advisor Chat](ui/advisory-chat.md) - [Search / Command Palette](ui/search-command-palette.md) - [Factory Run](ui/factory-run.md) - [Agents Collection and Analytics](ui/agents.md) - [Agent Detail](ui/agent.md) - [Review / ChangeSet](ui/review.md) - [CI](ui/ci.md) - [Project Decision Log](ui/decision-log.md) - [Approval / Attention](ui/approval.md) - [Release / Deployment](ui/release-deployment.md) - [Cluster](ui/cluster.md) - [Incident](ui/incident.md) - [Settings / Connections](ui/settings.md) ## Schemas / Contract Families - [Schema Family Index](schemas/INDEX.md) - [Identifiers and Versioning](schemas/identifiers-versioning.md) - [Transport Contracts / Errors / Realtime](schemas/transport-contracts.md) - [Events and Audit](schemas/events-audit.md) - [Configuration Schemas](schemas/configuration.md) - [Adapter / Provider Contracts](schemas/adapters.md) ## I0 / I1 Implementation Authority Read before implementing: 1. [`adr/`](adr/) — the 9 ADRs. 2. [`../plans/I0-I1-AUTHORITY.md`](../plans/I0-I1-AUTHORITY.md) — the binding digest; supersedes the previous eight-document reading list. 3. [`../../GOLIVE.md`](../../GOLIVE.md) — go-live journey and acceptance gates. 4. [`../plans/AWP-PAIN-INVARIANTS.md`](../plans/AWP-PAIN-INVARIANTS.md) — pre-live regression requirements per subsystem. 5. [`../plans/AWP-GOVERNANCE-AMENDMENT-2026-08-21.md`](../plans/AWP-GOVERNANCE-AMENDMENT-2026-08-21.md) — current gate state and proof scope. Consult on demand, no longer required reading: the parallel implementation plan, development-agent prompt, readiness ledger, reuse preflight, Step-0 dependencies, threat model and the approved [`../mockups/i1/README.md`](../mockups/i1/README.md) U1–U6 set — the last of which remains the binding visual target for I1 implementation. Live-infrastructure proof that has not been executed is never inferred from architecture documents. Per the governance amendment, an unexecuted proof is a GOLIVE work item, not a start-work blocker.