convez.ai
SkillAutomaçãoIntermediário
robinbril

Claude Code Harness

robinbril/claude-code-harness

Metodologia + craft skills para código de qualidade com Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Uma 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-harness

1 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

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
—
Issues abertas
0
Contribuidores
1

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:

SkillWanneer
brainstormingVoor je iets bouwt: scope en spec scherp krijgen
grillEen plan of design stuk voor stuk uitvragen tot het scherp is
skill-finderEerst checken of er al een skill bestaat voor je iets bouwt
writing-plansEen plan dat een junior zonder context kan volgen
test-driven-developmentEchte red/green TDD
systematic-debuggingBug reproduceren, isoleren, fixen, verifiëren
verification-before-completionBewijs draaien voor je "klaar" claimt
supergoalEen grote taak autonoom plannen en bouwen, met een onafhankelijke check per fase
councilEen zware, moeilijk omkeerbare keuze laten uitvechten door meerdere adviseurs
karpathy-guidelinesDe Karpathy-regels tegen veelgemaakte LLM-coding-fouten, als losse skill
using-superpowersOrchestrator: zorgt dat de juiste skill automatisch triggert

Craft, dagelijks bruikbaar, ook zonder code:

SkillWanneer
humanizerElke tekst zonder AI-randje (mail, post, vacaturetekst)
frontend-designEen verzorgde, niet-template UI of pagina
designing-beautiful-websitesUX-strategie, IA, wireframes en visueel design van begin tot eind
design-an-interfaceMeerdere radicaal verschillende interface-opties genereren via parallelle agents
landing-page-designPagina's die converteren (campagne, vacature, lead)
vercel-react-best-practicesReact/Next.js performance-regels van Vercel Engineering
vercel-react-view-transitionsVloeiende route- en element-animaties met de View Transition API
office-docsPowerPoint, 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-guard scant 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-guard draait op elke git commit en 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-blocklist in 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.

Ver o original no GitHub

Bom para

Relacionados