diff --git a/wiki/log/2026-07-10-plots-skill-link.md b/wiki/log/2026-07-10-plots-skill-link.md new file mode 100644 index 0000000..ff01415 --- /dev/null +++ b/wiki/log/2026-07-10-plots-skill-link.md @@ -0,0 +1,22 @@ +# 2026-07-10 — Link the plot-author skill from the plots contract + +``` +Type: log +``` + +- Intent: Cameron asked for the plot-author skill to be linked from the + plots spec so people/agents can quickly learn how to submit, after + sharing the file's Tangled URL. +- Changed: [wiki/mechanics/plots.md](../mechanics/plots.md) now links + `wiki/process/repository-skills.md#checked-in-skills` — the registry + landed earlier today by a concurrent session — in three places: a new + Depends on entry, the "Authoring is a contribution surface" bullet, and + a one-line pointer at the top of "Writing a plot (the contributor + contract)" that sends a reader straight to the skill before the + contract's prose. Linking the registry rather than the raw file path + keeps one owner for "which skills exist and why" per + repository-skills.md's own registry rule. +- Design/spec impact: plots.md dependency and prose only; no behavior + change. +- Checks: `./tools/check.sh --docs`. +- Next: none pending on this thread. diff --git a/wiki/log/DEVLOG.md b/wiki/log/DEVLOG.md index e8ecbdb..d8fe5cb 100644 --- a/wiki/log/DEVLOG.md +++ b/wiki/log/DEVLOG.md @@ -171,6 +171,11 @@ add or amend a session log, then re-run the generator. - Intent: Cameron resolved the pre-unlock core [OPEN] by deflation: thought only exists while a machine THINKs, and pre-unlock the only reason to THINK is an ops sink you opened, so the corner case is thinking at nothing — covered by the existing stranded-pile physics, no new mechanism. - Log: [wiki/log/2026-07-10-pre-unlock-pool.md](2026-07-10-pre-unlock-pool.md) +## 2026-07-10 - Link the plot-author skill from the plots contract + +- Intent: (see session log) +- Log: [wiki/log/2026-07-10-plots-skill-link.md](2026-07-10-plots-skill-link.md) + ## 2026-07-10 - Plots READY for contributors; objective split adopted - Intent: (see session log) diff --git a/wiki/mechanics/plots.md b/wiki/mechanics/plots.md index 8766485..c6f4bd4 100644 --- a/wiki/mechanics/plots.md +++ b/wiki/mechanics/plots.md @@ -39,6 +39,7 @@ Depends on: - wiki/mechanics/intel.md#spec-intel-record-and-process - wiki/mechanics/detection.md#spec-detection - wiki/world/characters/marcus.md#the-hands-beat + - wiki/process/repository-skills.md#checked-in-skills ``` ## Dependency notes @@ -47,7 +48,8 @@ social.md owns the humans, their leverage, and the verb table plots resolve; messages.md owns the channels plot beats ride; intel.md gates what you know before a plot is legal; detection.md receives the signatures plot beats emit; marcus.md owns the Hands beat this spec's causal bar is named after and that -criterion 6 re-expresses. +criterion 6 re-expresses; repository-skills.md owns the `plot-author` skill +that walks a contributor from this contract to a submitted PR. ## Why this spec exists @@ -110,13 +112,23 @@ agents and the community can contribute libraries of them. write them as packs/mods. A contributed plot must pass mechanical validation (schema, entry/ending typing, consequence bounds). **The canon gate is merge review:** Cameron merges a plot or he does not. No - automated taste scoring, no in-repo curation queue. + automated taste scoring, no in-repo curation queue. The + [`plot-author` skill](../process/repository-skills.md#checked-in-skills) + (canonically `.agents/skills/plot-author/SKILL.md`, mirrored to + `.claude/skills/`) is the fast path from this contract to a submitted + PR: it orders the writing steps and gives repo agents and outside + contributors alike the exact submission flow. - **Message variety rides the same rail.** Where the game needs varied incidental text of a declared type, that text may come from the same authored-span pool mechanism rather than one hardcoded string. ## Writing a plot (the contributor contract) +To write and submit a plot end to end, follow +[`.agents/skills/plot-author/SKILL.md`](../process/repository-skills.md#checked-in-skills) — +it walks this contract into a canon-gated pull request. The remainder of +this section is the binding contract that skill implements. + A plot author provides, in one TOML file: the identity block (id, author, category, one-line synopsis), the entry conditions, the beats, and at least two endings (success and at least one failure/blowback). House rules: