wherefore: add the slate skill and wire the sibling skills to it - #10
Merged
Conversation
Add a plan skill under /wherefore:plan for the wherefore/plan/ collection: one verb with four intents (open, advance, drop, read), spikes via an optional answers key, and the full P-NNN frontmatter contract. Open breaks work into checkboxes; advance and read tolerate prose-only bodies. Wire the siblings around it, read-only or hand-off, so plan stays the sole writer of plan/: - capture surfaces plan links for approval and hands off to plan (advance to close, open for implied work); it never writes plan/ and never auto-closes on inference. - ask surfaces spikes (answers) alongside open questions. - resolve reports unblocked and answered items and skips dropped ones. - supersede flags plan items whose decision_ref points at a retired decision, read-only. Driver suppression both directions (capture drives advance, plan drives resolve) prevents handoff loops. seed scaffolds plan/ and its README on a fresh repo. The frontmatter contract is documented consistently across the plan skill, capture, seed, AGENTS.md, and CLAUDE.md. Both project rules (no em dashes; never delete under a wherefore/ data dir) now appear in all five skills. Fix next-ID allocation in capture and plan to read the authoritative id from frontmatter instead of scanning filenames, which is how two Q-008s were allocated; renumber the newer duplicate (ibm-plex) to Q-011. Dogfood records: the capture-does-not-write-plan-items decision, plan items P-004 through P-010, and questions Q-010 and Q-011. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add the plan skill everywhere the README enumerates the plugin: the summary bullet, the skills list (open/advance/drop/read, owns plan/, hands off to capture and ask), the AGENTS.md workflow line, a Plan lifecycle note, and both directory trees. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The skill verb `plan` competed with Claude Code's built-in plan mode for triggering. Rename the verb to `slate`; the collection, the P-NNN scheme, the frontmatter contract, and every settled ruling stay exactly as they were (a verb and the collection it writes are allowed to diverge, as capture writes log/ and resolve writes questions/). - skills/plan/ -> skills/slate/: name, H1, and a description that leads with the collection (operating items in wherefore/plan/) with artifact-centered triggers and /wherefore:slate. - Update every sibling cross-reference (capture, ask, resolve, supersede) to slate, keeping the driver-suppression symmetry intact. - seed embed, CLAUDE.md, README.md, and the ROADMAP verb reference updated. - Dogfood: capture the rename as a decision; update P-004's text to slate. AGENTS.md is unchanged: it is the tool-neutral floor and names the collection, not the skill verb. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adding a fifth skill (slate) is an additive feature, so bump the minor version. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a first-class skill for the
wherefore/plan/collection and wires the existing skills around it. The skill was authored asplan; after review the verb was renamed toslateto stop it competing with Claude Code's built-in plan mode for triggering. The collection, theP-NNNscheme, and the frontmatter contract are unchanged: a verb and the collection it writes are allowed to diverge, the same waycapturewriteslog/andresolvewritesquestions/.The slate skill
One verb under
/wherefore:slate, four intents detected from the request:- [ ]checkboxes, never bulk-generate.todo -> doing -> done(reopening allowed), bumpupdatedon any write, hand off tocaptureon a human-drivendone.status: dropped, requires adropped_reasonordecision_ref, never deletes.plan/only, grouped by status.Spikes are supported via an optional
answers: Q-NNNkey (the semantic opposite ofquestion_ref), so an item investigating a question does not render as blocked.Sibling wiring
slatestays the sole writer ofplan/; the others are read-only or hand off:plan/, never auto-closes on inference).Driver suppression in both directions (capture drives slate advance, slate drives resolve) prevents handoff loops.
Docs and fixes
seedscaffoldsplan/and its README on a fresh repo.wherefore/data dir) now appear in all five skills.idfrom frontmatter instead of scanning filenames, which is how twoQ-008s were allocated. The newer duplicate was renumbered toQ-011.planorslate.Version
Plugin bumped
0.1.3 -> 0.2.0. A new skill is an additive feature, so it is a minor bump; theplan -> slaterename is not a public break because the skill was never in a released version.Dogfood records
This repo's own
wherefore/captures the work: thecapture-does-not-write-plan-itemsandrename-plan-skill-to-slatedecisions, plan items P-004 through P-010, and questions Q-010 (capture/supersede boundary) and Q-011.Validation
claude plugin validatepasses for the plugin and marketplace; JSON manifests parse; the four-intent dry-run ran against an out-of-repo scratch dir; zero em dashes; a whole-repo grep confirms no product reference to the skill asplan.🤖 Generated with Claude Code