SilverSight/docs/living/README.md
openresearch e4cb242619 docs: create living targets folder for rapidly evolving goals
New folder: docs/living/ — for goals that change daily, not stable
findings (those stay in docs/research/).

Documents:
- README.md: rules for living docs (overwrite freely, one sentence
  per target, link to findings, honesty tag)
- TARGETS.md: 5 active targets (invariant geometry, reaction primes,
  merged O(1), formal cleanup, encoder fidelity) + 3 dead + 3 candidate
- PROJECT_MAP.md: what SilverSight IS right now (not what it was)
- MILESTONES.md: 5 near-term milestones with success criteria
  (3-SAT spectral test, cmix SVD, SLOS eigenvalue products,
   CRT hachimoji pairing, reaction prime proof)
- OPEN_QUESTIONS.md: 8 unanswered questions
- DIRECTION_LOG.md: 5 direction changes from this session, with
  the reason for each

Living docs rules:
- No measurement required (goals, not findings)
- Overwrite freely (git history preserves old versions)
- One sentence per target
- Link to docs/research/ for backing evidence
- Honesty tag: MEASURED / OPEN / SPECULATIVE
2026-07-03 22:13:45 +00:00

1.7 KiB

Living Documents

This folder is for rapidly evolving goals, targets, and project maps.

Unlike the formal docs in docs/research/ (which are measured, stable findings), the documents here change daily. They represent the current direction of the project — what we're aiming at today, which may shift tomorrow.

Document Types

Type Purpose Update frequency
TARGETS.md Current research targets and their status Daily
PROJECT_MAP.md What the project IS right now (not what it was) Daily
MILESTONES.md Near-term milestones with success criteria Weekly
OPEN_QUESTIONS.md Questions we haven't answered yet As needed
DIRECTION_LOG.md Why the direction changed (decision log) On change

Rules

  1. No measurement required here. These are goals, not findings. Findings go in docs/research/ with bytes behind them.
  2. Overwrite freely. The old version is in git history. Don't append — replace.
  3. One sentence per target. If you can't state it in one sentence, it's not a target yet, it's a question.
  4. Link to findings. Each target should link to the relevant docs/research/ document that backs (or refutes) it.
  5. Honesty tag. Each target gets: MEASURED (backed by data), OPEN (untested), or SPECULATIVE (no data yet).

Current Documents