# FEEDBACK — mgf-vm-firecracker

> Paper-tracking file for issues, friction, and requests against
> this project. Consumer projects (and any future adopter) file
> PAPER-NN entries here.
>
> **Where to file what:**
>
> - **mgf-vm-firecracker-specific** → file HERE.
> - **Federation-wide** (cross-sibling patterns, standards
>   proposals) → file in
>   [mgf-common/FEEDBACK.md](https://codeberg.org/magogi-admin/mgf-common/src/branch/main/FEEDBACK.md).
>
> **Numbering convention:** paper numbers (`PAPER-NN`) are local
> to this repo (FB-01). When a paper cross-references a
> federation-wide paper, the federation number appears in the
> metadata table as a cross-reference row.
>
> **Discipline:** see
> [mgf-standard/docs/standards/DOCUMENTATION.md](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/DOCUMENTATION.md)
> §FEEDBACK (rules FB-01..FB-04, DOC-13).

---

## §1 Process

1. **File freely.** Any consumer hitting friction MUST file a
   PAPER-NN under §2. Don't wait for permission; the maintainer
   triages.
2. **Status flips** through `OPEN` → `SHIPPED` / `DEFERRED` /
   `WONTFIX` / `MOVED` as the paper resolves. A `SHIPPED` row
   carries a commit-SHA reference + release-version reference.
3. **Renumbering** never happens within this repo — papers keep
   their PAPER-NN forever (FB-01).

---

## §2 Open feedback (active)

*No papers filed yet. The first paper goes here with the shape:*

```
#### `PAPER-01` — <one-line title>

| Field | Value |
|---|---|
| Status | OPEN |
| Severity | 🟢 Low / 🟡 High / 🔴 Critical |
| Submitter | <consumer-name> (commit [`<sha>`](<url>)) |
| Submitted | YYYY-MM-DD |
| Federation paper | [PAPER-NN in mgf-common](...) (if cross-referenced) |

**Concern.** ...

**Why it matters.** ...

**Concrete evidence.** ...

**Suggested shape.** ...
```

---

## §3 Reviewer's meta-feedback

(none yet — placeholder for cross-cutting observations about
the FEEDBACK process itself.)

---

## §4 How consumers submit feedback

1. **Open a Codeberg issue** at
   <https://codeberg.org/magogi-admin/mgf-vm-firecracker/issues> if you have a
   quick question. Maintainer triages.
2. **For a structured pain point**: file a PAPER-NN here as a PR
   that adds the entry to §2.
3. **For AI-agent-driven consumer sessions**: see your project's
   `docs/claude/CLAUDE.md` auto-block (managed by `mgf-common catch-up`)
   — the `feedback-discipline` section spells out where to file
   what.

---

## §5 Cross-references

- [mgf-common/FEEDBACK.md](https://codeberg.org/magogi-admin/mgf-common/src/branch/main/FEEDBACK.md)
  — federation-wide PAPERs.
- [mgf-standard/docs/standards/DOCUMENTATION.md](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/DOCUMENTATION.md)
  — FEEDBACK discipline rules (FB-01..FB-04, DOC-13).
