@design-intelligence/ghost 0.20.0 → 0.22.0

package/dist/scan/templates.js

@@ -1,10 +1,10 @@
 import { GHOST_FINGERPRINT_PACKAGE_SCHEMA } from "#ghost-core";
 import { GHOST_EVENTS_FILENAME, LEGACY_PULL_HISTORY_FILENAME, } from "./constants.js";
-import { createSteeringTemplate } from "./steering-template.js";
-function manifestFile() {
+import { loadPackedPayload, loadPayloadFile } from "./packed-payloads.js";
+function manifestFile(cover) {
     return {
         relativePath: "manifest.yml",
-        content: `schema: ${GHOST_FINGERPRINT_PACKAGE_SCHEMA}\nid: local\n`,
+        content: `schema: ${GHOST_FINGERPRINT_PACKAGE_SCHEMA}\nid: local\n${cover ? `cover: ${cover}\n` : ""}`,
     };
 }
 /**
@@ -20,16 +20,17 @@ function gitignoreFile() {
 }
 /**
  * The minimal starter: a manifest, a package-level glossary declaring the
- * starter kind vocabulary, and a package-root `index.md` node. Additional
+ * starter kind vocabulary, and a package-root `index.md` cover. Additional
  * truths are plain markdown nodes; optional material locators live on the node
  * that explains them. Checks are opt-in via `ghost checks init`.
  */
 const MINIMAL_TEMPLATE = {
     name: "minimal",
-    description: "Minimal node package: manifest + glossary + a starter index node.",
-    files() {
+    description: "Minimal node package: manifest + glossary + a starter cover node.",
+    async files() {
+        const medianFile = await medianTemplateFile();
         return [
-            manifestFile(),
+            manifestFile("index"),
             gitignoreFile(),
             {
                 relativePath: "glossary.md",
@@ -39,9 +40,9 @@ kinds:
   - name: condition
   - name: exemplar
   - name: anti-goal
+  - name: cliche
   - name: asset
   - name: pattern
-#  - { name: provocation, posture: wild, purpose: a deliberate provocation past the fingerprint — surfaced only on request }
 ---
 
 # principle
@@ -63,6 +64,13 @@ What this brand must never look, sound, or feel like — named generic patterns
 and rejected neighbors. Always-on, like a principle, but stated as the thing
 to steer away from.
 
+# cliche
+
+The defaults a generative model falls back on when no brand is steering it.
+These are nobody's brand. Each entry pairs the tired move with the honest
+replacement. Gather before styling anything greenfield; enforced by paired
+checks at review.
+
 # asset
 
 Material truth about concrete brand assets such as logos, illustrations, motion, imagery, or files.
@@ -82,18 +90,18 @@ Replace this placeholder prose with two things:
 
 **The non-negotiables.** The handful of truths that apply to every task, every
 medium, no matter what else is gathered — hard invariants, the anti-goals, the
-one-sentence stance. This node is the only one an agent is told to always pull,
-so anything that must never be missed belongs here (stated briefly; link out to
-the full node by id for depth).
+one-sentence stance. Anything that must never be missed belongs here, stated
+briefly; link out to the full node by id for depth.
 
 **How to read the rest.** What this fingerprint covers, how its kinds organize
 the corpus, and where the fingerprint deliberately stays silent — including, if
 you want one, a stricter silence posture ("when this fingerprint is silent on X,
 ask a human") that overrides the default proceed-provisionally behavior.
 
-\`index\` is an ordinary node in every mechanical sense — everything below the
-\`---\` is its body; the frontmatter above is the retrieval description. Its
-privilege is pure convention: the recipes tell agents to pull it first.
+\`index\` is this package's manifest-declared cover: \`ghost gather\` inlines its
+body before the menu and excludes it from selection. Its privilege comes from
+\`cover: index\` in \`manifest.yml\`, not from the filename. You may rename it;
+update the manifest's \`cover\` id at the same time.
 
 The glossary declares the kind vocabulary. A node's kind comes from its
 filename prefix: \`principle.density.md\` has kind \`principle\` and slug
@@ -102,13 +110,14 @@ When a truth is narrower, state the condition in the prose — the situation whe
 it applies — never a filing destination.
 `,
             },
+            medianFile,
         ];
     },
 };
 /**
  * The composition starter: everything in `minimal`, plus a worked composition
  * ladder — an invariants floor (`principle.composition`), one bound/open
- * pattern, and an index that teaches the convention. For teams whose
+ * pattern, and a cover that teaches the convention. For teams whose
  * fingerprint must steer *what agents build*, not only what they say.
  *
  * The ladder is an authoring convention, not a schema: patterns state what is
@@ -119,9 +128,10 @@ it applies — never a filing destination.
 const COMPOSITION_TEMPLATE = {
     name: "composition",
     description: "Composition starter: minimal files + an invariants floor and a worked bound/open pattern.",
-    files() {
+    async files() {
+        const medianFile = await medianTemplateFile();
         return [
-            manifestFile(),
+            manifestFile("index"),
             gitignoreFile(),
             {
                 relativePath: "glossary.md",
@@ -131,9 +141,9 @@ kinds:
   - name: condition
   - name: exemplar
   - name: anti-goal
+  - name: cliche
   - name: asset
   - name: pattern
-#  - { name: provocation, posture: wild, purpose: a deliberate provocation past the fingerprint — surfaced only on request }
 ---
 
 # principle
@@ -159,6 +169,13 @@ What this brand must never look, sound, or feel like — named generic patterns
 and rejected neighbors. Always-on, like a principle, but stated as the thing
 to steer away from.
 
+# cliche
+
+The defaults a generative model falls back on when no brand is steering it.
+These are nobody's brand. Each entry pairs the tired move with the honest
+replacement. Gather before styling anything greenfield; enforced by paired
+checks at review.
+
 # asset
 
 Material truth about concrete brand assets such as logos, illustrations, motion,
@@ -270,23 +287,86 @@ When a blessed render of this pattern exists, add an \`exemplar.*\` node with
 \`materials\` pointing at the screenshot and the implementation path.
 `,
             },
+            medianFile,
         ];
     },
 };
-const STEERING_TEMPLATE = createSteeringTemplate({
-    manifestFile,
-    gitignoreFile,
-});
+const SKELETON_FILE_ORDER = new Map([
+    "glossary.md",
+    "brand.md",
+    "cliche.median.md",
+    "foundation.composition.md",
+    "foundation.color.md",
+    "foundation.type.md",
+    "foundation.controls.md",
+    "foundation.layout.md",
+    "foundation.motion.md",
+    "foundation.voice.md",
+    "context.conversation.md",
+].map((path, index) => [path, index]));
+const SKELETON_TEMPLATE = {
+    name: "skeleton",
+    description: "Naked skeleton: a brand cover, foundation chapters with open questions, and the cliche floor.",
+    async files() {
+        const skeletonFiles = [
+            ...(await loadPackedPayload("skeleton")),
+            await medianTemplateFile(),
+        ];
+        skeletonFiles.sort((a, b) => (SKELETON_FILE_ORDER.get(a.relativePath) ?? Number.MAX_SAFE_INTEGER) -
+            (SKELETON_FILE_ORDER.get(b.relativePath) ??
+                Number.MAX_SAFE_INTEGER) ||
+            a.relativePath.localeCompare(b.relativePath));
+        return [manifestFile("brand"), gitignoreFile(), ...skeletonFiles];
+    },
+};
+async function medianTemplateFile() {
+    return {
+        relativePath: "cliche.median.md",
+        content: await loadPayloadFile("median", "cliche.median.md"),
+    };
+}
 const TEMPLATES = new Map([
     [MINIMAL_TEMPLATE.name, MINIMAL_TEMPLATE],
     [COMPOSITION_TEMPLATE.name, COMPOSITION_TEMPLATE],
-    [STEERING_TEMPLATE.name, STEERING_TEMPLATE],
+    [SKELETON_TEMPLATE.name, SKELETON_TEMPLATE],
 ]);
-export const DEFAULT_TEMPLATE_NAME = STEERING_TEMPLATE.name;
+const VESSEL_LIGHT_BODY = {
+    name: "vessel-light",
+    description: "Vessel's design language at full strength: corpus, tokens, fonts, refs, and checks.",
+    includesChecks: true,
+    async files() {
+        const payload = await loadPackedPayload("vessel-light");
+        payload.sort((a, b) => {
+            const ao = BODY_FILE_ORDER.get(a.relativePath);
+            const bo = BODY_FILE_ORDER.get(b.relativePath);
+            return ((ao ?? Number.MAX_SAFE_INTEGER) - (bo ?? Number.MAX_SAFE_INTEGER) ||
+                a.relativePath.localeCompare(b.relativePath));
+        });
+        // The payload carries its own manifest.yml (id stays `vessel-light`);
+        // only the gitignore is generated locally.
+        return [gitignoreFile(), ...payload];
+    },
+};
+/** Listing order for the body scaffold output: anchors first, then the rest. */
+const BODY_FILE_ORDER = new Map(["manifest.yml", "glossary.md", "index.md"].map((path, i) => [path, i]));
+const BODIES = new Map([
+    [VESSEL_LIGHT_BODY.name, VESSEL_LIGHT_BODY],
+]);
+/** Look up a registered init body by name. */
+export function getInitBody(name) {
+    return BODIES.get(name);
+}
+export function listInitBodies() {
+    return [...BODIES.keys()];
+}
+export const DEFAULT_TEMPLATE_NAME = SKELETON_TEMPLATE.name;
 /** Look up a registered init template by name. */
 export function getInitTemplate(name) {
-    if (name === "default")
-        return STEERING_TEMPLATE;
+    // `default` and `steering` are silent aliases for the skeleton starter:
+    // `default` for callers that never named a template, `steering` for
+    // callers pinned to the pre-skeleton default's name.
+    if (name === "default" || name === "steering")
+        return SKELETON_TEMPLATE;
     return TEMPLATES.get(name);
 }
 export function listInitTemplates() {

package/dist/scan/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/scan/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAoBhE,SAAS,YAAY;IACnB,OAAO;QACL,YAAY,EAAE,cAAc;QAC5B,OAAO,EAAE,WAAW,gCAAgC,eAAe;KACpE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa;IACpB,OAAO;QACL,YAAY,EAAE,YAAY;QAC1B,OAAO,EAAE,GAAG,qBAAqB,KAAK,4BAA4B,IAAI;KACvE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,gBAAgB,GAAsB;IAC1C,IAAI,EAAE,SAAS;IACf,WAAW,EACT,mEAAmE;IACrE,KAAK;QACH,OAAO;YACL,YAAY,EAAE;YACd,aAAa,EAAE;YACf;gBACE,YAAY,EAAE,aAAa;gBAC3B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChB;aACM;YACD;gBACE,YAAY,EAAE,UAAU;gBACxB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BhB;aACM;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,oBAAoB,GAAsB;IAC9C,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,2FAA2F;IAC7F,KAAK;QACH,OAAO;YACL,YAAY,EAAE;YACd,aAAa,EAAE;YACf;gBACE,YAAY,EAAE,aAAa;gBAC3B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ChB;aACM;YACD;gBACE,YAAY,EAAE,UAAU;gBACxB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BhB;aACM;YACD;gBACE,YAAY,EAAE,0BAA0B;gBACxC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BhB;aACM;YACD;gBACE,YAAY,EAAE,kCAAkC;gBAChD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BhB;aACM;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;IAC/C,YAAY;IACZ,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,GAAG,CAA4B;IACnD,CAAC,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC;IACzC,CAAC,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACjD,CAAC,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,IAAI,CAAC;AAE5D,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,iBAAiB,CAAC;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/scan/templates.ts"],"names":[],"mappings":"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"}

package/dist/skill-bundle/SKILL.md

@@ -34,10 +34,12 @@ true, and an agent reads the relevant truths before building.
   Guidance stays in prose.
 - A node's **kind** comes from its filename prefix (`principle.density.md` →
   kind `principle`). A bare name (`voice.md`) has no kind.
-- The **glossary** declares the kind vocabulary, what each kind means, and optional consumption posture: `steady` by default, `posture: wild` for truths that require explicit request, or `posture: guard` for review-critical anti-goals with positive replacement.
-- The starter `index.md` node (id `index`) is the human-curated front door:
-  by convention it carries the non-negotiables and reading posture, and agents
-  pull it first.
+- The **glossary** declares the kind vocabulary and what each kind means.
+- The manifest's `cover` names the node `gather` inlines above the menu every
+  time. It carries essence, temperature, and brand-only refusals. Admission
+  test: a violation visible in one element belongs in that element's chapter;
+  visible in one view, in the composition chapter; visible only across the
+  whole body of work, on the cover.
 - There is **no hierarchy, no inheritance, no edges**. Directories are for browsing
   only; the model reads a flat menu.
 - **Checks** are optional review assertions in a flat `.ghost/checks/*.md`
@@ -62,27 +64,27 @@ ghost pulse         # summarize local gather/pull events while tuning
 
 `gather` does no selection. It emits the menu and you read the ask against it,
 then pull the truths you judge relevant. Its header includes a coverage line —
-total nodes, nodes carrying concrete material, and guards — so an all-prose or
-unrouted fingerprint is visible before generation.
+total nodes and nodes carrying concrete material — so an all-prose
+fingerprint is visible before generation.
 
 Prefer `ghost pull` over reading files directly: it emits the same prose,
 inlines small local materials by default, turns binary materials into
-inspect-pointers, orders the packet for steering (`index`, concrete nodes,
-prose rules, guards), extracts Skeletons dead last, and appends structured
+inspect-pointers, orders the packet for steering (cover when selected, concrete nodes,
+prose rules), extracts Skeletons dead last, and appends structured
 events to `.ghost/.events` for local tuning.
 
 `review` does no grading. It assembles an advisory packet: touched files,
-matched material-backed nodes, matched guard nodes, offered checks, probe
+matched material-backed nodes, offered checks, probe
 evidence, coverage gaps, and the diff. The host agent renders findings.
 
 ## CLI verbs
 
 | Verb | Purpose |
 |---|---|
-| `ghost init` | Scaffold `.ghost/` with the steering starter: manifest, glossary, `index.md`, and demo nodes for stance, composition, anti-goals, patterns, exemplars, materials, and decisions. `--template minimal` writes only the small manifest/glossary/index starter. `--with checks` also adds the checks directory. |
+| `ghost init` | Scaffold `.ghost/` with the skeleton starter: manifest, glossary, a `brand.md` cover, foundation chapters, context nodes, and the cliche floor. `--template minimal` writes a smaller cover-led starter. `--with checks` also adds the checks directory. |
 | `ghost checks init` | Scaffold `.ghost/checks/` with an example review assertion. |
 | `ghost validate [file-or-dir]` | Validate manifest, nodes, material locators, check references, and glossary kind prefixes. |
-| `ghost gather [ask…] [--wild] [--format json]` | Emit the node menu for selection plus coverage line; log exposed ids. Default gather excludes wild kinds unless `--wild` is explicit. |
+| `ghost gather [ask…] [--format json]` | Emit the node menu for selection plus coverage line; log exposed ids. |
 | `ghost pull <id> [<id>…]` | Emit selected nodes' full bodies and materials in steering order; log selected/missed ids. |
 | `ghost review [--diff <path|->] [--base <ref>] [--format json] [--no-probes]` | Emit an advisory review packet for a diff (requires `.ghost/checks/`). |
 | `ghost export [--out <path>] [--no-checks] [--strict] [--format json]` | Package `.ghost/` as a portable brand artifact and report which material locators will not travel. |
@@ -109,10 +111,11 @@ against the unpacked package with `--package <dir>`.
 
 - Author or update the fingerprint: follow [references/capture.md](references/capture.md).
 - Author material-backed nodes: follow [references/blocks.md](references/blocks.md).
+- Choose which concrete code tiers the package carries: follow [references/concrete-tiers.md](references/concrete-tiers.md).
 - Choose the right human-agent authoring workflow: follow [references/authoring-scenarios.md](references/authoring-scenarios.md).
+- Adapt a starter (a body or the skeleton) to your brand: follow [references/adapting-a-starter.md](references/adapting-a-starter.md).
 - Gather applicable truths for a task: follow [references/recall.md](references/recall.md).
 - Shape a pre-generation brief: follow [references/brief.md](references/brief.md).
-- Explore deliberate provocations with wild nodes: follow [references/wild.md](references/wild.md).
 - Probe readiness before generating: follow [references/self-check.md](references/self-check.md).
 - Audit steering coverage: follow [references/steering-audit.md](references/steering-audit.md).
 - Understand the package shape: see [references/schema.md](references/schema.md).
@@ -127,7 +130,7 @@ conventions, but durable brand truth should be curated by the human.
 A silent fingerprint does not require stopping. Proceed from nearby product
 surfaces, local conventions, and ordinary reasoning when safe, and label that
 reasoning as provisional and non-Ghost-backed — unless the fingerprint itself
-declares a stricter silence posture (check the `index` node), which overrides
+declares a stricter silence posture (check the cover), which overrides
 this default. Ask a human before high-risk, irreversible, privacy, security,
 legal, or brand-defining choices.
 

package/dist/skill-bundle/references/adapting-a-starter.md

@@ -0,0 +1,104 @@
+---
+name: adapting-a-starter
+description: Transplant a starter fingerprint — a body like vessel-light or the naked skeleton — into your own brand, one procedure from manifest id to regenerated refs.
+handoffs:
+  - label: Validate the adapted package
+    command: ghost validate --format json
+    prompt: Does the adapted fingerprint validate, and did any pruned rule orphan a check reference?
+---
+
+# Recipe: Adapt A Starter Fingerprint
+
+**Goal:** turn an installed starter — a full body (`ghost init --body
+vessel-light`) or the naked skeleton (`ghost init`) — into *your* brand's
+fingerprint without shipping a self-contradicting package.
+
+The naked skeleton is factored by what must happen during adaptation:
+
+| Stratum | Files | On adaptation |
+| --- | --- | --- |
+| Cover | `brand.md` | Write it — essence in one paragraph, temperature, and brand-only refusals. Apply the admission test to every line: a violation visible in one element belongs in that element's chapter; visible in one view, in the composition chapter; visible only across the whole body of work, here. Keep a one-screen budget and delete every scaffolding sentence when real. |
+| Foundation | `foundation.*` | Answer each chapter's open section (`Palette`, `Typeface`, `Radius`, `Character`, `Warmth`), restate it as the brand's current answer, and edit misuse lists to the brand's real failure modes. |
+| Context | `context.*` | Add or re-tune after the open questions are answered; context nodes state only what inverts in a matching situation. |
+| Cliche floor | `cliche.*` | Prune — delete entries a foundation misuse list absorbs, delete the paired check flag with it, and replace generic entries with refusals only this brand makes. If a refusal passes the cover admission test, graduate it to `brand.md`. |
+| Materials and refs | `materials/*`, referenced implementations, refs | Add or regenerate so the prose has concrete material to inspect. |
+| Checks | `checks/*` | Keep paired with the nodes they enforce; delete or rewrite flags when their source rule changes. |
+
+Do the steps **in order and in one sitting** where possible. A half-adapted
+package is worse than an unadapted one: stale refs steer harder than any prose
+you rewrote, so stopping before refs and checks are current ships a fingerprint
+that contradicts itself.
+
+## The procedure
+
+1. **Change the manifest id.** Edit `id:` in `manifest.yml` to your brand's
+   name. This is deliberately first: it is the explicit act that marks the
+   adaptation as begun. Until it changes, the package honestly claims to be the
+   starter, and every consuming agent cites it as a starter default.
+2. **Write the cover.** Replace `brand.md` with the brand's essence in one
+   paragraph, the shared temperature of words and motion, and the refusals only
+   this brand makes. Test every line: a violation visible in one element moves
+   to that element's chapter; visible in one view, to the composition chapter;
+   only what shows solely across the whole body of work stays. Keep the cover
+   to one screen and delete every scaffolding sentence when it is real.
+3. **Answer the foundation chapters.** Walk each `foundation.*` node. Keep the
+   usage rules that describe the closed vocabulary; answer the open section as
+   the brand's current answer. Ask the human for undecided values; never
+   freehand a value and present it as brand-backed. Edit each misuse list to the
+   failures this brand actually needs to avoid.
+4. **Add or edit materials.** Record literal values where the implementation or
+   asset materials live, then add `materials` locators to the nodes that explain
+   them. Role names can stay stable while values change. The point is that a
+   realizing agent can inspect the same concrete source the prose governs.
+5. **Re-tune contexts.** Revisit each `context.*` node after the foundation
+   answers exist. Keep only inversions that apply in that situation; delete
+   generic foundation rules repeated there, and add new contexts only when a
+   task situation truly bends the defaults.
+6. **Prune `cliche.median`.** Each rule is a `###` heading section; delete the
+   whole section for every rule a foundation misuse list now absorbs or your
+   brand legitimately violates. Do not rewrite surviving measured defaults into
+   taste. Then run `ghost validate`: every check reference orphaned by a pruned
+   heading surfaces as its own warning — delete the paired flag and its
+   reference from the check.
+7. **Regenerate refs.** Exemplars dominate prose: a prose rule contradicted by a
+   stale ref loses. Rebuild each ref against the new values and chapter answers,
+   keep any annotation headers current, and make each ref demonstrate its closed
+   sets completely. If the starter shipped no refs, generate them now — a
+   fingerprint with no exemplars steers at half strength.
+8. **Rewrite checks and near-miss nodes.** For each answered foundation chapter,
+   name the failure mode one step away from the answer and its replacement. Put
+   pre-generation guidance in nodes and review assertions in `checks/`; never
+   leave a check that asserts an obligation no node states.
+9. **Re-run the checks, including against refs.** `ghost validate` for package
+   shape, then review the regenerated refs against the median and value checks
+   (stage the ref changes and run `ghost review`). The floor only holds if the
+   refs hold it too: a ref that trips a median flag will teach every future
+   generation the violation.
+
+## Consuming an unadapted starter
+
+Work does not block on adaptation. Before the procedure runs (or midway through
+it), cite starter content honestly:
+
+- Cover scaffolding and unanswered foundation sections: **provisional** — never
+  plain brand truth.
+- Foundation usage rules: **Ghost-backed starter structure** until the human
+  answers the open sections and edits the misuse lists.
+- Surviving median rules: **owner-backed after init** — Ghost stamps this
+  measured model truth into every initialized package; you own the pruning and
+  any adaptation thereafter.
+- Context nodes: **conditional** — read only when their situation matches, and
+  revisit them after the foundation answers change.
+- The manifest id tells you which state you are in: a starter id means
+  unadapted.
+
+## Never
+
+- Never leave cover scaffolding in a real fingerprint.
+- Never present your provisional value as the brand's answer.
+- Never leave stale refs alongside new values — regenerate or delete; a stale
+  exemplar outweighs rewritten prose.
+- Never prune a median rule without deleting its paired check flag, or keep a
+  check that asserts an obligation no node states.
+- Never pre-write the manifest id change into automation — it is the human's
+  act of ownership, the one step an agent should not take alone.

package/dist/skill-bundle/references/authoring-scenarios.md

@@ -79,14 +79,14 @@ says which.
 
 Counter-exemplars are as valuable as exemplars when they name the replacement.
 "We would never ship this; we would ship that instead" with artifacts attached
-usually yields a sharper guard than an hour of affirmative description. Avoid
+usually yields a sharper anti-goal than an hour of affirmative description. Avoid
 blacklist-only anti-goals: the rejected pattern should be purged from exemplars
 and enforced in review, not repeated as the model's main example.
 
 ## 4. Draft The Nodes
 
 Write the smallest useful set of nodes, each a purpose-coherent prose truth with
-a one-line `description`, named `<kind>.<slug>.md` (or a bare slug when no kind is present). Ask three questions of each body: why (the stance), with what
+a one-line `description`, named `<kind>.<slug>.md` (or a bare slug when no kind is present). Ask three questions of each node body: why (the stance), with what
 (the materials), and how it is assembled (the patterns). These are drafting
 prompts, not fields.
 
@@ -114,9 +114,7 @@ Two authoring decisions replace any notion of hierarchy:
 
 - **Kind** — declare the kind vocabulary in `glossary.md` and name each node
   `<kind>.<slug>.md` so its normative weight is clear. The glossary defines what
-  each kind means and how strongly it binds. Use `posture: guard` for
-  review-critical replacement nodes, `posture: wild` for opt-in provocations,
-  and the default steady posture for ordinary truths. Kinds are your choice;
+  each kind means and how strongly it binds. Kinds are your choice;
   Ghost ships no fixed vocabulary.
 - **Altitude** — state a truth at the level it is actually true. Universal → state
   it plainly. Narrower → name the situation that activates it, in the prose. Never
@@ -134,6 +132,45 @@ prefix is a declared glossary kind (undeclared → warning with a "did you
 mean" suggestion). Use ordinary Git review as the approval boundary: uncommitted
 edits are drafts; checked-in nodes are canonical.
 
+## Shapes Of A Useful Node
+
+The shapes below teach what steering prose looks like when it works. The
+examples use **Morrow Ledger**, a fictional bookkeeping product — teaching
+fiction for this recipe only, never content for a real corpus. Each shape is a
+pattern to imitate with the human's real truths.
+
+- **Stance as forced choices.** Not adjectives — decisions under pressure:
+  "Clarity beats momentum: write '3 invoices are 14+ days late', not 'Cash
+  flow needs attention.'" A stance earns its place when it rejects a plausible
+  wrong answer.
+- **Composition floor.** Hard invariants with numbers, holding unless a
+  narrower condition says otherwise: "Maximum three figures above the fold —
+  if there are four, demote one into details instead of shrinking type."
+- **Anti-goal as not-X-instead-Y.** The rejected default *and* its committed
+  replacement: "Not 'Revenue is up 24% 🎉' — instead 'July receipts are $4,820
+  higher than June; 2 invoices explain most of the change.'" A bare ban prunes
+  one path; the replacement commits another.
+- **Pattern as bound/open.** Say what is decided and what remains free:
+  "Bound: status line first, one sentence, ≤11 words; one primary next step
+  last. Open: evidence may be a table row or a two-item list." All bound is a
+  template; nothing bound is vibes.
+- **Annotated exemplar.** A concrete reference plus what it is normative for
+  and what is incidental: "Copy the square edge, measured evidence, and action
+  cost. Do not copy the exact amounts or dates." An unannotated exemplar
+  teaches its accidents as brand.
+- **Material inventory.** `materials` locates; prose explains meaning:
+  "`src/styles/tokens.css` should define the ink, ledger, amber, and paper
+  colors." Never duplicate API docs unless the API itself is the brand truth.
+- **Decision trace.** A worked tradeoff with the reversal condition: "We chose
+  visible evidence over shorter surfaces… Reverses when the evidence would
+  expose sensitive third-party details — then show the count only." Models
+  imitate reasoning as well as outputs.
+
+State the silence posture on the manifest-declared cover, which `gather`
+inlines for every task: when the fingerprint is silent, proceed provisionally
+from local conventions only when safe, and ask before brand-defining,
+irreversible, legal, privacy-sensitive, or high-risk choices.
+
 ## Never
 
 - Never derive brand truth from repo code alone; what the codebase repeats may

package/dist/skill-bundle/references/blocks.md

@@ -57,7 +57,7 @@ Neither is correct. A concrete block node is a deliberate trade, not a leak.
   reasoning, sources…) earns **one short prose body**. This is what the method is
   for.
 - The **composer middle** (card, table, form, sidebar…) is a call to weigh. Give
-  it a body when its arrangement carries a stance worth matching.
+  it a prose body when its arrangement carries a stance worth matching.
 
 If a primitive ever seems to need stance guidance, that is a signal it is doing
 a composer's job. Promote the pattern into a node; do not write a body on the

package/dist/skill-bundle/references/brief.md

@@ -9,9 +9,8 @@ A brief is an ephemeral steering packet for the generating pass. It is not a new
 schema and is never written back into `.ghost/`.
 
 1. Run `ghost gather <ask> --format json` and select against descriptions.
-2. Pull a small set: **3–5 nodes is normal; 10 is a bad selection** unless the
-   task is unusually broad. Always include `index` unless already read this
-   session.
+2. The cover is already in context. Pull a small set from the menu: **3–5 nodes
+   is normal; 10 is a bad selection** unless the task is unusually broad.
 3. Prefer concrete nodes: `materials`, substantial fenced examples, or a
    `## Skeleton`. If there is **no concrete material for this surface**, the
    readiness ceiling is **Yellow**.
@@ -42,8 +41,8 @@ Rules:
 
 - Do not add sections for every kind. Sections dilute instruction weight.
 - Treat `ghost pull` ordering as signal: stance first, concrete material next,
-  prose rules, guards late, Skeletons dead last.
+  prose rules, Skeletons dead last.
 - If a pulled Skeleton matches the surface, begin the artifact from it verbatim
   before filling.
-- Guards (`posture: guard`) are review-critical anti-goals: state the positive
-  replacement, not just the rejected pattern.
+- Anti-goals are review-critical: state the positive replacement, not just the
+  rejected pattern.