Skip to content

feat: redesign as keepwright — plugin with setup wizard, deterministic engine, and workflows - #6

Merged
leonardocandiani merged 4 commits into
mainfrom
feat/keepwright
Jun 5, 2026
Merged

leonardocandiani merged 4 commits into
mainfrom
feat/keepwright

Conversation

@leonardocandiani

Copy link
Copy Markdown
Owner

keepwright — redesign

Rebrands setup-projeto-qualidade to keepwright and restructures it from a single interpreted skill into an installable Claude Code plugin.

What's new

  • Three layers: an interactive wizard command, a deterministic engine (scripts), and orchestration workflows. Mechanical work goes to scripts; judgment stays with the model/workflows.
  • Commands: /keepwright:setup (wizard), /keepwright:audit (integration coverage), /keepwright:review (state vs the repo's derived patterns).
  • Engine (bun): detect / apply / audit — idempotent scaffolding, anti-secret scan, stack matrix.
  • Workflows (.js): map-brownfield, derive-patterns (mines design + writing voice → rules/validators), verify-setup (adversarial parallel verification).
  • Skills/agents: versioned pr-review skill; design-auditor + voice-auditor.
  • Auth: /install-github-app (OAuth) primary, setup-oauth-secret.sh fallback.
  • AI review upgrades: /pr-review (kills the duplicated inline prompt), /code-review ultra fallback, GitHub rulesets, model pinning.
  • i18n: the plugin is 100% English; generated artifacts adapt to the user's configured language.
  • Unifies the empirical-proof rule (from origin/main) with the advisory/OAuth review architecture.

Validated

Engine validated on fixtures: idempotent re-apply (skips), audit coverage 100, anti-secret abort, placeholder substitution, and a full PT→EN rename without breaking references.

Not yet validated (runtime smoke — needs a real install)

The command .md and workflow .js files were not executed — they need ${CLAUDE_PLUGIN_ROOT} resolved via an installed plugin. Smoke flow to run after install: /keepwright:setup → wizard → /install-github-app (OAuth) → test PR → confirm CI + /pr-review + auto-merge.

Install

/plugin marketplace add leonardocandiani/keepwright then /plugin install keepwright.

…c engine, and workflows

Rebrand setup-projeto-qualidade to keepwright and restructure it from a single
interpreted skill into an installable Claude Code plugin.

- /keepwright:setup interactive wizard, plus /keepwright:audit and /keepwright:review
- Deterministic engine (detect/apply/audit) scaffolds idempotently, anti-secret guarded
- Orchestration workflows: map-brownfield, derive-patterns, verify-setup
- Versioned pr-review skill + design/voice auditor agents
- Auth via /install-github-app (OAuth), setup-oauth-secret.sh as fallback
- AI review upgrades: /pr-review, /code-review ultra fallback, GitHub rulesets
- 100% English; generated artifacts adapt to the user's configured language
- Unifies the empirical-proof rule with the advisory/OAuth review architecture

Autor: Leonardo Candiani
- Translate residual PT prose (CODE_OF_CONDUCT, issue/PR templates) to English
- Rename PT slugs across templates and docs (licoes → lessons,
  casos-referencia → reference-cases, registro-construcao → build-log,
  arquitetura → architecture)
- Repair ci.yml: the "verify templates exist" job listed 7 pre-rename PT
  filenames that no longer exist, which broke the gate
- CODE_OF_CONDUCT.md is now Contributor Covenant 2.1 (English)
- git mv templates/licoes → templates/lessons; the engine derives paths from it
- README: 8-bit forge GIF as hero, plus brand assets under assets/

Autor: Leonardo Candiani
The CI still checked for a root SKILL.md named setup-projeto-qualidade (the pre-plugin layout), so it failed on every push. Validate the plugin manifest, commands, the skill under skills/keepwright/, and the orchestration workflows instead, and bring the template list in lockstep with the shipped tree.

Autor: Leonardo Candiani
The repo was renamed setup-projeto-qualidade → keepwright. Update the discussions URL, the generated settings header, and a lesson example. The CHANGELOG keeps the old name where it records the rebrand.

Autor: Leonardo Candiani
@leonardocandiani
leonardocandiani merged commit 992fc5b into main Jun 5, 2026
1 check passed
@leonardocandiani
leonardocandiani deleted the feat/keepwright branch June 5, 2026 18:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant