fix: clean workflow names + document them (2.0.1)

.claude-plugin/marketplace.json

@@ -5,13 +5,13 @@
   },
   "metadata": {
     "description": "keepwright — set up and continuously keep engineering quality and architecture true in any git repo.",
-    "version": "2.0.0"
+    "version": "2.0.1"
   },
   "plugins": [
     {
       "name": "keepwright",
       "description": "Interactive wizard that scaffolds a quality architecture (CLAUDE.md, rules, GitHub Actions with AI review, validators, hooks) and keeps it audited and enforced over time.",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "author": {
         "name": "Leonardo Candiani"
       },

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "keepwright",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Set up and continuously keep engineering quality and architecture true in any git repo. Interactive wizard, deterministic scaffolding, multi-agent audits, and AI PR review wired to OAuth.",
   "author": {
     "name": "Leonardo Candiani"

CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project are documented here.
 Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 versioning follows [SemVer](https://semver.org/).
 
+## [2.0.1] — 2026-06-05
+
+### Fixed
+
+- Clean workflow names — `map-brownfield`, `derive-patterns`, `verify-setup`
+  (were prefixed `keepwright-`, which surfaced as the redundant
+  `/keepwright:keepwright-*`). No behavior change — the commands trigger them by path.
+
+### Documentation
+
+- README now documents the workflows and the skills/agents the plugin exposes,
+  not just the three top-level commands.
+- Install split into numbered steps plus `/reload-plugins` to activate after install.
+
 ## [2.0.0] — 2026-06-05
 
 Rebrand to **keepwright** and full plugin redesign. The old

README.md

@@ -46,6 +46,21 @@ Loads keepwright's commands, skills, and agents into the current session — no
 | `/keepwright:audit` | Checks integration coverage of an existing repo against the architecture. |
 | `/keepwright:review` | Compares repo state against the patterns derived from your code and docs. |
 
+## Workflows
+
+Multi-agent orchestration the commands run under the hood — each fans out parallel agents and synthesizes the result. You normally don't call these directly (the commands trigger them), but they're invocable on their own for advanced use:
+
+| Workflow | What it does | Triggered by |
+|----------|--------------|--------------|
+| `/keepwright:map-brownfield` | Parallel read-only analysis of a large repo, synthesized into a config enrichment. | `setup` (large repos) |
+| `/keepwright:derive-patterns` | Mines the repo's design + writing-voice patterns into rules and validator specs. | `setup`, `review` |
+| `/keepwright:verify-setup` | Adversarially verifies a fresh setup in parallel: secrets, equalization, workflow YAML, validators, the P1–P5 hierarchy. | `audit --deep` |
+
+## Skills & agents
+
+- **Skills** — `keepwright` (the methodology behind the wizard) and `pr-review` (the review procedure the CI calls as `/pr-review #N`).
+- **Agents** — `design-auditor` and `voice-auditor`: read-only auditors that inspect the repo's design and writing-voice dimensions.
+
 ## Three layers
 
 - **Wizard** (`/keepwright:setup`) — an interactive command that detects git,

workflows/derive-patterns.js

@@ -7,7 +7,7 @@
 // agents read the repo and return structured output).
 
 export const meta = {
-  name: 'keepwright-derive-patterns',
+  name: 'derive-patterns',
   description: "Derive the repo's design + writing-voice patterns and turn them into rules and auto-validator specs",
   phases: [
     { title: 'Observe', detail: 'mine design + voice patterns in parallel' },

workflows/map-brownfield.js

@@ -5,7 +5,7 @@
 // tokens — the command only triggers it for non-trivial repos.
 
 export const meta = {
-  name: 'keepwright-map-brownfield',
+  name: 'map-brownfield',
   description: 'Map a brownfield repo in parallel and synthesize a keepwright config enrichment',
   phases: [
     { title: 'Scan', detail: 'analyze repo dimensions in parallel' },

workflows/verify-setup.js

@@ -5,7 +5,7 @@
 // apply (and is what /keepwright:audit can escalate to).
 
 export const meta = {
-  name: 'keepwright-verify-setup',
+  name: 'verify-setup',
   description: 'Adversarially verify a freshly applied keepwright setup in parallel',
   phases: [
     { title: 'Probe', detail: 'each dimension is attacked by an independent agent' },