# Inputs intake prompt

Migrate governing material from **`inputs/`** into this A2C-governed repository, then **retire** `inputs/` from version control.

## Contract

Read and follow as governing artifacts (do not invent parallel conventions):

- `AGENTS.md`
- `rules/` (especially `00-docs-first.md`, `01-architecture-first.md`, `02-adr-conventions.md`, `08-adr-editing-evolution.md`, `10-adr-significance-scan.md`, `15-web-source-tags.md`)
- Accepted ADRs already in `docs/adr/` (including bootstrap **ADR-0000** if present)
- `docs/web-source-mapping.md`
- Templates under `templates/` (`adr/`, `architecture/`, `docs/`)

`inputs/` is **intake only** — not part of the long-term repo contract.

During **brownfield migration** ([legacy-adoption.md](../../docs/workflow/legacy-adoption.md)), `inputs/` may hold migration-only context for **anchoring ADRs** (batch 02) without being committed. Use this prompt in batch 05 when material should be **canonicalized** into `docs/`.

## Objective

1. Inventory everything under `inputs/` (ADRs, architecture overviews, workflow notes, etc.).
2. Copy, edit, and **normalize** each item into the canonical repo layout.
3. Align with existing bootstrap output — do not duplicate or contradict ADR-0000, `docs/workflow/adoption.md`, or files already created by `a2c bootstrap` unless you explicitly supersede via a **new** ADR.
4. When migration is complete, add **`inputs/`** to `.gitignore` so Git never tracks source drafts again.
5. Stop after each commit batch; do not big-bang the whole tree in one step.

## Source → destination mapping

| `inputs/` material | Canonical target | Notes |
|--------------------|------------------|-------|
| ADR drafts | `docs/adr/NNNN-short-title.md` | Next free `NNNN`; update `docs/adr/INDEX.md` same commit |
| Architecture overview / context | `docs/architecture/` | Use `templates/architecture/architecture-template.md` for new overviews |
| Workflow / process notes | `docs/workflow/` | Align with existing adoption and manifest |
| External references | `docs/web-source-mapping.md` + `[web:NNN]` in docs | Normalize per ADR-0011 |
| README / project intro | `README.md` | Merge with existing; do not wipe bootstrap content |
| Planning seeds (optional) | `planning/epics/`, `planning/tasks/` | Only if explicitly present in `inputs/` and scoped to this batch |

**Do not** copy `inputs/` wholesale to repo root. **Do not** leave symlinks or duplicate trees.

## Normalization rules (mandatory)

### ADRs

- Treat `inputs/` ADRs as **Proposed** until reviewed — set `Status: Proposed` unless the user confirms Accepted.
- **One ADR per commit** (`adr(<category>): …`); INDEX update in the same commit.
- Do **not** rewrite Accepted ADRs in place; supersede with a new ADR if decisions changed.
- Renumber if `inputs/` ADR numbers collide with repo ADRs (e.g. bootstrap ADR-0000 already exists).

### Web sources

Normalize all external URLs before commit (see `prompts/phases/adr-create-update.md`):

1. Extract new URLs from footnotes, raw links, or foreign tags in `inputs/`.
2. Register in `docs/web-source-mapping.md` with next free `web:NNN`.
3. Replace inline references with `[web:NNN]`.
4. Run `python scripts/check_web_source_tags.py` before committing doc batches.

### Editing policy

- **Read from `inputs/`; write only to canonical paths** (`docs/`, `planning/`, etc.).
- After a file is migrated and committed, **do not edit `inputs/`** — fix forward in canonical locations.
- Prefer templates over ad-hoc markdown structure.

## Execution batches (suggested order)

Execute **one batch at a time**; stop after each with commit message(s).

| Batch | Scope |
|-------|--------|
| **batch-intake-00** | Inventory `inputs/` → written migration plan (paths, conflicts, ADR numbering) — **no commits** |
| **batch-intake-01** | Architecture docs → `docs/architecture/` |
| **batch-intake-02** | ADRs (one commit per ADR) → `docs/adr/` + INDEX |
| **batch-intake-03** | Remaining workflow/docs + web-source mapping fixes |
| **batch-intake-04** | `.gitignore`: add `inputs/`; `git rm -r --cached inputs/` if tracked; verify clean |

## Verification (each batch)

- `a2c validate --path .`
- `a2c doctor --path .`
- `a2c web-sources check --path .` (when docs changed)
- `git status` — **`inputs/` must not appear** after batch-intake-04

## Out of scope

- Product/application implementation code
- Changing A2C method assets in `tools/ai-rules/` (submodule/clone) or copied `rules/` unless explicitly requested
- Deleting `inputs/` from disk (ignore only — operator may keep local drafts)

## Current batch

> Set to `batch-intake-00` first, then proceed sequentially.

## Stop condition

After **batch-intake-04**:

1. List canonical files created/updated
2. Confirm `inputs/` is in `.gitignore` and not tracked by Git
3. Suggest any follow-up ADRs or commit-plan items
4. **Stop** — do not start implementation batches unless asked