Files

T

Jon Chery 288607b3fa docs(specify): ingest docs/vision+architecture; reframe .ciagent for v1.1

---ci---
project: acdl
phase: 0
milestone: v1.1
status: specify
decisions:
  - D-034 temporary long-lived AWS key waiver (used once in Phase 08, rotated)
  - D-035 milestone v1.1 (feature), ship tag v1.2.0
  - D-036 spike picks l1-s3 + l2-static-asset
  - D-037 demo archived to demo/
  - D-038 open decisions resolved (accept recommendations + decide rest)
---/ci---

Ingest docs/vision.md (6 tenets, anti-goals, signals of success) and
docs/architecture.md v0.2 (4 layers + 6 cross-cutting concerns incl. the
substrate abstraction) as the source of truth for why/how. Reframe the
project from the v1.0 stub demo (tag v1.1.0, archived to demo/ in Phase 06)
to the real Agentic Cloud Delivery Platform.

- config.json: milestone v1.1, status specify
- PROJECT.md: vision + 4-layer/6-concern model + 11 open-decision
  resolutions (W1.A/B, W2.A, BA.A accepted; W3.D/E, BA.B-F, OpenTofu
  decided) + D-034..D-038
- ARCHITECTURE.md: target architecture (IR, confidence, ledger, HITL, SoD,
  substrate abstraction) + v1.1 spike scope (l1-s3 + l2-static-asset)
- REQUIREMENTS.md: add REQ-16..REQ-28 + traceability
- ROADMAP.md: add v1.1 Phases 06-10 (archive, arch-finalize, OIDC, IR+L1,
  L2+contract-e2e)
- PERSONAS.md: add platform-engineer + security-engineer (custom),
  retire infra-stub-engineer, update territories + verification toolchain
  (terraform validate + jsonschema)
- PLAN.md: v1.1 specify plan

2026-07-21 17:55:09 +00:00

2.8 KiB

Raw Blame History

phase, name, milestone, milestone_type, status, requirements, must_haves, verification

phase

name

milestone

milestone_type

status

requirements

must_haves

verification

v1.1-specify

v1.1

feature

specify

REQ-16..REQ-28

config.json project.milestone = v1.1, status = specify

PROJECT.md reframed from stub demo to real platform (vision tenets + 4-layer/6-concern model + 11 open-decision resolutions + D-034..D-038)

ARCHITECTURE.md rewritten to the target architecture (IR, confidence, ledger, HITL, SoD, substrate abstraction) with v1.1 spike scope

REQUIREMENTS.md adds v1.1 section (REQ-16..REQ-28) + traceability

ROADMAP.md adds v1.1 Phases 06–10

PERSONAS.md adds platform-engineer + security-engineer, retires infra-stub-engineer, updates territories + verification toolchain

docs/vision.md + docs/architecture.md (upstream) referenced as the why/how source of truth

typecheck	test	build
python3 -m jsonschema schemas/*.schema.json 2>/dev/null \|\| true # schemas authored in Phase 07	scripts/verify_phase06.sh # authored in Phase 06	no-op

v1.1 — Specify PLAN

Goal

Ingest docs/vision.md + docs/architecture.md and update all .ciagent files to reframe the project from the v1.0 stub demo to the real Agentic Cloud Delivery Platform, milestone v1.1 (architecture finalization + v1 spike).

Scope of this stage (SPECIFY only)

Rewrite the five .ciagent/ files + config.json:

config.json — milestone v1.1, status specify.
PROJECT.md — reframe; carry the 6 vision tenets; record the 11 open-decision resolutions (D-038) + the OIDC waiver (D-034) + spike picks (D-036) + archive decision (D-037) + version (D-035).
ARCHITECTURE.md — target architecture (4 layers + 6 cross-cutting concerns incl. substrate abstraction); v1.1 spike scope.
REQUIREMENTS.md — add REQ-16..REQ-28 + traceability.
ROADMAP.md — add v1.1 Phases 06–10.
PERSONAS.md — add platform-engineer + security-engineer; retire infra-stub-engineer; update territories + verification toolchain.

Waves

Single wave (lead-developer only — this is metadata work):

T-0.1 Rewrite config.json + PROJECT.md + ARCHITECTURE.md.
T-0.2 Rewrite REQUIREMENTS.md + ROADMAP.md + PERSONAS.md.
T-0.3 Commit with ---ci--- block (phase 0, milestone v1.1, status specify).

Dependencies

docs/vision.md + docs/architecture.md (pulled from origin/main).
User-locked parameters (milestone v1.1, spike = l1-s3 + l2-static-asset, real AWS via OIDC, accept-recommendations-and-decide-rest).

Next stage

CLARIFY — auto-resolve the 11 open decisions (already recorded in PROJECT.md); surface genuinely blocking ambiguities only. Then RESEARCH — delegate to ci-researcher on 10 targets (highest priority: Gitea/act_runner OIDC support, which gates real-AWS feasibility for the spike).

2.8 KiB Raw Blame History Unescape Escape