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.
1.5 KiB
1.5 KiB
name, description
| name | description |
|---|---|
| hal-new-research | Use when starting a new research effort in hal-hq — an idea, technology or approach worth investigating before it is committed to design. Triggers on "research X", "investigate X", "spike X", "should we use X", "is X worth doing". |
hal-new-research
Scaffolds a new research effort. Authoritative playbook:
00-META/process/01-research.md — read it;
this skill only does the mechanical setup.
Steps
-
Find the next free number: list
01-RESEARCH/NNN-*, take the highest plus one, zero-padded to three digits. -
Create
01-RESEARCH/NNN-descriptive-name/(kebab-case from the topic). -
Create
00-overview.mdin it with exactly this frontmatter, then a prose summary of what is being investigated, why, and what it touches:--- status: active initiated: YYYY-MM-DD touches: [] became: [] --- -
Do the research in further documents in the same folder. Keep the summary current.
Do not
- Do not restate the status in prose. It lives in frontmatter, in one place.
- Do not fill
became:while the effort is open —hal-graduatesets it at closure. - Do not skip or reuse a sequence number.
- Do not write into
03-DESIGNfrom an open effort. - Do not name the mesh being observed. Evidence is required; identification is forbidden.
Closing
An effort never just stops. It closes through hal-graduate as graduated or abandoned,
always with became: pointing at what it turned into. Nothing is deleted.