jschoubben
c0b35652d0
papa-hq reads 01 research -> 03 decision -> 02 design. The order is a scar, not a choice: 02-DESIGN existed from its initial commit, and when adr/ was finally promoted on 2026-07-13 it took the next free number rather than its place in the sequence. By then design was too settled to renumber. hal-hq was three commits old, so it is not. adr/ becomes 02-DECISIONS and 02-DESIGN becomes 03-DESIGN, and following the folder numbers now walks the process in the order it happens: research produces a decision, the decision authorises a design. 00-GENESIS becomes 00-META, matching papa's rename from the same restructure. Every path reference rewritten across documents, frontmatter, playbooks and skills. All links resolve; all 58 frontmatter blocks parse and their path fields still point at files that exist.
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# 01-RESEARCH
|
|
|
|
Investigations that have not yet hardened into design.
|
|
|
|
## Structure
|
|
|
|
Each effort lives in `NNN-descriptive-name/` and **must** contain `00-overview.md`, carrying its
|
|
state in YAML frontmatter and a prose summary below it:
|
|
|
|
```yaml
|
|
---
|
|
status: active | graduated | abandoned
|
|
initiated: YYYY-MM-DD
|
|
touches: [] # design docs, subsystems or areas the effort bears on
|
|
became: [] # required when status is terminal — what it turned into
|
|
---
|
|
```
|
|
|
|
The prose says what is being investigated, why, and what it touches. It does not restate the
|
|
status — status lives in one place, and two places is one too many.
|
|
|
|
Further documents in the same folder hold the work itself: notes, evidence, option analyses,
|
|
draft designs.
|
|
|
|
## Lifecycle
|
|
|
|
| status | Meaning |
|
|
|---|---|
|
|
| `active` | Investigation in progress. |
|
|
| `graduated` | Checked against `00-META`, decided in `02-DECISIONS/`, and specified in `03-DESIGN` — see `became:`. |
|
|
| `abandoned` | Stopped or superseded. Nothing is deleted. |
|
|
|
|
An effort graduates by producing a decision record **and** a `03-DESIGN` entry. It is abandoned
|
|
in place — never deleted. What was rejected, and why, is the more expensive half to
|
|
rediscover.
|
|
|
|
Starting and closing efforts is playbook territory:
|
|
[`00-META/process/01-research.md`](../00-META/process/01-research.md) and
|
|
[`02-graduation.md`](../00-META/process/02-graduation.md).
|
|
|
|
## Rules
|
|
|
|
- Markdown only. Do not skip or reuse a sequence number.
|
|
- **Evidence, not assertion.** An effort that measured nothing has not finished.
|
|
- Research describes real observations but **never identifies the mesh it observed**. The shape
|
|
of a finding survives anonymisation intact.
|