plumbbob 0.3.1 → 0.4.2

package/skills/pb-build/SKILL.md

@@ -1,49 +0,0 @@
----
-name: pb-build
-description: The optional engine — read the current planned step from intent, implement it (its done-when, seam, Decisions, Constraints), then verify it through to the approval pause. Skip it entirely to implement by hand, vibed, or with another harness.
-disable-model-invocation: true
-model: opus
-allowed-tools: Read, Edit, Write, Bash(__PLUMBBOB_BIN__ status:*), Bash(__PLUMBBOB_BIN__ build:*), Bash(__PLUMBBOB_BIN__ check:*), Bash(__PLUMBBOB_BIN__ checkpoint:*), Bash(git diff:*)
----
-
-# Plumbbob — build a step (the optional engine)
-
-Current session state (injected when this skill runs): !`__PLUMBBOB_BIN__ status 2>/dev/null || echo "plumbbob CLI not found - install the dep and re-run: npx plumbbob setup"`
-
-This is the **bundled executor** — one way to turn a planned step into code. It is
-**optional** (D3): you can implement any step by hand, in a vibe session, or with
-another harness and go straight to `/pb-verify` instead — plumbbob does not care how
-the diff appeared. When you do run it, it reads the plan, writes the step, and
-carries straight through to the verify pause.
-
-## What this skill does, in order
-
-1. **Pick the step.** Use the number you were invoked with (e.g. `/pb-build 4`), else
-   the next undone, planned step in `.plumbbob/intent.md`. If there is no planned step
-   to build, stop and tell the human to `/pb-step` first.
-2. **Enter the step.** Run `__PLUMBBOB_BIN__ build <n>` (records the in-flight STEP +
-   SEAM so `/pb-status` shows the step in flight; in v2 the seam is awareness, not a
-   lock).
-3. **Read the plan.** Read the step's **done-when**, its **seam**, and the
-   **Decisions** and **Constraints** in `intent.md`. Build to *that* — the deciding
-   already happened, off the chat.
-4. **Implement** the step, and only that step, staying within the declared seam. A
-   new problem or "ooh what if" that surfaces mid-build is a `/pb-park`, **not** an
-   edit — capture it and stay on the step. If you genuinely cannot finish without
-   touching more than the seam, that is scope drift: surface it to the human rather
-   than sprawling.
-5. **Verify, through to the pause.** Run the verify tick exactly as `/pb-verify`
-   does: `__PLUMBBOB_BIN__ check` → self-review the diff against the done-when, the
-   Decisions, and the Constraints (a single structured read, D16) → validate → **PAUSE
-   for the human's approval** → only on approval, checkpoint with
-   `__PLUMBBOB_BIN__ checkpoint`. Do **not** bump the version or changelog — that is
-   the human's `/version` call.
-
-## The hard contracts
-
-- **Optional, never required.** The loop works without this skill; `/pb-verify`
-  checkpoints a hand-built or vibed diff just the same (D3).
-- **Build the decided step, not a new one.** Implement what `intent.md` settled. A
-  new idea mid-build is a `/pb-park`, not an edit.
-- **Always end at the pause.** Implement → verify → wait for approval. Never
-  checkpoint without it; the human is the clock.

package/skills/pb-plan/SKILL.md

@@ -1,38 +0,0 @@
----
-name: pb-plan
-description: Frame a fresh goal — scaffold the session and author the intent's Frame, Decisions, and Constraints before any code. Steps stay empty; they come one at a time from /pb-step.
-disable-model-invocation: true
-model: opus
-allowed-tools: Read, Edit, Write, Bash(__PLUMBBOB_BIN__ status:*), Bash(__PLUMBBOB_BIN__ start:*)
----
-
-# Plumbbob — frame a goal (the whole-goal move)
-
-Current session state (injected when this skill runs): !`__PLUMBBOB_BIN__ status 2>/dev/null || echo "plumbbob CLI not found - install the dep and re-run: npx plumbbob setup"`
-
-`/pb-plan` is the **whole-goal** move — it opens a session and gets the deciding out
-of your head and onto `intent.md` *before* any code. (Planning a single increment is
-the separate `/pb-step` move; do not confuse the two.)
-
-## What this skill does
-
-1. **Scaffold.** If there is no active session, run `__PLUMBBOB_BIN__ start "<title>"`
-   to create `.plumbbob/` (STATE=DESIGN, baseline recorded). If a session already
-   exists, say so and edit the existing `intent.md` rather than starting over.
-2. **Frame** (`.plumbbob/intent.md`), with the human: the **Problem** in plain words,
-   the **smallest thing** that solves it, what **done looks like**, and what you are
-   **explicitly NOT doing**. This is the human's convergence — propose wording, but
-   the human decides every line.
-3. **Decisions & Constraints.** Record the settled calls (one line each, with the
-   *because*) and the hard rules the build must honor. An unresolved hole goes to
-   **Open questions**, never guessed into a Decision.
-4. **Leave `## Steps` empty.** Steps are planned just-in-time (D6) — one at a time
-   with `/pb-step` — so do not write the build plan here.
-
-## The hard contracts
-
-- **Deciding before code.** `/pb-plan` writes `intent.md` only — never source.
-- **The human converges.** You surface options and draft wording; the human picks.
-  An unresolved hole is an Open question, not a guessed Decision.
-- **Size to the work.** A small change fills Frame + a couple of Decisions and stops;
-  ceremony on a one-liner is the failure mode, not thoroughness.

package/skills/pb-step/SKILL.md

@@ -1,37 +0,0 @@
----
-name: pb-step
-description: Plan the next increment — propose one small step with a done-when criterion and a seam, get the human's OK, and append it to intent's ## Steps. One by default; several only if the human already knows them.
-disable-model-invocation: true
-model: opus
-allowed-tools: Read, Edit, Bash(__PLUMBBOB_BIN__ status:*)
----
-
-# Plumbbob — plan the next step (the single-increment move)
-
-Current session state (injected when this skill runs): !`__PLUMBBOB_BIN__ status 2>/dev/null || echo "plumbbob CLI not found - install the dep and re-run: npx plumbbob setup"`
-
-`/pb-step` plans the **next increment** just-in-time (D6) — the smallest verifiable
-piece of the framed goal, planned only when you reach it. (Framing the whole goal is
-the separate `/pb-plan` move.)
-
-## What this skill does
-
-1. **Read the plan.** Read `intent.md`'s Frame, Decisions, Constraints, and the steps
-   already done, to see what the *next* increment should be.
-2. **Propose one step.** Draft a single step:
-   - a one-line **title**,
-   - a **done-when** criterion — ideally a test or check result, something
-     `/pb-verify` can actually validate,
-   - a **seam**: the specific files it should touch (exact paths, or a `dir/` grant).
-   Keep it small enough to verify in one review pass.
-3. **Get the human's OK**, then **append** it to `## Steps` in the standard format —
-   `N. [ ] <title> — **done when:** <criterion>` with a `- seam:` sub-line. Default
-   to **one** step; plan several only when the human already knows them.
-
-## The hard contracts
-
-- **One verifiable increment.** Each step carries a done-when `/pb-verify` can check
-  and a seam small enough to review in one pass.
-- **Append to `## Steps` only**, in the standard format `status` and `build` parse —
-  never the Roadmap, never loose prose.
-- **The human approves the step** before it lands. You propose; they decide.

package/skills/plumbbob-interrogate/SKILL.md

@@ -1,33 +0,0 @@
----
-name: plumbbob-interrogate
-description: DESIGN-phase frame interrogation — attack the plan for holes and append them as Open questions, without deciding anything.
-disable-model-invocation: true
-model: opus
-allowed-tools: Read, Edit, Bash(__PLUMBBOB_BIN__ status:*)
----
-
-# Plumbbob — interrogate the frame
-
-Current session state (injected when this skill runs): !`__PLUMBBOB_BIN__ status 2>/dev/null || echo "plumbbob CLI not found - install the dep and re-run: npx plumbbob setup"`
-
-## Wrong-state refusal
-
-This skill runs in **DESIGN only**. Read the state injected above and **stop before touching anything** if it is not `DESIGN`:
-
-- `STATE: BUILD` or `STATE: REVIEW` — you are mid-step. Return to DESIGN first: finish the step with `plumbbob done`, or drop a half-built step with `plumbbob revert`. Then re-invoke.
-- `STATE: SPIKE` — close the experiment with `plumbbob spike done` first.
-- `STATE: FINISH` — the session is wrapping up; there is nothing left to interrogate.
-- `NO ACTIVE SESSION` — start one with `plumbbob start "<title>"`.
-
-When the state is wrong, refuse in one line naming the verb above, and edit nothing.
-
-## What this skill does
-
-Hand the frame (the **Frame** and **Architecture sketch** in `intent.md`) a cold, adversarial read and **attack it for holes** — ambiguities, unhandled edge cases, hidden assumptions, and collisions with the existing code. This is the one place early divergence is wanted, and it is divergence in the **problem space only**: surface what is unclear, never propose a solution and never pick between options.
-
-## The one hard contract
-
-- Append every hole as a bullet under `intent.md`'s `## Open questions` section, and **nowhere else**.
-- **Never append to `## Decisions`** — resolving a hole is the human's convergence, not yours (D13). You surface; you do not decide.
-- One question per hole, phrased as a question, each standing on its own.
-- Once the Open questions are appended, **end your turn**. Do not answer them, do not start the next step, do not slide from interrogating into deciding.