8cabc0191c
- devops docs: 8 files updated for Phase 6 state; field-trial.md added (946-line runbook) - developer docs: api-reference (50+ endpoints), quick-start, 5 existing guides updated, 5 new guides added - engineering docs: all 12 files updated (services, architecture, SDK guide, testing, overview) - OpenSpec archives: phase-7-devops-field-trial, developer-docs-phase6-update, engineering-docs-phase6-update - VALIDATOR.md + scripts/start-validator.sh: V&V Architect tooling added - .gitignore: exclude session artifacts, build artifacts, and agent workspaces Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
# OpenSpec Proposal — phase-7-devops-field-trial
|
||
|
||
**Status:** Approved
|
||
**Proposed:** 2026-04-04
|
||
**Approved by:** CEO
|
||
|
||
## Problem Statement
|
||
|
||
The existing `docs/devops/` was written during Phase 2 (archived 2026-04-02). Phases 3–6 added
|
||
substantial new infrastructure — 14 new DB migrations, Phase 6 feature flags, Stripe integration,
|
||
new services (Analytics, Tier, Compliance, A2A), and the Next.js portal — none of which are
|
||
reflected in the current DevOps documentation.
|
||
|
||
Additionally, the team is preparing for in-house Docker Compose field trials and has no
|
||
deployment execution guide.
|
||
|
||
## Proposed Solution
|
||
|
||
**WS1 — Update Existing DevOps Docs**
|
||
Audit and update all files in `docs/devops/` to reflect the current Phase 6 state of the
|
||
codebase. Every env var, migration, service, and port must be accurate.
|
||
|
||
**WS2 — New In-House Field Trial Guide**
|
||
Create `docs/devops/field-trial.md` — a step-by-step execution playbook covering:
|
||
- Phase A: Stack startup verification
|
||
- Phase B: Core product end-to-end journeys
|
||
- Phase C: Security guardrails and tenant isolation
|
||
- Phase D: Next.js portal verification
|
||
- Phase E: AGNTCY conformance suite against live environment
|
||
- Phase F: Performance baseline
|
||
|
||
## CEO Approval
|
||
|
||
Approved 2026-04-04 per CEO directive: "YES Approved per CTO recommendations — implement your
|
||
plan per Openspec Protocol"
|