# 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