---
phase: 11
name: v1.2-research-and-readme
milestone: v1.2
requirements: [REQ-29]
type: docs
branch: phase/11-v1.2-research-and-readme
---

# Phase 11 — v1.2-research-and-readme (v1.2) PLAN

## Goal

Re-evaluate go-gitea/gitea#36988 (OIDC); audit the v1.1 spike for NFR gaps
+ simplification opportunities; rewrite README.md to reflect v1.1 complete
+ the actual platform flow + v1.2 objective.

## Tasks (single wave — docs territory)

### T-11.1 — RESEARCH.md v1.2 addendum (REQ-29)
- TARGET 9: #36988 re-check → D-047 (extend D-039 waiver).
- TARGET 10: NFR audit of spike (IAM, idempotency, error handling, P1-1, stale paths).
- TARGET 11: Simplification opportunities (script consolidation D-048).
- TARGET 12: README rewrite plan.
- TARGET 13: ECS L1 catalog scoping (D-049) for Phase 13.
- Decisions surfaced: D-047, D-048, D-049.
- Territory: `.ciagent/RESEARCH.md`

### T-11.2 — README.md rewrite (REQ-29)
- Status section: v1.2 active, v1.1 complete (tag v1.2.0), v1.0 archived.
- "How the platform works": the spike flow diagram + the IR commitments claim.
- "What's different in v1.2": 6 L1s, l2-microservice, terraform apply, consumer repo, run_platform.sh, NFR hardening.
- "How to run": prerequisites, bootstrap, rotate, run_spike_e2e.sh, demo.
- Repo layout table (refreshed Status column).
- Environments table (dev/qa/prod/dr + status).
- Credentials section (D-034 closed, D-039/D-047 waiver, #36988 link).
- Territory: `README.md`

## Verification

- `grep -c "v1.2" README.md` ≥ 5 (v1.2 referenced throughout).
- `grep "v1.1 (active)" README.md` returns nothing (no stale framing).
- `.ciagent/RESEARCH.md` has a "## v1.2 Research Addendum" section.
- D-047/D-048/D-049 present in the addendum's decisions table.
- `scripts/verify_phase11.sh` (authored in the verify step).

## Ship

Merge `phase/11-v1.2-research-and-readme` → `main` (--no-ff). Tag `v1.2.1`.