- {node.context}
+ {node.for}
{node.id === "brand" ? (
{" "}
diff --git a/apps/docs/src/pages/index.astro b/apps/docs/src/pages/index.astro
index ccad19e6..4ad44d2b 100644
--- a/apps/docs/src/pages/index.astro
+++ b/apps/docs/src/pages/index.astro
@@ -29,7 +29,7 @@ const steeringDiagnoses = [
signal: "delivery gap",
read: "the relevant guidance existed but did not reach the task",
repair:
- "add the node, sharpen its description, or inspect why it was skipped",
+ "add the node, sharpen its `for` payload, or inspect why it was skipped",
},
{
signal: "correction gap",
@@ -44,7 +44,7 @@ const guidanceExamples = [
label: "visual decision",
path: "pattern.crop-with-intent.md",
body: `---
-description: Photography. Gather when a composition uses a photo.
+for: Photography. Gather when a composition uses a photo.
materials:
- brand/photography/**
---
@@ -60,7 +60,7 @@ Reject cautious full-object framing and collages that avoid choosing a focal poi
label: "product pattern",
path: "condition.blocked-progress.md",
body: `---
-description: Blocked progress. Gather when someone cannot continue a task.
+for: Blocked progress. Gather when someone cannot continue a task.
materials:
- src/components/error-state/**
---
@@ -76,7 +76,7 @@ If the person cannot resolve the problem, state what happens next. Do not end on
label: "exact material",
path: "asset.color-roles.md",
body: `---
-description: Exact color roles and values. Gather before assigning color.
+for: Exact color roles and values. Gather before assigning color.
materials:
- src/styles/brand-tokens.css
---
@@ -245,12 +245,12 @@ Ink carries content. Signal marks selection. Correction marks review.
Gather shows the complete menu before the agent chooses. If useful
guidance does not reach the work, you can see whether the node was
- missing, its description was unclear, or the agent skipped it.
+ missing, its for payload was unclear, or the agent skipped it.
efficiency
- Gather represents every node with a compact ID and description.
+ Gather represents every node with a compact ID and for payload.
Pull loads the full prose and materials only for the selected
nodes. The agent sees the shape of the whole brand while keeping
generation context small and free of unrelated instructions.
diff --git a/docs/purposes.md b/docs/purposes.md
index 144d16c5..23fa624e 100644
--- a/docs/purposes.md
+++ b/docs/purposes.md
@@ -38,7 +38,7 @@ into folders is a browsing convenience only.
| `manifest.yml` | Schema version and package id; the package's anchor. |
| `glossary.md` | The author's dictionary: every term with defined meaning in the corpus. ghost ships no fixed vocabulary. |
| Prose nodes (`..md`, `.md`) | Durable brand guidance; each body answers why (the stance), with what (the materials), or how it is assembled (the patterns). Altitude lives in prose; narrower guidance names its condition. |
-| Node frontmatter | `context` (retrieval payload) and optional `materials` (explicit repo-relative file paths or supported external locators, with optional retrieval notes; see the schema reference for the supported schemes). |
+| Node frontmatter | `for` (retrieval payload) and optional `materials` (explicit repo-relative file paths or supported external locators, with optional retrieval notes; see the schema reference for the supported schemes). |
| `checks/` | Optional review assertions binding to nodes with `references`. Never a node source and never generation input. |
One resolution mechanism, read-only:
@@ -78,7 +78,7 @@ Two rules keep the reservation honest:
1. **Retrieval needs pushed into the shape.** When selection feels imprecise, the
temptation is to encode routing in data: proliferating filename kinds until
they become destinations, or turning the glossary into a dispatch table.
- *Fix: `context` is the retrieval payload; sharpen contexts, show the
+ *Fix: `for` is the retrieval payload; sharpen `for` payloads, show the
menu, let the agent pick.*
2. **Filing by destination.** A node authored as `for-emails.md` smuggles a
diff --git a/packages/context-control/README.md b/packages/context-control/README.md
index 6c67d860..d72c5117 100644
--- a/packages/context-control/README.md
+++ b/packages/context-control/README.md
@@ -6,9 +6,9 @@ measures whether the right guidance even makes it into context. Selection is
the unit. No generation, ever.
`ghost gather` does no filtering: the menu is always the whole catalog, and
-selection happens in the model's head against each node's `context`.
-So what this bench actually tests is whether contexts are good enough
-retrieval payloads — a node with a vague context is invisible at
+selection happens in the model's head against each node's `for` payload.
+So what this bench actually tests is whether `for` payloads are good enough
+retrieval payloads — a node with a vague `for` is invisible at
selection time no matter how good its body is.
## Run
@@ -30,15 +30,15 @@ else `ghost` on PATH).
## Screens
**package** — the catalog rendered as the selection surface the model
-sees: id, kind, context, material count, coverage line. Click a node to
-see its real `ghost pull` output in a drawer. Review contexts as
-retrieval payloads, not file contents; a node with no context is flagged
+sees: id, kind, `for` payload, material count, coverage line. Click a node to
+see its real `ghost pull` output in a drawer. Review `for` payloads as
+retrieval payloads, not file contents; a node with no `for` is flagged
as invisible.
**bench** — type an ask (or run the whole asks suite), fire N single-shot
selection trials, and read the heatmap: nodes × asks, each cell the
fraction of trials that selected the node. Solid column = confident
-context. Speckled = coin-flip. Empty row = dead node. Blue outline =
+`for` payload. Speckled = coin-flip. Empty row = dead node. Blue outline =
the ask's expected set. Scores above the map: consistency (mean pairwise
Jaccard), mean per-trial precision and recall, poison-selection rate, unknown
ids, and nodes ever selected.
diff --git a/packages/context-control/lib/model.mjs b/packages/context-control/lib/model.mjs
index ac00c733..f5336ea9 100644
--- a/packages/context-control/lib/model.mjs
+++ b/packages/context-control/lib/model.mjs
@@ -60,7 +60,7 @@ export function fakeModel() {
const selected = [];
for (const entry of menu) {
const nodeTokens = tokens(
- [entry.id.replaceAll(/[.-]/g, " "), entry.kind, entry.context]
+ [entry.id.replaceAll(/[.-]/g, " "), entry.kind, entry.for]
.filter(Boolean)
.join(" "),
);
@@ -101,7 +101,7 @@ function selectUser(ask, menu, cover) {
const flags = [entry.materials ? `${entry.materials} materials` : null]
.filter(Boolean)
.join(", ");
- return `- ${entry.id}${entry.kind ? ` [${entry.kind}]` : ""}${flags ? ` (${flags})` : ""}: ${entry.context ?? "(no context)"}`;
+ return `- ${entry.id}${entry.kind ? ` [${entry.kind}]` : ""}${flags ? ` (${flags})` : ""}: ${entry.for ?? "(no for payload)"}`;
});
const coverLine = cover
? `Cover already in context: ${cover.id}\n\n${cover.body}\n\n`
diff --git a/packages/context-control/ui/index.html b/packages/context-control/ui/index.html
index af6e1401..327ee9ef 100644
--- a/packages/context-control/ui/index.html
+++ b/packages/context-control/ui/index.html
@@ -126,7 +126,7 @@ context-control · selection is the unit