soloship 0.4.1 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 > Ship solo, safely.
 
-Soloship is guardrails for non-coders building software through AI agents. It's a Claude Code plugin that gives you three things a traditional engineering team would: **mechanical enforcement** that fires automatically (9 hooks, 4 rules, CI checks — no judgment calls required), **16 Soloship workflow skills + 35 vendored skills from five best-in-class plugins** (51 skills total) that guide you through the steps a professional would take (each with enforcement gates and anti-rationalization tables so the agent can't cut corners), and **a one-command setup** that detects your stack and wires everything into the project.
+Soloship is guardrails for non-coders building software through AI agents. It's a Claude Code plugin that gives you three things a traditional engineering team would: **mechanical enforcement** that fires automatically (9 hooks, 4 rules, CI checks — no judgment calls required), **43 workflow skills** drawn from Soloship's own work plus four best-in-class upstream plugins (Compound Engineering, Superpowers, Impeccable, gstack, ui-ux-pro-max — full attribution below), each with enforcement gates and anti-rationalization tables so the agent can't cut corners, and **a one-command setup** that detects your stack and wires everything into the project.
 
 **Quick reference:** [aifoundationlevels.com/soloship-cheatsheet](https://aifoundationlevels.com/soloship-cheatsheet)
 
@@ -134,7 +134,7 @@ Others are routers — Soloship adds enforcement and routing logic, then dispatc
 | `/debug` | `superpowers:systematic-debugging` | Solution search for prior art, root-cause iron law |
 | `/learn` | `compound-engineering:workflows:compound` (Step 1) | Solution doc via CE, then own protocols: JSONL logging, registry audit, AGENTS.md propagation + creation |
 | `/review` | `plan-eng/ceo/design-review` (plans) / 3-pass agents (code) | Target detection (plan vs code), severity classification, synthesis |
-| `/shipthorough` | Invokes `/review` internally | 12-step pipeline: preflight, merge, lint, test, coverage audit, review, registry, CHANGELOG, plan lifecycle, commits, PR, deploy |
+| `/shipthorough` | Invokes `/review` internally | 12-step pipeline: preflight, merge, lint, test, coverage audit, review, registry, CHANGELOG, plan lifecycle, commits, local merge to base branch (PR only on explicit request), deploy |
 | `/design-review` | gstack `design-review` | Adds AI slop detection pass (visual/content/layout patterns) |
 
 ## What you get
@@ -163,27 +163,27 @@ Run bootstrap once per project. For existing code, run `/soloship:audit` first s
 
 **Daily work**
 
-- `/soloship:brainstorm` — Detects whether the question is demand-validation (should this exist?) or feature-shaping (what should this do?) and routes accordingly: `gs-office-hours` for demand, `ce-brainstorm` for feature. Ends with a mandatory design-first nudge — sketch before you plan.
+- `/soloship:brainstorm` — Feature exploration that merges Compound Engineering's brainstorm methodology with Superpowers' brainstorming discipline. Ends with a mandatory design-first nudge — sketch before you plan. For demand-validation questions (should this exist?), use `/soloship:office-hours` instead.
 - `/soloship:grill-me` — Relentless pre-plan interview that walks every branch of the design tree until user and agent share a complete mental model. Refuses to produce a plan or any code until alignment is explicit. Triggered explicitly ("grill me", "interview me") or by `/soloship:plan` on medium-to-large work. Adapted from Matt Pocock's `grill-me` (MIT).
 - `/soloship:spec` — Writes formal specifications with numbered acceptance criteria, data models, API contracts, user flows (including error states), and explicit out-of-scope boundaries. 8-point verification checklist. Fully self-contained.
-- `/soloship:plan` — Searches `docs/solutions/` for prior art, reads architecture context, then invokes `ce-plan` to produce the plan. 7-point enforcement gate validates: Why lines, Key Decisions, Execution Strategy, Handoff section, no unaddressed pitfalls, and that non-trivial work was preceded by `/soloship:grill-me`. Review is separate — handled by `/soloship:review`.
-- `/soloship:implement` — Finds the most recent plan in `docs/plans/`, invokes `ce-work` for execution with branching and QC. Freshness check warns on stale plans.
-- `/soloship:debug` — Iron law: no fixes without root cause investigation. Searches solutions for prior art first, then invokes `sp-systematic-debugging` for 4-phase discipline (Investigate → Analyze → Hypothesize → Implement). Nudges `/learn` for non-obvious fixes.
-- `/soloship:learn` — Captures knowledge from non-obvious work. Invokes `ce-compound` for solution doc creation. Adds Soloship protocols: JSONL logging for cross-session search, architecture registry drift checking, and distributed AGENTS.md propagation (pitfalls into existing AGENTS.md files, new ones for directories above the 3-file governance threshold). Anti-rationalization table blocks "this fix was straightforward, not worth documenting."
+- `/soloship:plan` — Searches `docs/solutions/` for prior art, reads architecture context, then runs the Compound-Engineering-derived plan-writing methodology. 7-point enforcement gate validates: Why lines, Key Decisions, Execution Strategy, Handoff section, no unaddressed pitfalls, and that non-trivial work was preceded by `/soloship:grill-me`. Review is separate — handled by `/soloship:review`.
+- `/soloship:implement` — Finds the most recent plan in `docs/plans/`, sets up an isolated worktree (so parallel agent processes don't collide on the working tree), then runs the Compound-Engineering-derived execution methodology with branching and quality checks. Freshness check warns on stale plans. **Defaults to a local merge into the base branch** when execution finishes — does not auto-create a GitHub PR. Ask explicitly ("open a PR for this") or use `/soloship:finish` Option 2 if you want one.
+- `/soloship:debug` — Iron law: no fixes without root cause investigation. Searches solutions for prior art first, then runs the Superpowers-derived 4-phase discipline (Investigate → Analyze → Hypothesize → Implement). Nudges `/soloship:learn` for non-obvious fixes.
+- `/soloship:learn` — Captures knowledge from non-obvious work. Runs the Compound-Engineering-derived compound methodology to write a solution doc. Adds Soloship protocols: JSONL logging for cross-session search, architecture registry drift checking, and distributed AGENTS.md propagation (pitfalls into existing AGENTS.md files, new ones for directories above the 3-file governance threshold). Anti-rationalization table blocks "this fix was straightforward, not worth documenting."
 - `/soloship:cleanup` — Knowledge system maintenance. Launches 5 parallel audit agents (solution health, overlap detection, plan lifecycle, AGENTS.md staleness, index sync), presents findings interactively, then executes approved changes in a single atomic commit. Merge candidates require 2-of-3 signal threshold.
 
 **Shipping**
 
 - `/soloship:finish` — When implementation is done, all tests pass, and you need to decide how to integrate the work. Walks the merge / PR / cleanup options with a structured decision tree. Faithful vendor of Superpowers' `finishing-a-development-branch` skill, renamed for the Soloship slash surface.
 - `/soloship:shipfast` — Emergency deploy pipeline. Lint (with auto-fix tolerance), test (pre-existing failures allowed), build (must pass), commit, push, deploy. Auto-detects platform. Minimum viable safety, maximum speed.
-- `/soloship:shipthorough` — Full due diligence: preflight checks, base branch merge, lint, test, inline quality gate (TypeScript + linter + dead code + shellcheck), coverage audit, 3-pass code review (via `/review`), registry update, CHANGELOG enforcement, plan lifecycle cleanup, bisectable commits, PR with structured body, verification gate, deploy.
+- `/soloship:shipthorough` — Full due diligence: preflight checks, base branch merge, lint, test, inline quality gate (TypeScript + linter + dead code + shellcheck), coverage audit, 3-pass code review (via `/review`), registry update, CHANGELOG enforcement, plan lifecycle cleanup, bisectable commits, **local merge into the base branch and push** (PR only on explicit opt-in), verification gate, deploy.
 
 **Quality**
 
-- `/soloship:review` — Detects whether the target is a plan or code. **Plans** route to `gs-plan-eng-review`, `gs-plan-ceo-review`, `gs-plan-design-review` individually, or `gs-autoplan` for all four (adds DX review) in one auto-decided pass. **Code** routes to `ce-review` for PR-scale multi-agent analysis, or runs three inline passes (structural, adversarial, design slop lens) for quick local checks.
-- `/soloship:design-review` — Two-pass visual audit. Pass 1 invokes `gs-design-review` for spacing, hierarchy, and consistency. Pass 2 is Soloship's own AI slop detection (inspired by Impeccable) — flags generic gradients, default shadows, "Welcome to" copy, 3-column feature grids, and other patterns that mark AI-generated design. Each fix committed atomically with before/after screenshots.
+- `/soloship:review` — Detects whether the target is a plan or code. **Plans** route to `eng-review`, `ceo-review`, `plan-design-review` individually, or `autoplan` for all four (adds DX review) in one auto-decided pass. **Code** routes to `code-review` for PR-scale multi-agent analysis, or runs three inline passes (structural, adversarial, design slop lens) for quick local checks.
+- `/soloship:design-review` — Two-pass visual audit. Pass 1 invokes `design-review` for spacing, hierarchy, and consistency. Pass 2 is Soloship's own AI slop detection (inspired by Impeccable) — flags generic gradients, default shadows, "Welcome to" copy, 3-column feature grids, and other patterns that mark AI-generated design. Each fix committed atomically with before/after screenshots.
 
-**Note:** Skills that were previously thin wrappers over vendored gstack skills (`/soloship:qa`, `/soloship:security`, `/soloship:checkpoint`, `/soloship:autoplan`, `/soloship:health`) have been removed. Use the vendored originals directly: `/gs-qa`, `/gs-cso`, `/gs-context-save` / `/gs-context-restore`, `/gs-autoplan`. Health has no replacement — its core checks were inlined into `/soloship:shipthorough`'s quality gate.
+**Note:** Skills that were previously thin wrappers over vendored gstack skills (`/soloship:qa`, `/soloship:security`, `/soloship:checkpoint`, `/soloship:autoplan`, `/soloship:health`) have been removed. Use the vendored originals directly: `/qa`, `/cso`, `/context-save` / `/context-restore`, `/autoplan`. Health has no replacement — its core checks were inlined into `/soloship:shipthorough`'s quality gate.
 
 ## Quick start
 
@@ -243,7 +243,7 @@ Soloship curates and vendors skills from five outstanding Claude Code plugins. O
 
 [**Compound Engineering**](https://github.com/EveryInc/compound-engineering-plugin) — Kieran Klaassen (Every). The brainstorm → plan → work → compound loop is the spine of how Soloship thinks about engineering. Also: `/review` inherits CE's multi-agent review pattern.
 
-[**Superpowers**](https://github.com/obra/superpowers) — Jesse Vincent. The discipline skills: `systematic-debugging`'s "no fixes without root cause," `verification-before-completion`'s "evidence before claims," `test-driven-development`, `writing-plans`, `executing-plans`, `subagent-driven-development`, `using-git-worktrees`, `finishing-a-development-branch` (renamed to `finish` in Soloship — invoke via `/soloship-finish`), and `brainstorming`. Nine skills total.
+[**Superpowers**](https://github.com/obra/superpowers) — Jesse Vincent. The discipline skills: `systematic-debugging`'s "no fixes without root cause," `verification-before-completion`'s "evidence before claims," `test-driven-development`, `writing-plans`, `executing-plans`, `subagent-driven-development`, `using-git-worktrees`, `finishing-a-development-branch` (renamed to `finish` in Soloship — invoke via `/soloship:finish`), and `brainstorming`. Nine skills total.
 
 [**Impeccable**](https://impeccable.style) — Paul Bakaus (extending Anthropic's original `frontend-design`). Design vocabulary and steering commands that let non-coders ship work that doesn't look AI-generated. Soloship vendors `frontend-design` and five `/i-*` commands; 12 more are in the full plugin.
 
@@ -275,26 +275,34 @@ src/                   # TypeScript source for the installer
   rules.ts             # Workflow rule installation
   ci.ts                # GitHub Actions + architecture fitness
   templates.ts         # CLAUDE.md / AGENTS.md / CHANGELOG / SOLUTION_GUIDE generators
-skills/                # Claude Code skills shipped by the plugin (51 total)
-  # 16 skills invoked as /soloship-* (15 Soloship-native + 1 renamed vendor):
+skills/                # Claude Code skills shipped by the plugin (43 total)
+  # All skills are invoked as /soloship:<name>. Source attribution lives
+  # in THIRD_PARTY_NOTICES.md; no source prefixes leak into command names.
+
+  # Soloship-native workflow skills (16):
   audit/ bootstrap/ brainstorm/ cleanup/ debug/ design-review/
-  grill-me/ implement/ learn/ onboard/ plan/ review/
+  finish/ grill-me/ implement/ learn/ onboard/ plan/ review/
   shipfast/ shipthorough/ spec/
-  finish/     # vendored from Superpowers' finishing-a-development-branch
-              # — renamed for the Soloship slash-command surface
-
-  # 35 vendored skills with source prefix (full attribution in THIRD_PARTY_NOTICES.md):
-  ce-*        # 8 from Compound Engineering (Kieran Klaassen, MIT)
-  sp-*        # 8 from Superpowers (Jesse Vincent, MIT)
-              # (a 9th Superpowers skill, finishing-a-development-branch,
-              # lives at skills/finish/ above)
-  im-*        # 6 from Impeccable (Paul Bakaus, Apache 2.0)
-  uiux-*      # 1 from ui-ux-pro-max (nextlevelbuilder, MIT)
-  gs-*        # 12 from gstack (Garry Tan, MIT) — includes the gs-browse
-              # headless browser daemon, re-vendored at v1.31.1.0 with
-              # Soloship-native paths so it works without gstack installed.
-              # gs-browse compiles its launcher on first use (build-on-host
-              # for architecture portability across arm64 / x86_64 Macs).
+
+  # Plan-review skills, derived from gstack (5):
+  ceo-review/ eng-review/ devex-review/ plan-design-review/ autoplan/
+
+  # Code-review, design, and frontend skills, derived from CE and Impeccable (8):
+  code-review/ deepen-plan/ document-review/ clarify/ critique/
+  polish/ simplify/ frontend-design/
+
+  # Discipline skills, derived from Superpowers (6):
+  executing-plans/ subagent-driven-development/ test-driven-development/
+  using-git-worktrees/ verification-before-completion/ writing-plans/
+
+  # Standalone vendored utilities (8):
+  browse/             # gstack's headless browser daemon — re-vendored at
+                      # v1.31.1.0 with Soloship-native paths so it works
+                      # without gstack installed. Compiles its launcher on
+                      # first use (build-on-host for arm64/x86_64 portability).
+  cso/ qa/ context-save/ context-restore/ office-hours/   # from gstack
+  ui-audit/                                               # from Impeccable
+  ui-ux-pro-max/                                          # from nextlevelbuilder
 
   references/          # Shared checklists (a11y, code review, perf, security, testing)
   vendored/            # Per-source LICENSE / NOTICE / VERSION / README (attribution archive)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soloship",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Systematic programming methodology for AI-assisted development",
   "type": "module",
   "bin": {