# batch-intake-00 — Migration plan (ASR / ADR / PR governance inputs)

**Status:** Ready for execution (operator-approved decisions locked)
**Date:** 2026-07-17
**Prompt:** `prompts/bootstrap/inputs-intake.md`
**Scope:** Canonicalize `inputs/` governance drafts into `a2c-workflow` method assets
**This batch:** Plan only — **no content commits** until batch-intake-01+

---

## 1. Inventory

| Source path | Kind | Role in intake |
|-------------|------|----------------|
| `inputs/a2c-asr-adr-pr-governance.md` | Design essay | Primary narrative for workflow note + feed ADRs 1, 2, 5 |
| `inputs/You asked _do you want to capture this “PRs as arc.md` | Chat/export essay | **Merge into** workflow note (PR control points); do not ingest as separate doc |
| `inputs/adr0009-governance-asr-adr-spec-contract-a2c.md` | Draft ADR (product-numbered) | Feed **ADR 2** (chain); strip qemu/ProductPhase examples |
| `inputs/adr0010-status-semantics-asr-adr.md` | Draft ADR | Feed **ADR 3** (Amends / status) |
| `inputs/adr0011-narrative-architecture-story-per-productphase.md` | Draft ADR | Feed **ADR 4** (architecture story) |
| `inputs/template/productphase-1.0-architecture-story-abstract.md` | Template draft | → generic architecture-story templates |
| `inputs/template/productphase-1.0-architecture-story-skeleton.md` | Template draft | → generic architecture-story templates |

**Origin flavor:** Material emerged from `esys-qemu-prof` ProductPhase 1.0 discussions. Method docs must be **product-agnostic**; examples stay out of Accepted method ADRs (optional short “consumer example” notes only if needed later).

---

## 2. Locked decisions (operator)

| # | Decision |
|---|----------|
| A | Binding rules → **five separate ADRs** (no mega-ADR); small self-contained commits (one ADR per commit) |
| B | Merged essays → **one** `docs/workflow/` note linking the five ADRs |
| C | **Amends** is a real ADR: additive small ADRs vs full supersede/copy-paste |
| D | Specs/Contracts: **optional**; if used, must follow A2C rules |
| E | Architecture story: **Markdown canonical**; PDF/slides/etc. optional human presentation exports |
| F | ADR 1 **scaffolds empty `docs/asr/`** in this repo immediately |
| G | Intake ADRs start as **Proposed** until explicit accept |
| H | Renumber away from inputs’ 0009–0011 (collide with existing release/web-source ADRs) |

---

## 3. Conflicts and normalization

| Conflict | Resolution |
|----------|------------|
| Inputs ADR **0009 / 0010 / 0011** vs existing Accepted ADRs with those numbers | Assign **0019–0023** (next free after 0018) |
| Inputs status **Active / Amended** vs A2C **Proposed / Accepted / Rejected / Superseded / Deprecated** | ADR 3 defines Amends vs Supersede and how Amended relates to Accepted; do not silently replace A2C lifecycle |
| Inputs filenames `adr0001-*.md` style vs A2C `NNNN-short-title.md` | Keep A2C naming: `docs/adr/0019-….md`, `docs/asr/NNNN-….md` (zero-padded, no `adr`/`asr` prefix in filename unless rules say otherwise — **prefer** `0001-short-title.md` under `docs/asr/` mirroring ADR layout) |
| Duplicate PR essays | Single workflow note; discard second as source after merge |
| `[web:NNN]` / footnotes in drafts | Normalize in ADR/doc commits per ADR-0011; register new URLs in `docs/web-source-mapping.md` |
| `inputs/` not in `.gitignore` | batch-intake-04 |

---

## 4. Target ADR map (Proposed)

| New ID | Working title | Primary sources | Same-commit extras |
|--------|---------------|-----------------|--------------------|
| **0019** | Architecture Significant Requirements as first-class artifacts | `a2c-asr-adr-pr-governance.md` (ASR sections) | Scaffold `docs/asr/` (README / `.gitkeep`); update INDEX; optional `rules/` note deferred to batch-intake-03 if needed |
| **0020** | Intent → ASR → ADR → Spec/Contract → planning governance chain | `adr0009-…` | Specs/Contracts optional; if present, A2C rules apply; reference existing `templates/spec/` |
| **0021** | Amending Accepted ADRs (Amends vs Supersede) | `adr0010-…` | May require later update to `rules/02`, `rules/08` (batch-intake-03 or follow-up) |
| **0022** | Narrative architecture story per ProductPhase | `adr0011-…` | MD canonical; exports optional; no mandatory PDF in CI for method repo |
| **0023** | Pull requests as architecture control points | PR essay(s) | Keep Decision short; detail can live in workflow note |

**Commit message pattern:** `adr(workflow): …` (or `adr(governance): …`) — one ADR + INDEX (+ scaffold for 0019) per commit.

---

## 5. Other canonical destinations

| Destination | Content | Batch |
|-------------|---------|--------|
| `docs/workflow/asr-adr-pr-governance.md` | Merged essays; links to 0019–0023; operator/AI-facing narrative | **batch-intake-03** (or immediately after ADRs if preferred — default **03**) |
| `docs/asr/README.md` | Conventions pointer; empty tree ready for consumer/method ASRs | With **0019** |
| `templates/asr/asr-template.md` | New (mirror ADR template discipline) | Small commit after 0019 or in batch-intake-03 |
| `templates/architecture/architecture-story-abstract.md` | Generalized from inputs templates | batch-intake-01 or 03 |
| `templates/architecture/architecture-story-skeleton.md` | Generalized from inputs templates | batch-intake-01 or 03 |
| `docs/adr/INDEX.md` | Add 0019–0023 under a new **Governance** group | Each ADR commit |
| `CHANGELOG.md` | `[Unreleased]` entries per ADR/docs commit | Each commit |
| `.gitignore` | Add `inputs/` | **batch-intake-04** |

**Out of scope for this intake**

- Implementing Spec/Contract tooling or mandatory dirs in every consumer
- Shipping a ProductPhase 1.0 architecture story body for esys-qemu-prof
- Accepting ADRs without human review
- Editing Accepted ADRs 0009–0011 (release/web-source) — no collision rewrite

---

## 6. Suggested execution order

| Batch | Actions | Commits |
|-------|---------|---------|
| **00** (this file) | Inventory + plan | Optional: commit this plan alone |
| **01** | Architecture-story **templates** only (generalized) | 1–2 small commits |
| **02** | ADRs **0019 → 0023** in order, one commit each (0019 includes `docs/asr/` scaffold) | 5 commits |
| **03** | Workflow note; web-source fixes; rules cross-links (`02`, `08`, prompts README) if required by 0021 | 1–3 commits |
| **04** | `.gitignore` → `inputs/`; verify not tracked | 1 commit |

**Verification each commit batch:** `a2c doctor`, `a2c web-sources check` when docs change, `git status`.

---

## 7. Cursor invocation (next)

```text
@prompts/bootstrap/inputs-intake.md
@prompts/phases/adr-create-update.md
Start batch-intake-02: create Proposed ADR-0019 (ASRs first-class + docs/asr scaffold) per planning/intake/batch-intake-00-plan.md — one commit only.
```

(Or start **batch-intake-01** for templates first if preferred.)

---

## 8. Operator checklist before batch-intake-01

- [x] Five ADRs, no mega-ADR
- [x] Amends = own ADR
- [x] Workflow note for essays
- [x] Specs/Contracts optional but A2C-ruled
- [x] Architecture story = MD + optional exports
- [x] Scaffold `docs/asr/` with ADR 0019
- [x] Commit this plan file as batch-intake-00 deliverable
- [x] INDEX group for 0019–0023: **Governance** (new section)