# `docs/inprogress/` — the maintainer's workspace

**Per `DOC-02` + `DOC-11`:** this directory is the **workspace**
where the maintainer's internal-posture docs live while they're
active. It is **not a graveyard** — closed trackers SHOULD move
to `docs/archive/<year>/` within one release cycle.

## What goes here

- **Living priority trackers** (per `DOC-06`): one per concern
  area (`RELIABILITY_AND_ACCURACY.md`, `SECURITY_HARDENING.md`,
  `PERFORMANCE_AND_CAPACITY.md`). Each follows the §1..§6
  canonical shape; each work unit carries verified `file:line`
  evidence and a falsifiable concrete output.
- **Long-horizon planning docs** (per `DOC-06`'s carve-out):
  `strategic_review.md`, `federation_roadmap.md`. These are
  *not* trackers (no per-item closure) — they're roadmaps that
  inform tracker scope.
- **One-shot audit passes** (e.g., `coverage.md`). These have
  a finite scope; when complete they move to archive.
- **One-shot rollout / notification docs** (`V2_*_NOTIFICATION.md`).
  Cross-project announcements for a standards bump. They land
  here while the rollout is in-flight; once sent + acknowledged
  by consumers they move to `docs/archive/<year>/`.

## What does NOT go here

- **Consumer-reported papercuts** → `FEEDBACK.md` (per `DOC-10`).
  Consumer's experience is the source of truth; this directory
  is the maintainer's internal queue.
- **Per-release breaking-change guides** → `docs/cutover/`.
- **Permanent rules / standards** → `mgf-fed standards <TOPIC>` (or browse [`mgf-standard/docs/standards/`](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/)).
- **Per-component user guides** → `docs/reference/`.

## Promotion / demotion mechanics

| Transition | Trigger |
|---|---|
| **Open → Closed** | All items in §2 priority table flipped to ✅, OR the rest formally deferred to a next-pass tracker |
| **Closed → Archived** | One release cycle after closure (per `DOC-11`); move file to `docs/archive/<year>/<original-name>.md` |
| **In-progress → Reformatted as tracker** | Strategic / roadmap doc has matured enough that items are now narrow + falsifiable; rename + reshape into the canonical tracker form |

## Index (current)

**Hygiene note (2026-05-25):** the closed-state trackers that
previously cluttered this directory — `SUPERVISOR_ROLLOUT.md`,
`PROPOSAL_test_supervisor.md`, `v1_0_stability_audit.md`,
`V2_6/7/8_NOTIFICATION.md`, `pre_release_check.md`, and
`SECURITY_HARDENING.md` (all 8 SH-* items closed) — have moved
to [`docs/archive/2026/`](../archive/2026/README.md) per **DOC-11**.
See that archive's index for the historical record. The table
below is the **active** working set only.

| File | Status | What |
|---|---|---|
| `v1_0_handoff.md` | active (Wave 5 STOP-point) | Maintainer hand-off for the v1.0 cut. Wave 4 complete; Wave 5 = the cut itself, the maintainer's call. Q-4 still open. |
| `v1_0_quality_gates.md` | active (Q-1..Q-11 inventory) | v1.0 federation quality-gate sweep. Companion to the archived stability audit. Q-4 (PyPI backlog drain) still open. |
| `feedback_action_plan.md` | active (steps 1–6 ✅; step 7 open) | Action plan distilled from `FEEDBACK.md` (64 entries). Step 7 = Q-2 / Q-4 / Q-11 — the only remaining pre-cut work. |
| `release_waves_plan.md` | active (Waves 1–4 ✅; Wave 5 = v1.0 cut) | Federation execution plan; Wave 5 IS the v1.0 cut itself. |
| `pre_release_additions.md` | active (all 15/15 shipped; retained during v1.0-cut window) | Feature roadmap that drove Waves 1–4. Reflective value during the cut window; archive after v1.0 ships. |
| `RELIABILITY_AND_ACCURACY.md` | active (P0+P1 ✅; P2 ⏳ deferred) | RA-* items: atomic-write hygiene, concurrency, rollback semantics, cross-platform paths. |
| `PERFORMANCE_AND_CAPACITY.md` | active (PC-06 + PC-08 ⏳ deferred-but-tracked) | PC-* items: import-time, sustained throughput, large-payload scaling, memory baseline. |
| `coverage.md` | active (updated each release that touches the test surface) | Canonical reference for what mgf-common tests at each pyramid layer (TS-19/20/21). |
| `strategic_review.md` | active (long-horizon) | Senior-TC-level review of trajectory; not a tracker — informs tracker scope. |
| `federation_roadmap.md` | active (long-horizon) | Sibling-extraction plan (ASPIRE-06 + onward). |

## Archived

Closed trackers move to [`docs/archive/<year>/`](../archive/)
per **DOC-11**. See [`docs/archive/2026/README.md`](../archive/2026/README.md)
for the full archive index.
