@iowarp/clio-coder 0.4.6 → 0.4.8

package/library/skills/skill-marketplace.json

@@ -0,0 +1,507 @@
+{
+	"generatedBy": "pnpm run skills:pin",
+	"skills": [
+		{
+			"name": "ast-grep",
+			"description": "Structural code search with ast-grep rules: finds code by shape when grep on text is too noisy, and never rewrites it. Not for plain string or filename lookups; use grep or find.",
+			"triggers": [
+				"structural code search",
+				"ast-grep rule",
+				"find calls with this argument shape",
+				"find code inside a function",
+				"grep returns too much noise"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/ast-grep",
+			"version": "0.3.0",
+			"audit": "pass",
+			"category": "coding"
+		},
+		{
+			"name": "coding-standards",
+			"description": "Correct-by-construction TypeScript rules (errors as values, parse don't validate, illegal states unrepresentable, deep modules) for writing or refactoring TypeScript when the project has not pinned its own standards.",
+			"triggers": [
+				"TypeScript coding standards",
+				"errors as values",
+				"parse don't validate",
+				"illegal states unrepresentable",
+				"functional core imperative shell"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/coding-standards",
+			"version": "0.4.0",
+			"audit": "pass",
+			"category": "coding"
+		},
+		{
+			"name": "prototype",
+			"description": "Answers a design question with throwaway code: a clearly marked, runnable, no-persistence prototype whose verdict is kept and whose code is discarded. Not for pre-registered performance experiments; use experiment-protocol. Not for production implementation.",
+			"triggers": [
+				"throwaway prototype",
+				"mock up this UI",
+				"prototype this state model",
+				"sanity-check this logic",
+				"what should this UI look like"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/prototype",
+			"version": "0.4.0",
+			"audit": "pass",
+			"category": "coding"
+		},
+		{
+			"name": "tdd",
+			"description": "Builds a feature or fix test-first, red to green at pre-agreed public seams, one vertical slice at a time. Not for designing benchmark criteria; use experiment-protocol.",
+			"triggers": [
+				"test-driven development",
+				"write the test first",
+				"red green",
+				"build this test-first",
+				"reproduce the bug with a test"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/coding/tdd",
+			"version": "0.4.0",
+			"audit": "pass",
+			"category": "coding"
+		},
+		{
+			"name": "context-handoff",
+			"description": "Writes a durable, redacted, reference-not-copy handoff document when a session winds down or context is about to be compacted or lost, so the next session or agent can continue. Not for orienting at the start of a session; use context-prime.",
+			"triggers": [
+				"session handoff",
+				"notes for the next session",
+				"handoff to another agent",
+				"context is about to be lost",
+				"write a continuation brief"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/context/context-handoff",
+			"version": "0.5.1",
+			"audit": "pass",
+			"category": "context"
+		},
+		{
+			"name": "context-prime",
+			"description": "Orients a fresh session in a repository by loading the last handoff, git state, the project constitution, and active-work signals before acting. Not for writing the handoff; use context-handoff.",
+			"triggers": [
+				"prime this repository",
+				"catch me up",
+				"where were we",
+				"get up to speed",
+				"resume repository work after a break"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/context/context-prime",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "context"
+		},
+		{
+			"name": "branch-closeout",
+			"description": "Proves merged work on the canonical base, inspects and removes associated worktrees through Git, deletes local branches safely, and audits surviving repository refs. Not for creating worktrees; use worktree-create. Not for integrating branches; use worktree-merge.",
+			"triggers": [
+				"close out this branch",
+				"clean up merged branch",
+				"remove merged worktree",
+				"closeout branch",
+				"branch-closeout"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/branch-closeout",
+			"version": "0.1.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "file-ticket",
+			"description": "Turns something noticed mid-session into a tracker issue: captures evidence, dedups against existing issues, composes a labeled issue with acceptance criteria, confirms, and creates it via gh. Not for batch ticket creation from a PRD; use backlog. Not for diagnosing an existing issue; use fix-issue.",
+			"triggers": [
+				"file a ticket",
+				"open an issue for this",
+				"log this bug",
+				"ticket this behavior",
+				"create a tracker issue"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/file-ticket",
+			"version": "0.3.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "fix-issue",
+			"description": "Resolves a tracker issue end to end: fetches it, diagnoses only when the issue does not name the code, fixes test-first, and self-reviews against the acceptance criteria, leaving a verified uncommitted change. Not for filing; use file-ticket. Not for committing or PRs; use ship.",
+			"triggers": [
+				"fix issue 123",
+				"take this ticket",
+				"resolve the bug in issue",
+				"implement this tracker issue",
+				"fix a GitHub issue end to end"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/fix-issue",
+			"version": "0.3.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "resolve-merge-conflicts",
+			"description": "Resolves a merge, rebase, or cherry-pick stopped on conflicts by reconstructing both sides' intent, validating with the project's own checks, and completing the operation. Not for integrating many branches; use worktree-merge.",
+			"triggers": [
+				"merge conflict",
+				"fix these conflicts",
+				"finish the merge",
+				"finish the rebase",
+				"resolve conflict markers"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/resolve-merge-conflicts",
+			"version": "0.4.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "ship",
+			"description": "Ships finished work: writes one reviewed atomic commit, keeps maintainer branches local, or pushes a contributor branch to their fork and opens a PR only on explicit intent. Not for producing the change; use fix-issue.",
+			"triggers": [
+				"ship this",
+				"commit this",
+				"commit and open the PR",
+				"push and open a pull request",
+				"get this up for review"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/ship",
+			"version": "0.5.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "worktree-create",
+			"description": "Stands up one or more git worktrees for parallel work, each on its own branch with gitignored config copied in, dependencies installed, and a verified health check. Not for merging finished worktrees; use worktree-merge. Not for closeout; use branch-closeout.",
+			"triggers": [
+				"create a git worktree",
+				"set up worktrees for these branches",
+				"spin up parallel branches",
+				"prepare parallel worktrees"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/worktree-create",
+			"version": "0.6.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "worktree-merge",
+			"description": "Integrates finished worktree branches through one throwaway integration branch, testing after each merge and running the full suite before the main line moves, with exact rollback on failure. Not for creating worktrees; use worktree-create. Not for closeout; use branch-closeout.",
+			"triggers": [
+				"merge my worktrees",
+				"integrate these worktree branches",
+				"combine parallel branches",
+				"land finished worktrees"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/git/worktree-merge",
+			"version": "0.6.0",
+			"audit": "pass",
+			"category": "git"
+		},
+		{
+			"name": "clio-coder-dev",
+			"description": "Governs changes to Clio Coder's own source and harness (TUI, skills, agents, tools, prompts, domains): what may change freely, what needs explicit user intent, and how to change it without breaking the architecture. Not for verifying a change against the harness; use clio-coder-test.",
+			"triggers": [
+				"modify Clio Coder",
+				"change the Clio harness",
+				"edit Clio skills or agents",
+				"evolve Clio tools or prompts",
+				"Clio contribution boundary"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/clio-coder-dev",
+			"version": "0.4.0",
+			"audit": "pass",
+			"category": "meta"
+		},
+		{
+			"name": "clio-coder-test",
+			"description": "Verifies a Clio Coder source change against the current contract, smoke, boundary, and application test lanes, including temporary-state and local-provider harnesses. Not for deciding what may change; use clio-coder-dev.",
+			"triggers": [
+				"test Clio Coder",
+				"verify a Clio source change",
+				"run Clio contract tests",
+				"test ACP over stdio",
+				"Clio mock provider harness"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/clio-coder-test",
+			"version": "0.3.1",
+			"audit": "pass",
+			"category": "meta"
+		},
+		{
+			"name": "credentials",
+			"description": "Handles API keys, tokens, and facility credentials (kerberos tickets, globus and scheduler tokens, ssh agents, netrc) before a tool needs one, after an auth error, when a new secret is supplied, or when one may have leaked. Not for provider target configuration; use clio-coder auth and target settings.",
+			"triggers": [
+				"API key",
+				"credential missing",
+				"authentication error",
+				"permission denied",
+				"add a secret",
+				"secret leaked"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/credentials",
+			"version": "0.2.0",
+			"audit": "pass",
+			"category": "meta"
+		},
+		{
+			"name": "find-skills",
+			"description": "Finds published skills and prepares their Library installation for the operator when the user asks whether a capability exists as a skill. Not for authoring a new skill; use skill-craft.",
+			"triggers": [
+				"find a skill",
+				"is there a skill for this",
+				"install a skill",
+				"add an agent skill",
+				"search the skills marketplace"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/find-skills",
+			"version": "0.2.1",
+			"audit": "pass",
+			"category": "meta"
+		},
+		{
+			"name": "herdr",
+			"description": "Launches, drives, or inspects another agent or command in a Herdr pane, tab, or workspace, including a second Clio Coder instance; requires HERDR_ENV=1. Not for background work a plain shell or dispatch already covers.",
+			"triggers": [
+				"use Herdr",
+				"launch an agent in a Herdr pane",
+				"inspect a Herdr agent",
+				"start a second Clio Coder instance",
+				"drive a command in a Herdr workspace"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/herdr",
+			"version": "0.2.0",
+			"audit": "pass",
+			"category": "meta"
+		},
+		{
+			"name": "skill-craft",
+			"description": "Writes, reviews, or prunes a SKILL.md, judging whether its description, body, and length earn their cost. Not for packaging a workflow that just happened; use workflow-distiller.",
+			"triggers": [
+				"write a SKILL.md",
+				"create a new skill",
+				"improve this skill",
+				"why isn't this skill firing",
+				"prune a skill body"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/skill-craft",
+			"version": "0.3.1",
+			"audit": "pass",
+			"category": "meta"
+		},
+		{
+			"name": "archify",
+			"description": "Validated interactive system maps and diagrams as standalone HTML from a typed JSON spec, for one of five diagram types (architecture, workflow, sequence, dataflow, lifecycle). Use when the user asks to visualize architecture, a workflow, a call sequence, a data pipeline, or a state machine, or to map this repository. Not for ad hoc drawings or slide art, and not for Mermaid output; use the artifact tool for plain Markdown.",
+			"triggers": [
+				"architecture diagram",
+				"system map",
+				"map this repository",
+				"sequence diagram",
+				"data flow diagram",
+				"state machine diagram",
+				"visualize the architecture"
+			],
+			"sourceUrl": "https://github.com/tt-a1i/archify/tree/v2.16.0/archify",
+			"version": "0.1.0",
+			"audit": "pass",
+			"category": "planning",
+			"origin": "remote",
+			"overlay": "library/skills/planning/archify",
+			"exclude": ["test", "package-lock.json"]
+		},
+		{
+			"name": "architecture",
+			"description": "Decides the engineering approach for an intent in an interactive session: investigates, proposes two or three genuinely different approaches with trade-offs, recommends, lets the user decide, and writes the decision doc. Not a task-by-task plan; use cut-it. Not a multi-perspective debate; use design-council. Not product intent; use product-intent. Not a typed implementation handoff; use tech-spec.",
+			"triggers": [
+				"how should we build this",
+				"pick the stack",
+				"architecture for this feature",
+				"decide the engineering approach",
+				"compare architecture options"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/planning/architecture",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "planning"
+		},
+		{
+			"name": "backlog",
+			"description": "Turns a finished PRD or architecture doc into a ticket backlog of small stories with verifiable acceptance criteria, confirmed, then created as GitHub issues or in another configured tracker. Not for local sprint slicing into a SPRINT.md; use cut-it.",
+			"triggers": [
+				"create the stories",
+				"turn this PRD into issues",
+				"build the backlog",
+				"decompose this plan into tickets",
+				"create GitHub issues from this architecture"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/planning/backlog",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "planning"
+		},
+		{
+			"name": "prd",
+			"description": "Turns an idea into a product requirements document through a phase-gated interview, ending in PRD.md plus per-milestone prompt files ready to drive a coding agent. Not for the problem-first product thesis; use product-intent.",
+			"triggers": [
+				"write a PRD",
+				"spec this product out",
+				"define this feature",
+				"structure this product brain dump",
+				"create milestone prompts"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/planning/prd",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "planning"
+		},
+		{
+			"name": "product-intent",
+			"description": "Writes a problem-first product document for a greenfield effort: interviews for the problem, evidence, and a falsifiable hypothesis, with zero engineering decisions. Not for engineering decisions; use architecture. Not for turning a locked idea into milestone build prompts; use prd.",
+			"triggers": [
+				"why are we building this",
+				"write the product thesis",
+				"problem-first PRD",
+				"define a falsifiable product hypothesis",
+				"greenfield product intent"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/planning/product-intent",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "planning"
+		},
+		{
+			"name": "tech-spec",
+			"description": "Writes a typed call-stack architecture handoff: code-shaped contracts plus execution flows, implementation-ready for another engineer. User-invoked only. Not for weighing approaches or deciding the design; use architecture first.",
+			"triggers": [
+				"write a tech spec",
+				"typed call-stack handoff",
+				"code-shaped contracts",
+				"implementation-ready technical specification",
+				"specify execution flows"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/planning/tech-spec",
+			"version": "0.3.1",
+			"audit": "pass",
+			"category": "planning"
+		},
+		{
+			"name": "arxiv-literature",
+			"description": "Searches arXiv, summarizes or compares papers, and builds a compact literature survey as citation-ready, source-linked paper cards. Prefer the Researcher shadow agent for noisy multi-paper retrieval.",
+			"triggers": [
+				"search arXiv",
+				"summarize an arXiv paper",
+				"compare these papers",
+				"find recent research papers",
+				"build a literature survey"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/research/arxiv-literature",
+			"version": "0.5.1",
+			"audit": "pass",
+			"category": "research"
+		},
+		{
+			"name": "experiment-protocol",
+			"description": "Pre-registers a performance study, numerical comparison, parameter sweep, or benchmark: thresholds, tolerances, environment pins, and verdict conditions locked into the validation contract before any measurement. Not for diagnosing a stalled bug; use scientific-debugging.",
+			"triggers": [
+				"benchmark these implementations",
+				"pre-register a performance experiment",
+				"run a parameter sweep",
+				"define numerical tolerances",
+				"reproduce these results",
+				"compare solver accuracy"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/research/experiment-protocol",
+			"version": "0.3.1",
+			"audit": "pass",
+			"category": "research"
+		},
+		{
+			"name": "scientific-debugging",
+			"description": "Diagnoses stalled or cross-system failures and wrong, NaN, nondeterministic, or unexpectedly slow scientific results through falsifiable hypotheses across distinct fault classes, with evidence-cited verdicts before any fix. Not for designing benchmarks or pre-registered experiments; use experiment-protocol.",
+			"triggers": [
+				"wrong scientific results",
+				"nondeterministic HPC code",
+				"unexplained performance regression",
+				"diagnose NaNs",
+				"debug with falsifiable hypotheses",
+				"scientific root cause"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/research/scientific-debugging",
+			"version": "0.3.1",
+			"audit": "pass",
+			"category": "research"
+		},
+		{
+			"name": "scientific-modernization",
+			"description": "Modernizes, ports, rewrites, packages, or replaces established scientific software in independently validated stages against an external scientific oracle, settling compatibility and upstream stewardship before calling it complete. Not for an isolated benchmark; use experiment-protocol. Not for diagnosing wrong results; use scientific-debugging.",
+			"triggers": [
+				"modernize this scientific code",
+				"rewrite this scientific software in Rust",
+				"port this solver to GPU",
+				"migrate the scientific build system",
+				"create a maintained fork",
+				"preserve scientific parity"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/research/scientific-modernization",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "research"
+		},
+		{
+			"name": "cut-it",
+			"description": "Slices an existing plan, PRD, or milestone into an executable sprint of dependency-ordered vertical slices sized for one agent run each, with done-when verification per slice; never fabricates a plan. Not for deciding the approach; use architecture.",
+			"triggers": [
+				"cut it",
+				"slice this plan",
+				"make this plan executable",
+				"turn this milestone into a sprint",
+				"write dependency-ordered vertical slices"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/workflow/cut-it",
+			"version": "0.4.1",
+			"audit": "pass",
+			"category": "workflow"
+		},
+		{
+			"name": "design-council",
+			"description": "Convenes several expert perspectives that challenge each other on a design decision with real trade-offs before code is written; quick mode runs a single round. Not for a one-question-at-a-time interrogation of a plan; use grill-me. Not for splitting implementation across workers; use dispatch directly.",
+			"triggers": [
+				"convene a design council",
+				"debate this design",
+				"get multiple expert perspectives",
+				"weigh the architecture options",
+				"what would experts say"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/workflow/design-council",
+			"version": "0.6.0",
+			"audit": "pass",
+			"category": "workflow"
+		},
+		{
+			"name": "grill-me",
+			"description": "Stress-tests a plan, design, or idea through a phased one-question-at-a-time interview before code is written, ending in a compact decision log. Not for a multi-perspective debate; use design-council.",
+			"triggers": [
+				"grill me",
+				"interview me about this plan",
+				"stress-test this design",
+				"poke holes in this idea",
+				"clarify this plan one question at a time"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/workflow/grill-me",
+			"version": "0.5.1",
+			"audit": "pass",
+			"category": "workflow"
+		},
+		{
+			"name": "workflow-distiller",
+			"description": "Packages a workflow that just happened into a reusable SKILL.md: reconstructs it from the session record, checks overlap with installed skills, gates on approval, then writes it following skill-craft. Not for authoring a skill with no prior workflow; use skill-craft.",
+			"triggers": [
+				"make this workflow a skill",
+				"package what we just did",
+				"turn this into a reusable workflow",
+				"distill this repeated process",
+				"create a skill from this session"
+			],
+			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/workflow/workflow-distiller",
+			"version": "0.4.2",
+			"audit": "pass",
+			"category": "workflow"
+		}
+	]
+}

package/library/skills/workflow/cut-it/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: cut-it
+description: Slices an existing plan, PRD, or milestone into an executable sprint of dependency-ordered vertical slices sized for one agent run each, with done-when verification per slice; never fabricates a plan. Not for deciding the approach; use architecture.
+triggers:
+  - cut it
+  - slice this plan
+  - make this plan executable
+  - turn this milestone into a sprint
+  - write dependency-ordered vertical slices
+version: 0.4.1
+license: Apache-2.0
+allowed-tools:
+  - read
+  - grep
+  - ls
+  - find
+  - git
+  - context
+  - code_nav
+  - write
+  - ask_user
+clio-coder:
+  registry-id: iowarp/clio-coder
+  source-url: https://github.com/iowarp/clio-coder/tree/main/library/skills/workflow/cut-it
+  audit: pass
+  provenance: adapted
+  origin: https://github.com/TheOrcDev/skills
+  eval-status: smoke-checked
+  model-size: any
+  agents:
+    - architect
+---
+
+# Cut It
+
+Transform an existing plan into ordered execution slices that a coding agent
+can run one at a time, leaving the build green after every slice. The output
+is a `SPRINT.md` another agent can execute cold — no conversation context
+required.
+
+## Arguments
+
+```text
+cut it [<path to plan>]
+```
+
+There is no flag syntax; the trigger is conversational — "cut it", "slice
+this plan", "turn this milestone into a sprint". A path the user names in
+the same request (a specific `PLAN.md`, `PRD.md`, or `milestones/*/prompt.md`)
+is the plan to slice; a path with no plan words near it, or a bare
+destination like "write it to docs/SPRINT.md", is Step 3's output location,
+not the input. When neither is named, Step 1 finds the plan and Step 3
+writes to the repo-root default.
+
+This run has no back-and-forth. `ask_user` is not registered in a headless
+run, so any call is refused as an unregistered tool rather than answered.
+The happy path here rarely needs a question at all — Step 1's "stop and say
+so" for a missing or vague plan is already headless-safe, and Step 3's output
+path defaults without asking. If several plans or milestones are plausible
+candidates and the choice matters, do not stop on an open question: pick the
+most recently modified or most specifically named one, state that choice and
+the alternative you set aside, mark it `assumed — confirm`, and keep going in
+the same turn. Do not end a turn on an unanswered question in `ask_user` or
+in plain text.
+
+The steps below are the plan; do not open a task list for them. This skill's
+tool surface is exactly `read`, `grep`, `ls`, `find`, `git`, `context`,
+`code_nav`, `write`, and `ask_user` (`context` and `ask_user` are always
+available regardless). `tasks` and `bash` both sit outside it and any call to
+either is refused — track progress by walking the steps below, not a task
+board; check for a build/test/lint setup (a `package.json`, a Makefile, a
+node/toolchain version) with `find`, `ls`, and `read`, not `bash node
+--version` or `bash find`. The read-only `git` tool (`status`, `log`) is
+useful in Step 1 when locating the plan benefits from recent history or
+uncommitted changes.
+
+## Step 1 — Locate the plan
+
+In priority order: a file the user names, a plan in the conversation,
+`PLAN.md` / `PRD.md` / `milestones/*/prompt.md` in the repo. **Never fabricate
+the plan.** If none exists, or what exists is too vague to slice honestly,
+stop and say so — recommend `grill-me` to resolve intent first. Artificial
+slicing of a vague plan hides gaps; flagging them is the deliverable.
+
+## Step 2 — Apply the cutting rules
+
+- **Vertical slices.** Each slice delivers end-to-end behavior, however thin.
+  No "all the types first, all the wiring later" horizontal layers.
+- **Dependency order.** A slice may depend only on earlier slices. State the
+  dependency explicitly.
+- **One agent run each.** Sized so a focused agent completes it in a single
+  run: small enough to hold in context, large enough to be meaningful.
+- **Green after every slice.** Build, lint, and existing tests pass at every
+  cut point. A slice that leaves the tree broken is two slices cut wrong.
+- **Self-contained.** Real file paths, real commands, concrete steps. A reader
+  with zero conversation context can execute it.
+
+## Step 3 — Write SPRINT.md
+
+Use the `write` tool. `SPRINT.md` is a plain file in the working tree, not a
+generated report — do not call a tool literally named `artifact` for this;
+that tool is not on this skill's surface and, in this harness, is a
+terminal call that ends the run the instant it is invoked, before you can
+report back. Default output path is `SPRINT.md` at the repo root; honor a
+caller-supplied path from Arguments instead. Format:
+
+```markdown
+# Sprint: <name>
+
+## Battle order
+1. <slice 1 title>
+2. <slice 2 title>  (depends on: 1)
+...
+
+## Slice 1 — <title>
+**Goal**: <the behavior this delivers>
+**Depends on**: <slice numbers or "nothing">
+**Files**: <paths touched>
+**Steps**:
+1. <concrete step with real paths/commands>
+**Done when**: <observable, testable criteria — the verification anchor>
+**Out of scope**: <what this slice deliberately does not do>
+```
+
+"Done when" is the contract, not decoration. If you cannot write a testable
+done-when for a slice, the slice is not ready to cut — go back to the plan.
+
+## Step 4 — Report back
+
+End the turn with a short final reply, not silence after the write: the path
+you wrote (`SPRINT.md` or the caller-supplied path), the number of slices,
+and a one-line summary of the battle order. This is the only confirmation
+the caller gets that the write actually happened.
+
+## Red flags (you are doing it wrong)
+
+- A slice whose steps say "and related changes" or "etc."
+- Done-when criteria that restate the goal instead of naming a check.
+- A slice that only compiles when a later slice lands.
+- Slicing a plan you had to invent on the spot.
+- Calling a tool literally named `artifact` because Step 3 talks about "the
+  artifact" — that word here means "the deliverable document," not the
+  `artifact` tool. That tool is off this skill's surface and, in this
+  harness, terminates the run on the spot, writes to
+  `.clio-coder/artifacts/` instead of `SPRINT.md`, and skips Step 4 entirely.
+  Use `write`.
+- Ending the run right after the write with no final reply — Step 4 is not
+  optional.
+- Opening a `tasks` list for the steps above; `tasks` is refused.
+- Reaching for `bash` (`node --version`, `find`, `ls -la`, ...) to check the
+  repo's toolchain or structure; `bash` is refused, use `find`/`ls`/`read`.
+- Stopping to wait for an `ask_user` reply that headless runs never send;
+  see Arguments.