# BUGS — {{PROJECT_NAME}} open-issues register

> The SCARS antechamber: issues that are **open, known, but not yet
> understood**. [`SCARS.md`](SCARS.md) holds failures that are fixed and
> explained (symptom → root cause → remedy); this file holds the ones still
> being chased, so a session doesn't re-discover the same weirdness at full
> cost.
>
> **Graduation convention.** Once an entry below is understood and fixed,
> strike it through (with the fixing commit) and add the lesson as a new
> `SCARS.md` `§ANCHOR`. An issue lives in one file at a time: open here, or
> fixed-and-learned there — never both.

## Open

_(nothing open yet — add an entry in the shape below once something surfaces)_

## Done (graduated to SCARS)

_(nothing graduated yet)_

---

## Entry format

Not a real entry — copy this shape into `## Open`, then strike it through into
`## Done` once it graduates to a `SCARS.md` `§ANCHOR`:

    - **BUG-N** — *(date)* — one-line symptom
      - evidence: `path/to/file:line` or a log excerpt
      - suspicion: best current theory of the root cause
      - owner: ROADMAP ticket or person tracking it

    - ~~**BUG-N** — one-line symptom~~ → `SCARS.md` `§ANCHOR-NAME` (`<commit sha>`)