mirror of
https://github.com/allaunthefox/SilverSight.git
synced 2026-07-31 01:25:21 +00:00
e4cb242619
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
39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
# 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
|
|
|
|
- [TARGETS.md](TARGETS.md) — current research targets
|
|
- [PROJECT_MAP.md](PROJECT_MAP.md) — what the project IS now
|
|
- [MILESTONES.md](MILESTONES.md) — near-term milestones
|
|
- [OPEN_QUESTIONS.md](OPEN_QUESTIONS.md) — unanswered questions
|
|
- [DIRECTION_LOG.md](DIRECTION_LOG.md) — why direction changed
|