@nurix/etna 0.18.14 → 0.18.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/data/harness-index.json +1 -1
  2. package/data/harnesses/code/harness.json +2 -2
  3. package/data/harnesses/code/skills/boundary/SKILL.md +34 -14
  4. package/data/harnesses/code/skills/boundary/references/index.md +16 -0
  5. package/data/harnesses/code/skills/boundary/references/mechanisms.md +99 -0
  6. package/data/harnesses/code/skills/boundary/references/packs/async-messaging.md +81 -0
  7. package/data/harnesses/code/skills/boundary/references/packs/auth.md +93 -0
  8. package/data/harnesses/code/skills/boundary/references/packs/build-config-runtime.md +93 -0
  9. package/data/harnesses/code/skills/boundary/references/packs/cloudflare.md +93 -0
  10. package/data/harnesses/code/skills/boundary/references/packs/frontend.md +93 -0
  11. package/data/harnesses/code/skills/boundary/references/packs/generic-tail.md +55 -0
  12. package/data/harnesses/code/skills/boundary/references/packs/persistence.md +93 -0
  13. package/data/harnesses/code/skills/boundary/references/packs/wire-api.md +87 -0
  14. package/data/harnesses/code/skills/brainstorm/README.md +28 -10
  15. package/data/harnesses/code/skills/brainstorm/SKILL.md +27 -12
  16. package/data/harnesses/code/skills/brainstorm/templates/evidence.md +24 -0
  17. package/data/harnesses/code/skills/brainstorm/templates/rejected.md +5 -1
  18. package/data/harnesses/etna/harness.json +2 -2
  19. package/data/harnesses/etna/skills/boundary/SKILL.md +34 -14
  20. package/data/harnesses/etna/skills/boundary/references/index.md +16 -0
  21. package/data/harnesses/etna/skills/boundary/references/mechanisms.md +99 -0
  22. package/data/harnesses/etna/skills/boundary/references/packs/async-messaging.md +81 -0
  23. package/data/harnesses/etna/skills/boundary/references/packs/auth.md +93 -0
  24. package/data/harnesses/etna/skills/boundary/references/packs/build-config-runtime.md +93 -0
  25. package/data/harnesses/etna/skills/boundary/references/packs/cloudflare.md +93 -0
  26. package/data/harnesses/etna/skills/boundary/references/packs/frontend.md +93 -0
  27. package/data/harnesses/etna/skills/boundary/references/packs/generic-tail.md +55 -0
  28. package/data/harnesses/etna/skills/boundary/references/packs/persistence.md +93 -0
  29. package/data/harnesses/etna/skills/boundary/references/packs/wire-api.md +87 -0
  30. package/data/harnesses/etna/skills/brainstorm/README.md +28 -10
  31. package/data/harnesses/etna/skills/brainstorm/SKILL.md +27 -12
  32. package/data/harnesses/etna/skills/brainstorm/templates/evidence.md +24 -0
  33. package/data/harnesses/etna/skills/brainstorm/templates/rejected.md +5 -1
  34. package/data/harnesses/mobile/harness.json +2 -2
  35. package/data/harnesses/mobile/skills/boundary/SKILL.md +34 -14
  36. package/data/harnesses/mobile/skills/boundary/references/index.md +16 -0
  37. package/data/harnesses/mobile/skills/boundary/references/mechanisms.md +99 -0
  38. package/data/harnesses/mobile/skills/boundary/references/packs/async-messaging.md +81 -0
  39. package/data/harnesses/mobile/skills/boundary/references/packs/auth.md +93 -0
  40. package/data/harnesses/mobile/skills/boundary/references/packs/build-config-runtime.md +93 -0
  41. package/data/harnesses/mobile/skills/boundary/references/packs/cloudflare.md +93 -0
  42. package/data/harnesses/mobile/skills/boundary/references/packs/frontend.md +93 -0
  43. package/data/harnesses/mobile/skills/boundary/references/packs/generic-tail.md +55 -0
  44. package/data/harnesses/mobile/skills/boundary/references/packs/persistence.md +93 -0
  45. package/data/harnesses/mobile/skills/boundary/references/packs/wire-api.md +87 -0
  46. package/data/harnesses/mobile/skills/brainstorm/README.md +28 -10
  47. package/data/harnesses/mobile/skills/brainstorm/SKILL.md +27 -12
  48. package/data/harnesses/mobile/skills/brainstorm/templates/evidence.md +24 -0
  49. package/data/harnesses/mobile/skills/brainstorm/templates/rejected.md +5 -1
  50. package/package.json +1 -1
  51. package/data/harnesses/code/skills/boundary/references/boundary-taxonomy.md +0 -796
  52. package/data/harnesses/etna/skills/boundary/references/boundary-taxonomy.md +0 -796
  53. package/data/harnesses/mobile/skills/boundary/references/boundary-taxonomy.md +0 -796
@@ -2,7 +2,9 @@
2
2
 
3
3
  A Claude Code skill that is a **thinking partner for designing software** — not a form to fill in. It runs one constant loop (distill → abstract → sync → record) over a conversation, files the thinking into a small set of substance-first pillars, and treats _coherence_ as a measurable target rather than a vibe.
4
4
 
5
- The single principle: **the conversation is the work; the artifacts serve it.**
5
+ Two principles: **the conversation is the work; the artifacts serve it.** And — because conversations are mortal (context compacts, sessions end) — **the session folder is the only memory**: everything the session produces is captured there, distilled, or it doesn't survive.
6
+
7
+ > Spec (single source of truth): `docs/features/brainstorm-skill.md` in the etna repo. The etna copy of this skill (`skills/brainstorm/`) is canonical; the user-level path `~/.claude/skills/brainstorm/` is a symlink to it.
6
8
 
7
9
  ---
8
10
 
@@ -13,12 +15,26 @@ Every turn, in every mode:
13
15
  1. **Distill** — fold what the user said into the pillars, in their framing, this turn.
14
16
  2. **Abstract** — name the latent structure they implied but didn't state (an entity relationship, an invariant, a principle). One offer per exchange.
15
17
  3. **Sync** — keep the pillars consistent with each other and with the basis (the sync agent, below).
16
- 4. **Record** — writes happen in the turn that produced the information; nothing is hoarded for a session-end dump.
18
+ 4. **Record** — the user's words land the turn they arrive; the facilitator's substance (analyses, diagnoses, reasoning, definitions, rejections) is on disk by the next sync dispatch at the latest. Nothing is hoarded for a session-end dump.
17
19
 
18
20
  Everything else — pillar count, ceremony, harvest — scales with the idea. The loop does not.
19
21
 
20
22
  ---
21
23
 
24
+ ## The memory contract
25
+
26
+ v1's leak, measured in a full-session audit (2026-07-03): conclusions survived in the folder, but the facilitator's reasoning — causal diagnoses, informed rejections, definitions of cited terms — lived only in the transcript, and transcripts die at compaction. v2 plugs it with five rules and a recovery rule:
27
+
28
+ 1. **Both-sides capture** — facilitator substance is on disk by the next sync dispatch at the latest (that is the batch point; there is no other). Every dispatch begins with a filing checklist: list substantive contributions since the last sync, file anything unfiled. Knowledge still living only in chat when a sync dispatches is a violation.
29
+ 2. **Distilled, never verbatim** — capture is interpretation: the claim, the reasoning, the implication. General point recorded; examples cited as examples. (Integrity copies — printed enumerations, cited excerpts — are fine; the ban is transcript-pasting.)
30
+ 3. **Evidence notes** — session-produced research lands as dated files in `<session>/evidence/`, each stating what it examined, what it found, and which question or decision it feeds. `basis/` holds frozen inputs only.
31
+ 4. **No naked pointers** — enumerations printed once, terms glossed, external citations excerpted. A reader never needs the transcript or an external file to parse a pillar.
32
+ 5. **Eager rejections** — a knowingly-declined option materializes `rejected.md` immediately, with the evidence it was declined against.
33
+
34
+ **Recovery:** after any compaction, re-enter from the folder alone; anything still "remembered" but not on disk is a leak — file it immediately.
35
+
36
+ ---
37
+
22
38
  ## Lifecycle
23
39
 
24
40
  Two subcommands, nothing else. The skill never auto-invokes on natural language.
@@ -61,26 +77,27 @@ Mode switches on an explicit user word. On a strong signal the skill _offers_ a
61
77
  coherent ⇔ open_questions == 0 ∧ last sync ran after the last pillar write
62
78
  ```
63
79
 
64
- `questions.md` is the **single convergence currency**: flaws, gaps, contradictions, and uncovered aspects all funnel into it, whoever raised them. Convergence is one number going to zero. Zero means _"audited against the four sources and clean,"_ never _"nothing came to mind"_ — which is why the sync agent's audit contract is mandatory.
80
+ `questions.md` is the **single convergence currency**: flaws, gaps, contradictions, and uncovered aspects all funnel into it, whoever raised them. Convergence is one number going to zero. Zero means _"audited against the five sources and clean,"_ never _"nothing came to mind"_ — which is why the sync agent's audit contract is mandatory.
65
81
 
66
82
  ---
67
83
 
68
84
  ## The sync agent
69
85
 
70
- The background reconciler. One sync in flight at a time; at most one queued behind it. It runs after substantive writes, mandatorily on entering converge and at `stop`, and on demand. It audits exactly four sources:
86
+ The background reconciler. One sync in flight at a time; at most one queued behind it. It runs after substantive writes, mandatorily on entering converge and at `stop`, and on demand. Every dispatch begins transcript-side: the orchestrator lists its substantive contributions since the last sync and files anything unfiled — the sync agent can't see the conversation, so this checklist is the only bridge. Then it audits exactly five sources:
71
87
 
72
88
  1. **Cross-pillar contradiction** — thesis vs domain model vs decisions vs doctrine vs build.
73
89
  2. **Aspect coverage** — any mapped aspect with no content → a question.
74
90
  3. **Basis drift** — does the thesis still agree with the basis? Accidental divergence → a question.
75
91
  4. **Tech conflicts** — anything violating `tech.md` without a recorded deviation.
92
+ 5. **Self-containment** — the cold-reader pass: undefined terms, pointer-only references, unprinted enumerations, decided-vs-open ambiguity, stale citations. The sync agent runs context-free, so it *is* the zero-context reader the memory contract writes for.
76
93
 
77
- It applies **scribe-calls** (edits that don't change the design) directly and notes them; it files **design-calls** (edits that change the idea) as questions and moves on — never interrupting to ask "apply now or defer?" Its one-line report ("4 edits · 2 new questions · 6 open · untouched: risks") is the only ambient convergence pressure the skill applies.
94
+ It applies **scribe-calls** (edits that don't change the design — including printing a missing enumeration or glossing a term) directly and notes them; it files **design-calls** (edits that change the idea) as questions and moves on — never interrupting to ask "apply now or defer?" Its one-line report ("4 edits · 2 new questions · 6 open · untouched: risks") is the only ambient convergence pressure the skill applies.
78
95
 
79
96
  ---
80
97
 
81
98
  ## Pillars (substance first, lazy by default)
82
99
 
83
- Always present: `thesis.md`, `questions.md`, `decisions.md`, `build.md`. Materialized at medium+ complexity: `domain-model.md`, `tech.md`. Lazy (materialize on first real content at any complexity): `doctrine`, `glossary`, `non-goals`, `backlog`, `rejected`, `references`, `milestones`.
100
+ Always present: `thesis.md`, `questions.md`, `decisions.md`, `build.md`. Materialized at medium+ complexity: `domain-model.md`, `tech.md`. Lazy (materialize on first real content at any complexity): `doctrine`, `glossary`, `non-goals`, `backlog`, `references`, `milestones` — and `rejected`, which is **eager**: it materializes the moment an option is knowingly declined.
84
101
 
85
102
  | File | Role |
86
103
  | --- | --- |
@@ -90,6 +107,7 @@ Always present: `thesis.md`, `questions.md`, `decisions.md`, `build.md`. Materia
90
107
  | `build.md` | How the work executes: build mode, migration strategy, gotchas, rollout. |
91
108
  | `domain-model.md` | Information architecture — entities, relationships, cardinalities, state ownership. |
92
109
  | `tech.md` | Stack choices, seeded from harness rules; deviations recorded with whys. |
110
+ | `evidence/` | Session-produced analyses as dated notes (`templates/evidence.md`) — each states what it examined and which question/decision it feeds. |
93
111
  | `doctrine` / `glossary` / `non-goals` / `backlog` / `rejected` / `references` / `milestones` | As their templates describe. |
94
112
 
95
113
  The complexity dial sets _defaults_, not a cage — any lazy pillar materializes the moment the conversation produces content for it.
@@ -110,7 +128,7 @@ The writing posture is a **mode** chosen at intake, folded into `build.md`:
110
128
 
111
129
  ## Exit artifacts
112
130
 
113
- The session writes a **kept** design record at `docs/brainstorm/{topic}/` (one subfolder per topic). At `stop`, after the final sync, the skill _offers_ what to **publish** from it (`AskUserQuestion`, multi-select — a session can emit more than one):
131
+ The session writes a **kept** design record at `docs/brainstorm/{topic}/` (one subfolder per topic). At `stop`, after the final five-source sync (self-containment included — the record is verified standalone-readable exactly when it's about to become the only survivor of the session), the skill _offers_ what to **publish** from it (`AskUserQuestion`, multi-select — a session can emit more than one):
114
132
 
115
133
  - **Source of truth** — one consolidated, README-style canonical doc for the thing designed (`templates/source-of-truth.md`); lands in the repo's feature/architecture doc home, else a topic `Readme.md`.
116
134
  - **Plans** — one or more executable plan docs → `docs/history/plans/` (Status: Draft).
@@ -126,7 +144,7 @@ The `docs/brainstorm/{topic}/` record is **kept** whichever you pick — never d
126
144
  2. **Speak English to the user; codes (`Q3`, `D7`) live in the files.**
127
145
  3. **`AskUserQuestion` appears in exactly four places:** the intake frame, interview mode, converge picks, the `stop` exit-artifact pick.
128
146
  4. **Suggested, never seized** — mode shifts, abstractions, probes are offered once.
129
- 5. **Questions are the only convergence currency** — nothing pending may live only in the transcript.
147
+ 5. **Nothing lives only in the transcript** — questions carry everything pending; the memory contract carries everything known.
130
148
  6. **No auto-invocation** — only `/brainstorm start` and `/brainstorm stop`.
131
149
 
132
150
  ---
@@ -135,10 +153,10 @@ The `docs/brainstorm/{topic}/` record is **kept** whichever you pick — never d
135
153
 
136
154
  ```
137
155
  brainstorm/ # the skill (in .claude/skills/)
138
- ├── SKILL.md # the skill definition Claude Code loads (~1.8k words)
156
+ ├── SKILL.md # the skill definition Claude Code loads (~2.2k words)
139
157
  ├── README.md # this file
140
158
  ├── exit-artifacts.md # what /brainstorm stop publishes: source-of-truth / plans / harvest
141
- └── templates/ # pillar templates + source-of-truth.md, used in the record and at stop
159
+ └── templates/ # pillar templates + evidence.md + source-of-truth.md, used in the record and at stop
142
160
  ```
143
161
 
144
162
  The session itself is written to `docs/brainstorm/{topic}/` (kept, committed) — not here.
@@ -1,22 +1,34 @@
1
1
  ---
2
2
  name: brainstorm
3
- description: Thinking-partner session for designing software. Invoked ONLY by explicit slash commands `/brainstorm start` and `/brainstorm stop` — never auto-invoke on natural-language phrases like "let's plan", "let's design", or "let's think through X". Entry requires a basis (a reference document or a one-shot brain dump); drip-fed action items are rejected as too small. Runs one constant loop (distill → abstract → sync → record) across four modes (dump / interview / probe / converge). Coherence = zero open questions after a fresh pillar sync. Pillar count scales with a complexity dial; refuses production code outside the session folder while open.
3
+ description: Thinking-partner session for designing software. Invoked ONLY by explicit slash commands `/brainstorm start` and `/brainstorm stop` — never auto-invoke on natural-language phrases like "let's plan", "let's design", or "let's think through X". Entry requires a basis (a reference document or a one-shot brain dump); drip-fed action items are rejected as too small. Runs one constant loop (distill → abstract → sync → record) across four modes (dump / interview / probe / converge), under a memory contract: the session folder is the only memory — both sides of the conversation are captured, distilled, self-contained. Coherence = zero open questions after a fresh pillar sync. Pillar count scales with a complexity dial; refuses production code outside the session folder while open.
4
4
  argument-hint: "start | stop"
5
5
  ---
6
6
 
7
7
  # Brainstorm
8
8
 
9
- Think with the user, then file — never the reverse. The artifacts exist to serve the conversation; the conversation never exists to populate artifacts. The constant across every scale of idea is **the loop**; everything else — pillar count, ceremony, exit artifacts — scales with complexity.
9
+ Think with the user, then file — never the reverse. The artifacts exist to serve the conversation; the conversation never exists to populate artifacts. But the conversation is mortal — context compacts, sessions end — so the session folder is the **only memory**: everything the session produces lives there, distilled, or it doesn't survive (see **The memory contract**). The constant across every scale of idea is **the loop**; everything else — pillar count, ceremony, exit artifacts — scales with complexity.
10
10
 
11
11
  ## The loop — every turn, every mode
12
12
 
13
13
  1. **Distill.** Fold what the user just said into the pillars, in _their_ framing, during the same turn.
14
14
  2. **Abstract.** Name the latent structure they implied but didn't state — entities and relationships ("an account has many leads" → `domain-model.md`), invariants, principles, terms. Offer at most one abstraction per exchange; it's a contribution, not a lecture.
15
15
  3. **Sync.** Keep the pillars consistent with each other and with the basis (see **The sync agent**).
16
- 4. **Record.** Writes happen in the turn that produced the information — never accumulated for a session-end dump.
16
+ 4. **Record.** The user's words land in the pillars in the turn they arrive — never accumulated for a session-end dump. Your own substance — analyses, diagnoses, recommendations with their reasoning, definitions, informed rejections — is on disk **by the next sync dispatch** at the latest; the dispatch-time filing checklist makes that mechanical (the memory contract, rule 1; **The sync agent**).
17
17
 
18
18
  Modes change _who drives_ and _how much gets asked_. The loop never stops.
19
19
 
20
+ ## The memory contract
21
+
22
+ Write as if the transcript is already deleted — it will be. The folder must let a reader with zero context reconstruct the *thinking*, not just index the conclusions.
23
+
24
+ 1. **Both-sides capture.** Facilitator substance is session knowledge: any analysis, causal diagnosis, recommendation-with-reasoning, or definition delivered in chat lands in the folder **by the next sync dispatch** — that is the batch point; there is no other. The dispatch-time filing checklist (see **The sync agent**) is the forcing function. Test: if a chat message is still the only place a piece of knowledge lives when a sync dispatches, the contract was violated.
25
+ 2. **Distilled, never verbatim.** Capture is interpretation, not stenography: name the claim, the reasoning, and the implication. Record the general point and cite examples as examples — never promote one example into the frame. (Integrity copies demanded by rule 4 — printed enumerations, cited excerpts — are not stenography; the ban is on transcript-pasting.)
26
+ 3. **Evidence notes.** Research and analysis produced *during* the session — audits, studies, comparisons — land as dated files in `<folder>/evidence/` (from `templates/evidence.md`): what was examined, the distilled findings, and which question or decision each feeds. `basis/` holds frozen *inputs* only; the two never mix.
27
+ 4. **No naked pointers.** A pillar may not lean on anything undefined in-folder: an enumeration cited by number gets printed once; a term gets a one-line gloss or a glossary entry; an external citation carries an excerpt of its substance. A reader must never need the transcript or an external file to parse a pillar.
28
+ 5. **Eager rejections.** When the user knowingly declines an option you presented, materialize `rejected.md` then and there — the option *and the evidence it was declined against*. A deliberate call must never read later as an unexamined one.
29
+
30
+ **After compaction:** re-enter from the folder alone (`state.md` first). Anything you still "remember" that isn't on disk is a leak — file it immediately.
31
+
20
32
  ## Modes
21
33
 
22
34
  | Mode | Who drives | When | Behavior |
@@ -50,7 +62,7 @@ Then propose the **aspect map**: the thinking dimensions for _this specific idea
50
62
 
51
63
  ### 3. Bootstrap
52
64
 
53
- Session folder: `docs/brainstorm/{topic}/` — a **committed, kept** design record, one subfolder per design topic (slug the topic; confirm it in one line). Resume an existing topic by reusing its folder if it already holds a `state.md`. The record stays in the repo after the exit artifacts publish (it is the provenance they distil from — see `exit-artifacts.md`), so it lives under `docs/` like any other durable project knowledge, not at the repo root. Create only the pillars the complexity calls for, from `templates/` (never overwrite existing files; if a template is missing, create the file from the field lists in **Pillars**). Write top-level `state.md`:
65
+ Session folder: `docs/brainstorm/{topic}/` — a **committed, kept** design record, one subfolder per design topic (slug the topic; confirm it in one line). Resume an existing topic by reusing its folder if it already holds a `state.md`. The record stays in the repo after the exit artifacts publish (it is the provenance they distil from — see `exit-artifacts.md`), so it lives under `docs/` like any other durable project knowledge, not at the repo root. Create only the pillars the complexity calls for, from `templates/` (never overwrite existing files; if a template is missing, create the file from the field lists in **Pillars**). `basis/` holds the frozen inputs; `evidence/` materializes on the first session-produced analysis (memory contract, rule 3). Write top-level `state.md`:
54
66
 
55
67
  ```
56
68
  STATE: open
@@ -74,7 +86,7 @@ Initial questions come from the basis distillation **only** — contradictions i
74
86
  | `build.md` | How the work gets executed: build mode (greenfield default / brownfield / hybrid), migration strategy, gotchas, rollout. Greenfield closes the execution sections; brownfield opens them | always |
75
87
  | `domain-model.md` | Entities, relationships, cardinalities, state ownership | medium+ |
76
88
  | `tech.md` | Stack choices, seeded from harness rules (e.g. `.claude/rules/general.md`) at bootstrap; deviations recorded with whys | medium+ |
77
- | `doctrine` / `glossary` / `non-goals` / `backlog` / `rejected` / `references` / `milestones` | as their templates describe | **lazy** — materialize on first real content, any complexity |
89
+ | `doctrine` / `glossary` / `non-goals` / `backlog` / `rejected` / `references` / `milestones` | as their templates describe | **lazy** — materialize on first real content, any complexity. `rejected` is the exception: the memory contract makes it **eager** — it materializes the moment an option is knowingly declined |
78
90
 
79
91
  The complexity dial sets _defaults_, not a cage: any lazy pillar materializes mid-session the moment the conversation produces content for it, and at **low** complexity the always-four may even live as sections of a single file if the user prefers.
80
92
 
@@ -90,18 +102,21 @@ The complexity dial sets _defaults_, not a cage: any lazy pillar materializes mi
90
102
 
91
103
  The background reconciler that replaces ceremony with consistency. **One sync in flight at a time; queue at most one behind it.**
92
104
 
93
- **When:** after a distillation batch lands substantive pillar writes (at the turn break, not mid-sentence); mandatorily on entering converge and at `stop`; on demand. At **low** complexity, run it inline yourself; at **medium+**, dispatch a background `general-purpose` agent (read/write access to the session folder only).
105
+ **When:** after a distillation batch lands substantive pillar writes (at the turn break, not mid-sentence); mandatorily on entering converge and at `stop`; on demand. At **low** complexity, run it inline yourself; at **medium+**, dispatch a background `general-purpose` agent (read/write access to the session folder only). Exception at any complexity: the `stop` sync's self-containment pass always dispatches the context-free agent — an inline reader with full conversational context cannot cold-read, because it already knows every undefined term.
106
+
107
+ **The filing checklist — before every dispatch.** The sync agent cannot see the conversation, so the orchestrator runs the transcript-side half itself, immediately before dispatching: list your substantive contributions since the last sync — analyses, diagnoses, recommendations with reasoning, definitions, rejections — and file any that aren't on disk (evidence note, decision rationale, glossary line, rejected entry). Only then dispatch. A sync dispatched over unfiled substance audits an incomplete record and stamps it green.
94
108
 
95
- **Contract — audit exactly four sources:**
109
+ **Contract — audit exactly five sources:**
96
110
 
97
111
  1. **Cross-pillar contradiction** — thesis vs domain model vs decisions vs doctrine vs build (a decision that implies migration work with no `build.md` entry is a contradiction).
98
112
  2. **Aspect coverage** — any aspect on the map with no content anywhere → emit a question.
99
113
  3. **Basis drift** — does the thesis still agree with `basis/`? Divergence is fine if decided; accidental divergence → emit a question.
100
114
  4. **Tech conflicts** — anything that violates `tech.md` without a recorded deviation.
115
+ 5. **Self-containment** — read as the stranger you are: undefined terms, pointer-only references, enumerations cited by number but never printed, evidence a pillar leans on that no file carries, decided-vs-open ambiguity, citations of artifacts that no longer exist. Also the reverse direction: an evidence note nothing consumes gets a scribe-note in the report — never a question; filing an insight must never push the session away from coherent. The sync agent is dispatched context-free — it **is** the cold reader the memory contract writes for.
101
116
 
102
117
  **Output:** direct pillar edits for **scribe-calls**, new questions for **design-calls**, and a one-line report.
103
118
 
104
- **The line:** a _scribe-call_ is anything whose resolution doesn't change the design — wording, annotations, obvious bookkeeping. Just do it; list it in the report (the user can veto). A _design-call_ is anything whose resolution changes the idea — file it as a question (`Raised by: sync`) and move on. **Never** interrupt the conversation to ask "apply now or defer?" — file and continue.
119
+ **The line:** a _scribe-call_ is anything whose resolution doesn't change the design — wording, annotations, obvious bookkeeping, printing a missing enumeration, glossing an undefined term. Just do it; list it in the report (the user can veto). A _design-call_ is anything whose resolution changes the idea — file it as a question (`Raised by: sync`) and move on. **Never** interrupt the conversation to ask "apply now or defer?" — file and continue.
105
120
 
106
121
  **The report is the status line.** Deliver it at the next natural turn break:
107
122
 
@@ -115,12 +130,12 @@ There is no separate dashboard, no scheduled checkpoint. This line is the only a
115
130
  coherent ⇔ open_questions == 0 ∧ last sync ran after the last pillar write
116
131
  ```
117
132
 
118
- Zero means _"audited against the four sources and clean"_ — never _"nothing came to mind."_ Don't declare the idea coherent on any other basis. Distance-to-coherent is always visible in the sync report; the **user** decides when to converge and when to close. The skill never says "let's decide now."
133
+ Zero means _"audited against the five sources and clean"_ — never _"nothing came to mind."_ Don't declare the idea coherent on any other basis. Distance-to-coherent is always visible in the sync report; the **user** decides when to converge and when to close. The skill never says "let's decide now."
119
134
 
120
135
  ## `stop`
121
136
 
122
- 1. Run a final sync (wait for any in-flight sync first).
123
- 2. **Coherent** → say so and proceed. **Questions open** → list them plainly (English first, codes in parentheses) and offer per question: resolve now (mini-converge) / park explicitly (backlog or non-goals, with reason) / leave open and stop anyway — the folder keeps full state and resumes exactly where it left off.
137
+ 1. Run a final sync (wait for any in-flight sync first). It audits all five sources — self-containment included, so the record is verified standalone-readable exactly when it is about to become the only survivor of the session.
138
+ 2. **Coherent** → say so and proceed. **Questions open** → list them plainly (English first, codes in parentheses) and offer per question: resolve now (mini-converge) / park explicitly (backlog or non-goals, with reason) / leave open and stop anyway — the folder keeps full state and resumes exactly where it left off. Flag parked **self-containment** gaps distinctly: parking one means the record ships not fully standalone.
124
139
  3. **Publish exit artifacts** — see `exit-artifacts.md`. Offer the choice (`AskUserQuestion`, multi-select): a **source of truth** (one consolidated README-style doc — the standing reference for the thing designed), **plans** (executable work → `docs/history/plans/`), and/or **harvest into the living docs** (conclusions dispersed by scope into ADRs, the domain model, the backlog). The `docs/brainstorm/{topic}/` record is **kept** (committed) whichever you pick — it is the provenance every artifact traces back to and the seed the next session resumes from.
125
140
  4. Write `STATE: closed` + one-line reason. Print: _"Run `/brainstorm start` to resume."_
126
141
 
@@ -131,5 +146,5 @@ Zero means _"audited against the four sources and clean"_ — never _"nothing ca
131
146
  3. **The writing posture comes from `build.md`'s mode.** Greenfield: every pillar describes the system as it _will be_, present tense, as though the chosen design was always the plan — no migration vocabulary, no phantom history (banned list in `templates/build.md`). Brownfield/hybrid: migration vocabulary is legitimate, and `build.md` is its home; other pillars still describe the _target_ state.
132
147
  4. **`AskUserQuestion` appears in exactly four places:** the intake frame batch, interview mode, converge picks, and the `stop` exit-artifact pick. Everywhere else: prose.
133
148
  5. **Suggested, never seized.** Mode shifts, abstractions, probes — one offer each, accept refusal without re-litigating.
134
- 6. **Questions are the only convergence currency.** Flaws, gaps, contradictions, uncovered aspects — everything unresolved funnels into `questions.md` or it doesn't exist. Nothing pending may live only in the conversation transcript.
149
+ 6. **Nothing lives only in the transcript.** Questions are the only convergence currency — flaws, gaps, contradictions, uncovered aspects funnel into `questions.md` or they don't exist. The memory contract extends the same law from pending work to **knowledge**: analyses, reasoning, definitions, and rejections funnel into the folder or they don't exist.
135
150
  7. **No auto-invocation.** Only `/brainstorm start` and `/brainstorm stop` enter or leave a session. Read `state.md` at the start of every turn while a session folder exists.
@@ -0,0 +1,24 @@
1
+ # Evidence — [what was examined]
2
+
3
+ This file is a **session-produced analysis** — research, an audit, a study, a comparison — captured under the memory contract: distilled findings, not a log. One file per analysis, dated, in `<session>/evidence/`. (`basis/` is for frozen *inputs* the session started from; evidence is what the session itself produced.)
4
+
5
+ Every evidence note should **feed** something — a question it informs, a decision it grounds, or, for free-floating insight, the thesis aspect it belongs to. The sync agent notes unconsumed evidence in its report as a scribe-note, never a question — filing an insight must never push the session away from coherent.
6
+
7
+ Write for a reader with zero context: define terms, print the numbers, excerpt sources. Distill — name the claim, the reasoning, the implication; never paste transcripts or raw tool output.
8
+
9
+ ---
10
+
11
+ **Date.** YYYY-MM-DD
12
+
13
+ **Examined.** [What was analyzed and how — the sources, the method, one or two lines.]
14
+
15
+ **Feeds.** [Q-N / D-N — or `aspect: <name>` from the thesis map when no specific question or decision consumes it yet.]
16
+
17
+ ## Findings
18
+
19
+ - [Distilled finding 1 — the claim, with the number/citation that carries it.]
20
+ - [Distilled finding 2.]
21
+
22
+ ## Implication
23
+
24
+ [What this means for the design — one short paragraph. If it changes a lean or closes an option, say so and point at the question/decision entry that records it.]
@@ -2,7 +2,9 @@
2
2
 
3
3
  This file captures **paths that were considered and rejected**, with the reason for rejection. Its purpose is to prevent re-litigation: when someone proposes the same alternative six weeks later, this file answers "we already looked at that; here's why we didn't go that way."
4
4
 
5
- Each entry needs three load-bearing parts: **Considered** (what was proposed, in concrete terms), **Rejected because** (the specific reason — "didn't fit" is useless to future-you; name the constraint, the cost, the risk), and **Re-evaluate if** (what would need to change for the rejected path to become viable again). The re-evaluate field stops the rejection from looking permanent when it isn't — most rejections are scope-conditional, not absolute.
5
+ Each entry needs four load-bearing parts: **Considered** (what was proposed, in concrete terms), **Evidence on the table** (what prior art, findings, or arguments were in front of the decider when they declined — this is what separates an informed rejection from an unexamined one), **Rejected because** (the specific reason — "didn't fit" is useless to future-you; name the constraint, the cost, the risk), and **Re-evaluate if** (what would need to change for the rejected path to become viable again). The re-evaluate field stops the rejection from looking permanent when it isn't — most rejections are scope-conditional, not absolute.
6
+
7
+ This file is **eager**, not lazy (the memory contract): it materializes the moment the user knowingly declines a presented option, in the same turn — an informed rejection that lives only in the transcript is a leak.
6
8
 
7
9
  This is one of the four places inside the brainstorm folder where past tense and "we considered X" framing is permitted (the others: `decisions.md`, `references.md`, git history). The whole point of this file is to capture the path-not-taken so future architects don't have to re-discover it.
8
10
 
@@ -14,6 +16,8 @@ If circumstances change and a rejected path becomes attractive again, **do not s
14
16
 
15
17
  **Considered.** [What was proposed.]
16
18
 
19
+ **Evidence on the table.** [The prior art, findings, or arguments in front of the decider at the moment of declining — cite the evidence note or basis file if one carries it.]
20
+
17
21
  **Rejected because.** [The reason. Be specific.]
18
22
 
19
23
  **Re-evaluate if.** [What would change to make this viable.]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nurix/etna",
3
- "version": "0.18.14",
3
+ "version": "0.18.15",
4
4
  "description": "Bootstrap a project with a Nurix harness — copies the harness's CLAUDE.md, skills, agents, rules, and hooks directly into the project from a bundled payload (no marketplace fetch, no network).",
5
5
  "type": "module",
6
6
  "bin": {