@fableplan/fableplan 1.0.0 → 1.1.0

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "fableplan",
-  "description": "Marketplace for the fableplan Claude Code plugin: Fable 5-driven implementation planning before building.",
+  "description": "Marketplace for the fableplan Claude Code plugin: Fable 5.1-driven implementation planning before building.",
   "owner": {
     "name": "Richard Kuo"
   },
@@ -8,7 +8,7 @@
     {
       "name": "fableplan",
       "source": "./",
-      "description": "Delegates implementation planning to a Fable 5 planning subagent, then builds from the vetted plan — posting it to a referenced GitHub issue along the way."
+      "description": "Delegates implementation planning to a Fable 5.1 planning subagent, then builds from the vetted plan — posting it to a referenced GitHub issue along the way."
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fableplan",
   "displayName": "fableplan",
-  "version": "1.0.0",
-  "description": "Delegates implementation planning to a Fable 5 planning subagent, then builds from the vetted plan — posting it to a referenced GitHub issue along the way.",
+  "version": "1.1.0",
+  "description": "Delegates implementation planning to a Fable 5.1 planning subagent, then builds from the vetted plan — posting it to a referenced GitHub issue along the way.",
   "author": {
     "name": "Richard Kuo"
   },

package/README.md

@@ -1,8 +1,8 @@
 # fableplan
 
-A [Claude Code](https://claude.com/claude-code) skill that delegates implementation planning to a **Fable 5** planning subagent, then builds from that plan in your main session — and, when a GitHub issue is referenced, posts the vetted plan to the issue as a comment.
+A [Claude Code](https://claude.com/claude-code) skill that delegates implementation planning to a **Fable 5.1** planning subagent, then builds from that plan in your main session — and, when a GitHub issue is referenced, posts the vetted plan to the issue as a comment.
 
-The idea: let a dedicated planning model (Fable 5) produce a concrete, ordered implementation plan before any code is written, review it against the real codebase, preserve it on the tracker, and only then build — in an isolated git worktree so your working tree is never touched.
+The idea: let a dedicated planning model (Fable 5.1) produce a concrete, ordered implementation plan before any code is written, review it against the real codebase, preserve it on the tracker, and only then build — in an isolated git worktree so your working tree is never touched.
 
 ## What it does
 
@@ -11,12 +11,12 @@ Trigger it with `/fableplan`, "fableplan this", or "plan this with fable", plus
 The skill then runs a 7-step flow:
 
 1. **Resolve the GitHub issue** (only if one is referenced) so the planner works from the real requirements, not a paraphrase.
-2. **Dispatch the Fable 5 Plan subagent**, confirm it made no edits, and save the plan verbatim to a scratch file.
-3. **Sanity-check the plan** against the actual codebase (files, symbols, conventions). It stops and asks you if the plan is structurally wrong rather than silently re-planning.
+2. **Dispatch the Fable 5.1 Plan subagent**, confirm it made no edits, and save the plan verbatim to a scratch file. The plan follows the repo's `CLAUDE.md`/`AGENTS.md` conventions, cites `file:line` for its claims about the code, lists open questions and assumptions, and gives acceptance criteria and exact verification commands.
+3. **Sanity-check the plan** against the actual codebase (each `file:line` citation, files, symbols, conventions). It stops and asks you if the plan is structurally wrong rather than silently re-planning.
 4. **Post the vetted plan** to the GitHub issue as a comment (only if one was referenced).
 5. **Present the plan** to you.
 6. **Set up an isolated git worktree** so the build never touches your current workspace.
-7. **Build** the task from the plan, inside that worktree.
+7. **Build** the task from the plan, inside that worktree, then run the plan's verification commands before reporting done.
 
 ## Install
 
@@ -31,6 +31,16 @@ This repo is a Claude Code plugin marketplace. Inside any Claude Code session:
 
 The skill is picked up automatically from the plugin's `skills/` directory, and updates flow through the plugin system.
 
+### With `npx` (npm)
+
+Published to npm as [`@fableplan/fableplan`](https://www.npmjs.com/package/@fableplan/fableplan). One command copies the skill into `~/.claude/skills/`:
+
+```sh
+npx @fableplan/fableplan
+```
+
+Add `--project` to install into the current repo's `.claude/skills/` instead of your personal directory.
+
 ### Ask Claude Code to install it
 
 Paste this straight into a Claude Code prompt:
@@ -54,7 +64,7 @@ This installs into `.claude/skills/` (and any other agents it detects). It's a t
 A Claude Code skill is just a directory containing a `SKILL.md`, so you can also install it with one command — no clone needed:
 
 ```sh
-mkdir -p ~/.claude/skills/fableplan && curl -fsSL https://raw.githubusercontent.com/richkuo/fableplan/master/skills/fableplan/SKILL.md -o ~/.claude/skills/fableplan/SKILL.md
+mkdir -p ~/.claude/skills/fableplan && curl -fsSL https://raw.githubusercontent.com/richkuo/fableplan/main/skills/fableplan/SKILL.md -o ~/.claude/skills/fableplan/SKILL.md
 ```
 
 This puts it in your personal skills directory (`~/.claude/skills/`), available in every project. To scope it to a single project instead, put the file at `<repo>/.claude/skills/fableplan/SKILL.md`.
@@ -75,8 +85,8 @@ Start a new Claude Code session (or restart the current one), then run:
 
 ## Notes
 
-- The planning subagent always runs on Fable 5 regardless of your main session's model.
-- The skill adapts to the target repo's conventions (e.g. its `CLAUDE.md`); behavior isn't hardcoded to any one project.
+- The planning subagent always runs on Fable 5.1 regardless of your main session's model.
+- The skill adapts to the target repo's conventions (e.g. its `CLAUDE.md` or `AGENTS.md`); behavior isn't hardcoded to any one project.
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fableplan/fableplan",
-  "version": "1.0.0",
-  "description": "Installer for the fableplan Claude Code skill: plan with Fable 5, build with your main-session model.",
+  "version": "1.1.0",
+  "description": "Installer for the fableplan Claude Code skill: plan with Fable 5.1, build with your main-session model.",
   "type": "module",
   "bin": {
     "fableplan": "bin/install.mjs"

package/skills/fableplan/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: fableplan
-description: Use when the user wants a task planned by a Fable 5 planning subagent before building it. Spins up a Plan subagent running on Fable 5 to produce an implementation plan, relays the plan back to the main agent to build, and — if a GitHub issue is referenced — posts the plan as a comment on that issue. Trigger on "/fableplan", "fableplan this", or "plan this with fable".
+description: Use when the user wants a task planned by a Fable 5.1 planning subagent before building it. Spins up a Plan subagent running on Fable 5.1 to produce an implementation plan, relays the plan back to the main agent to build, and — if a GitHub issue is referenced — posts the plan as a comment on that issue. Trigger on "/fableplan", "fableplan this", or "plan this with fable".
 ---
 
 # fableplan
 
-Delegate planning to a **Fable 5** Plan subagent, then build from its plan in the main agent. The main agent does the building — the subagent only plans.
+Delegate planning to a **Fable 5.1** Plan subagent, then build from its plan in the main agent. The main agent does the building — the subagent only plans.
 
 ## Input
 
@@ -30,16 +30,21 @@ If the command fails (wrong number, no auth, no repo), stop and tell the user
 
 Record the issue number and URL — you'll need them in step 4. If no issue is referenced, skip this and step 4's posting.
 
-### 2. Dispatch the Fable 5 Plan subagent
+### 2. Dispatch the Fable 5.1 Plan subagent
 
 Do not re-plan the task yourself first — the subagent owns the plan. Snapshot `git status --porcelain` before dispatching (the tree may already be dirty), then call the Agent tool with:
 
 - `subagent_type`: `Plan`
-- `model`: `fable` (this is the whole point of the skill — the plan must come from Fable 5)
+- `model`: `fable` (this is the whole point of the skill — the plan must come from Fable 5.1)
 - `run_in_background`: `false` — every later step depends on the plan, so wait for it synchronously instead of doing other work first
 - `description`: `Plan <short task name>`
 - `prompt`: Hand the subagent everything it needs to plan independently — the full task description, the issue title/body if one was fetched, the working directory, and any constraints the user stated. Tell it explicitly:
   - Produce a concrete, ordered implementation plan (files to create/modify, the approach, build sequence, risks/edge cases, and how to verify).
+  - Before planning, read the repo's CLAUDE.md and AGENTS.md files (root and any in directories the plan touches) and follow their conventions. Name any convention the plan relies on.
+  - Cite every load-bearing claim about the existing code with a `file:line` reference (files to modify, functions or symbols it calls, behavior it depends on), so each claim can be checked against the code. Never cite a location it has not read.
+  - Include an `Open questions and assumptions` section. List every assumption it made where the task, issue, or code was unclear, and every decision the user must make. Write "None" if there are none. Never resolve an ambiguity silently.
+  - Include an `Acceptance criteria` section of observable, checkable outcomes, and a `Verification` section with the exact commands to run (build, lint, type check, integration tests) and the result each must produce.
+  - Plan the absolute-best solution the task calls for, evaluated as if cost, effort, time, token spend, and code volume were unlimited — they are not factors and must never narrow the option space. The only constraints that override "best" are correctness and safety.
   - Return the plan as its final message in clean Markdown suitable to (a) act on directly and (b) post verbatim as a GitHub issue comment.
   - It is planning only — it must NOT make code edits, including via Bash (no writing/modifying files, no commits). The subagent lacks Edit/Write, but still has Bash, so this must be stated explicitly.
 
@@ -53,7 +58,7 @@ When the result arrives:
 
 ### 3. Sanity-check the plan against the code
 
-Before posting or presenting it, verify the plan's load-bearing claims against the actual codebase: the files it says to modify exist, the functions/symbols it references are real, and it doesn't contradict repo conventions (CLAUDE.md). Fix small inaccuracies yourself and note them; if the plan is structurally wrong (built on a file or mechanism that doesn't exist), do NOT automatically re-dispatch the Plan subagent — stop and tell the user what's failing, and let them decide whether to re-plan with Fable 5, adjust the task, or proceed anyway. If you fixed small inaccuracies, update the scratchpad file from step 2 so it reflects the corrected plan before step 4 posts it.
+Before posting or presenting it, verify the plan's load-bearing claims against the actual codebase: open each `file:line` citation and confirm it says what the plan claims, the files it says to modify exist, the functions/symbols it references are real, and it doesn't contradict repo conventions (CLAUDE.md, AGENTS.md). Treat a load-bearing claim with no citation as unverified until you check it. Fix small inaccuracies yourself and note them; if the plan is structurally wrong (built on a file or mechanism that doesn't exist), do NOT automatically re-dispatch the Plan subagent — stop and tell the user what's failing, and let them decide whether to re-plan with Fable 5.1, adjust the task, or proceed anyway. If you fixed small inaccuracies, update the scratchpad file from step 2 so it reflects the corrected plan before step 4 posts it.
 
 ### 4. Post the plan to the GitHub issue (only if one was resolved in step 1)
 
@@ -63,11 +68,11 @@ Now that the plan has passed the sanity-check, save it to the issue as a comment
 gh issue comment <N> --body-file <tmpfile>
 ```
 
-Add `-R owner/repo` when the issue lives in another repo (as in step 1). Use the scratchpad file from step 2 (with any step-3 corrections) as the body-file base — it avoids shell-escaping problems with Markdown. Prefix the comment so its origin is clear with a heading line `## Implementation plan (Fable 5)` above the plan body, and end the body with the standard metadata footer:
+Add `-R owner/repo` when the issue lives in another repo (as in step 1). Use the scratchpad file from step 2 (with any step-3 corrections) as the body-file base — it avoids shell-escaping problems with Markdown. Prefix the comment so its origin is clear with a heading line `## Implementation plan (Fable 5.1)` above the plan body, and end the body with the standard metadata footer:
 
 ```
 ---
-Created with: Fable 5 | high | Claude Code | fableplan
+Created with: Fable 5.1 | high | Claude Code | fableplan
 ```
 
 After posting, give the user the comment URL `gh` returns. Follow the repo's CLAUDE.md conventions for comment formatting if any apply (e.g. avoid `#N` auto-links in list items). If no issue is referenced, skip this step.
@@ -88,9 +93,9 @@ Do all of step 7's building inside that worktree. When the build is done, follow
 
 ### 7. Build
 
-In the worktree from step 6, the main agent builds the task per the plan. Confirm with the user first only if the plan reveals ambiguity or a decision the user must make; otherwise proceed.
+In the worktree from step 6, the main agent builds the task per the plan. Confirm with the user first only if the plan's `Open questions and assumptions` section, or the build itself, reveals ambiguity or a decision the user must make; otherwise proceed. Before you report the build as done, run every command in the plan's `Verification` section and confirm each acceptance criterion.
 
 ## Notes
 
-- The Plan subagent runs on Fable 5 regardless of the main agent's model — `model: fable` on the Agent call forces it.
+- The Plan subagent runs on Fable 5.1 regardless of the main agent's model — `model: fable` on the Agent call forces it.
 - If the user did not reference an issue, never invent one or post anywhere — just plan and build.