From ad21cf9f8ded59d96ed4096688cc36e76d5ef6e9 Mon Sep 17 00:00:00 2001 From: Leonardo Candiani Date: Fri, 5 Jun 2026 15:36:59 -0300 Subject: [PATCH] fix: clean workflow names and document them in the README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Workflow meta.name dropped the redundant keepwright- prefix (map-brownfield, derive-patterns, verify-setup) — they were surfacing as /keepwright:keepwright-*. Commands trigger them by scriptPath, so no behavior change. README now documents the workflows plus the skills/agents the plugin exposes. Bump to 2.0.1. Autor: Leonardo Candiani --- .claude-plugin/marketplace.json | 4 ++-- .claude-plugin/plugin.json | 2 +- CHANGELOG.md | 14 ++++++++++++++ README.md | 15 +++++++++++++++ workflows/derive-patterns.js | 2 +- workflows/map-brownfield.js | 2 +- workflows/verify-setup.js | 2 +- 7 files changed, 35 insertions(+), 6 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 284fa90..d1f64b9 100644 --- a/.claude-plugin/marketplace.json +++ b/.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" }, diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index bc6fbd0..00c7901 100644 --- a/.claude-plugin/plugin.json +++ b/.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" diff --git a/CHANGELOG.md b/CHANGELOG.md index b507a13..f0d1ad8 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/README.md b/README.md index 182b07a..4a609b5 100644 --- a/README.md +++ b/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, diff --git a/workflows/derive-patterns.js b/workflows/derive-patterns.js index b2c3f75..71f9567 100644 --- a/workflows/derive-patterns.js +++ b/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' }, diff --git a/workflows/map-brownfield.js b/workflows/map-brownfield.js index bdd9398..4fcdb9f 100644 --- a/workflows/map-brownfield.js +++ b/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' }, diff --git a/workflows/verify-setup.js b/workflows/verify-setup.js index ea73576..580f555 100644 --- a/workflows/verify-setup.js +++ b/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' },