Claude Code Harness
robinbril/claude-code-harness
Metodologia + craft skills para código de qualidade com Claude
Ver no GitHubUma metodologia estruturada para desenvolvimento com Claude Code, baseada em Superpowers (MIT) com skills de brainstorming, TDD, debugging sistemático e decision-council. Inclui CLAUDE.md pré-configurado com guidelines de código estilo Karpathy e humanizer para remover padrões de AI dos textos gerados.
Instalação
npx convez-ai robinbril/claude-code-harness1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Estruturar workflows de desenvolvimento autônomo em Claude Code
- Implementar TDD, debugging sistemático e verificação antes de completar tarefas
- Gerar interfaces, landing pages e documentos sem template patterns
- Coordenar decisões complexas via council de múltiplos advisors
Veredito

Harness bem arquitetado que eleva o padrão de trabalho com Claude Code além da improvisação. Combina rigor metodológico (brainstorm → plan → TDD → verify) com skills de craft reutilizáveis, eliminando o improviso e texto genérico de IA. Prático para times que precisam de outputs consistentes e auditáveis.
README
A tradução para o português deste README ainda está na fila.
Claude Code Harness
Een solide, niet-overweldigende harness voor Claude Code. Gebouwd op
Superpowers van Jesse Vincent (MIT),
getrimd tot de skills die het meeste opleveren, met twee eigen toevoegingen
(supergoal en council) en een CLAUDE.md die gedrag (code-guidelines) en
schrijfstijl (humanizer) standaard goed zet.
Wat erin zit
CLAUDE.md is twee lagen, standaard aan:
- Code-guidelines (Karpathy-stijl): denk voor je codeert, simpel houden, chirurgische changes, doelgericht met verifieerbare success criteria.
- Humanizer: alle tekst zonder AI-randje. Geen em-dashes, geen sycophantische openers, geen slop-woorden, antwoord-eerst.
skills/ is methodologie (hoe je werkt) plus craft (wat je maakt).
Methodologie, triggert vanzelf zodra je bouwt:
| Skill | Wanneer |
|---|---|
brainstorming | Voor je iets bouwt: scope en spec scherp krijgen |
grill | Een plan of design stuk voor stuk uitvragen tot het scherp is |
skill-finder | Eerst checken of er al een skill bestaat voor je iets bouwt |
writing-plans | Een plan dat een junior zonder context kan volgen |
test-driven-development | Echte red/green TDD |
systematic-debugging | Bug reproduceren, isoleren, fixen, verifiëren |
verification-before-completion | Bewijs draaien voor je "klaar" claimt |
supergoal | Een grote taak autonoom plannen en bouwen, met een onafhankelijke check per fase |
council | Een zware, moeilijk omkeerbare keuze laten uitvechten door meerdere adviseurs |
karpathy-guidelines | De Karpathy-regels tegen veelgemaakte LLM-coding-fouten, als losse skill |
using-superpowers | Orchestrator: zorgt dat de juiste skill automatisch triggert |
Craft, dagelijks bruikbaar, ook zonder code:
| Skill | Wanneer |
|---|---|
humanizer | Elke tekst zonder AI-randje (mail, post, vacaturetekst) |
frontend-design | Een verzorgde, niet-template UI of pagina |
designing-beautiful-websites | UX-strategie, IA, wireframes en visueel design van begin tot eind |
design-an-interface | Meerdere radicaal verschillende interface-opties genereren via parallelle agents |
landing-page-design | Pagina's die converteren (campagne, vacature, lead) |
vercel-react-best-practices | React/Next.js performance-regels van Vercel Engineering |
vercel-react-view-transitions | Vloeiende route- en element-animaties met de View Transition API |
office-docs | PowerPoint, Excel en Word programmatisch maken |
De loop: brainstorm, plan, TDD, debug, verify. grill vraagt je plan eerst stuk
voor stuk uit, skill-finder checkt of er al een skill voor bestaat. supergoal
draait die hele keten autonoom voor een grote taak en laat niks "klaar" zijn tot
een onafhankelijke controleur het bewijst. council haalt er meerdere adviseurs
bij voor een zware keuze, en teacher leert je een sessie of codebase echt
begrijpen met quizvragen tot je het kunt navertellen. De craft-skills pakken het
zichtbare werk: schrijven, UI en documenten.
Installeren (Claude Code)
Clone de repo:
git clone https://github.com/robinbril/claude-code-harness.git
cd claude-code-harness
Windows, in PowerShell:
powershell -ExecutionPolicy Bypass -File .\install.ps1
macOS / Linux:
bash install.sh
Het script plaatst de skills in ~/.claude/skills/ en de CLAUDE.md in
~/.claude/. Het raakt je bestaande skills niet aan en maakt back-ups van wat het
vervangt. Herstart Claude Code daarna.
De skills triggeren vanzelf zodra je begint te bouwen, of typ / om er een te
kiezen. Je hoeft niks te onthouden.
Auto-trigger bij sessiestart loopt via
hooks/hooks.json(de Superpowers SessionStart-hook). Dat is optioneel: ook zonder de hook werken de skills via het/-menu en de Skill-tool.
Hooks
Twee guard-hooks zitten in hooks/. Als plugin laden ze vanzelf via
hooks/hooks.json. Bij de install.sh-route wijs je ze handmatig aan in je
~/.claude/settings.json (zie onder). Beide hebben node nodig.
humanizer-guardscant elke Write/Edit van een prosebestand (.md,.txt,.html) en blokkeert harde AI-tells (em-dash, sycophantische openers, slop-woorden) voor ze landen. Zachte tells (robuust, leverage, naadloos) komen als waarschuwing. Code en inline-code zijn uitgezonderd.commit-guarddraait op elkegit commiten blokkeert wat niet de repo in mag: secrets en API-keys, en temp/scratch-bestanden (.env,*.tmp,*.bak,__pycache__). Emails en em-dashes komen als waarschuwing. Zet eigen patronen (een naam, bedrijf, hostname) in.harness-blocklistin de repo-root, één regex per regel.
Na de install.sh / install.ps1-route staan de hooks in
~/.claude/claude-code-harness/hooks/. Merge dan settings.example.json in je
~/.claude/settings.json om ze aan te zetten, samen met defaultMode: auto en
remoteControlAtStartup. Let op: auto slaat permissie-prompts over, dus kijk
het na voor je het inschakelt.
Statusline (optioneel)
Wil je context-gebruik, actieve tools, agents en todo-voortgang in je terminal-statusbar, gebruik dan claude-hud van Jarrod Watts. Het draait op Claude Code's eigen statusline-API, geen apart venster of tmux nodig:
/plugin install claude-hud
/claude-hud:setup
Kleuren en layout pas je aan in ~/.claude/plugins/claude-hud/config.json.
Herkomst
De methodologie-basis komt uit Superpowers v5.1.0, MIT-licentie (zie LICENSE).
Weggelaten: de dev-zwaardere en multi-step skills (git-worktrees, code-review-flow,
branch-finishing, subagent-driven-development, writing-skills) en de multi-harness
setup (Codex/Cursor/Gemini), om het rustig en Claude-Code-gericht te houden.
supergoal en council zijn los toegevoegd bovenop Superpowers. supergoal plant
en bouwt een taak autonoom met een onafhankelijke evaluator die elke check opnieuw
draait tegen de echte app. council laat meerdere adviseurs een zware keuze
uitvechten via blinde peer-review en een synthese. Verder toegevoegd: grill,
teacher, skill-finder en karpathy-guidelines (de Karpathy-md tegen
LLM-coding-fouten, MIT), plus twee guard-hooks (humanizer en commit). De
craft-skills en alle toevoegingen zijn generiek, zonder persoonlijke of
bedrijfsspecifieke inhoud.