convez.ai
SkillDesenvolvimento WebIntermediário
MaGe1993

Claude Code Base Harness

MaGe1993/Claude-Code-Base-Harness

Kit completo de configurações e automações para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Uma coleção curada de configurações, regras, skills e agents para Claude Code, pronta para copiar e adaptar. Inclui 26 skills, 8 rules, 3 agents, 8 hooks e um estilo de saída executivo, tudo organizado em arquivos simples para ~/.claude/ ou pasta do projeto.

Instalação

$npx convez-ai MaGe1993/Claude-Code-Base-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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Acelerar setup inicial de projetos com Claude Code
  • Padronizar workflows e output styles entre projetos
  • Adicionar skills reutilizáveis para tarefas comuns

Veredito

Um harness bem estruturado que reduz configuração manual. Útil para equipes que usam Claude Code regularmente e querem ponto de partida sólido com componentes prontos.

README

A tradução para o português deste README ainda está na fila.

header

English | Deutsch

Version License Claude Code

GitHub Stars GitHub forks ko-fi

PowerShell Bash Node.js Markdown

Rules · Skills · Hooks — copy what you need, adapt and go.

Report Bug · Request Feature

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#2FBF5E','primaryTextColor':'#ffffff','primaryBorderColor':'#1E9447','lineColor':'#0D9488','fontSize':'14px'},'flowchart':{'curve':'cardinal'}}}%%
flowchart TD
    classDef product fill:#0284C7,stroke:#0369A1,color:#fff,font-weight:bold
    classDef content fill:#2FBF5E,stroke:#1E9447,color:#fff
    classDef event   fill:#0D9488,stroke:#0A7A6F,color:#fff
    classDef store   fill:#0f172a,stroke:#2FBF5E,color:#a5b4fc
    classDef install fill:#1e293b,stroke:#334155,color:#94a3b8
    classDef zone    fill:#0f172a0F,stroke:#334155,color:#94a3b8

    harness(["📦 Claude-Code-Base-Harness — what's inside"]):::product

    harness --> skills[["🛠️ Skills ×26"]]:::content
    harness --> rules[["📏 Rules ×8"]]:::content
    harness --> agents[["🤖 Agents ×3"]]:::content
    harness --> hooks{{"⚡ Hooks ×8"}}:::event
    harness --> outstyle["🎭 Executive style"]:::content
    skills --> baseui[("🎨 base-ui CSS")]:::store

    subgraph od["▸ loaded on demand"]
        skills
        rules
        agents
    end
    subgraph wired["▸ wired via settings.json"]
        hooks
        outstyle
    end
    class od,wired zone

    harness -.->|"download & copy"| install[/"⬇️ ~/.claude or .claude"/]:::install

    linkStyle default stroke:#94a3b8,stroke-width:1.5px
    linkStyle 0,1,2,3,4 stroke:#2FBF5E,stroke-width:2px
    linkStyle 5 stroke:#0D9488,stroke-width:2px
    linkStyle 6 stroke:#334155,stroke-width:1.2px,stroke-dasharray:4\,3

What is it? · What you get · Installation · Support · License

A curated, opinionated set of Claude Code configuration artefacts — rules, skills, agents, hooks, output styles, and a base UI — that gives any project a correct Claude Code setup without authoring it from scratch. No plugin, no install: plain files you copy into ~/.claude/ (all projects) or a project's .claude/, then adapt.

🛠️ Skills

SkillWhat it does
audit-legalEU AI Act / GDPR / German-law compliance triage
audit-securityOWASP Top 10:2025 source-code security audit
echartsApache ECharts 5 charts in base-ui HTML
explainDepth-calibrated explanations, simple or deep
file-changelogAuthor CHANGELOG.md (Keep a Changelog 1.1.0)
file-claudeAuthor and audit CLAUDE.md; migrate auto-memory into it
file-licenseAuthor LICENSE and third-party attribution
file-projectAuthor PROJECT.md — the AI-facing architecture spec
file-readmeAuthor README.md — relevance-ordered, visual, GitHub-native
frontendStandalone HTML via the base-ui design system
hooksAuthor lifecycle hooks with companion scripts
lean-reviewRead-only quality review of any artifact
loopSet up and run recurring Claude Code loops
masterpromptBuild a maximal expert masterprompt on any topic
mcpAuthor and repair .mcp.json across all transports
mermaidGenerate styled, GitHub-renderable diagrams
new-projectScaffold a new Claude Code project end to end
outputstyleAuthor output style files; ships the Executive style
proofreadPre-ship verification of a finished deliverable
rulesAuthor rules; routes to hooks or settings when those fit better
settingsConfigure permissions, model selection, and env vars
skillsAuthor and maintain skills from a need or workflow
sotaGrounded state-of-the-art web research
subagentsAuthor specialist subagent definition files
tasksGuide to the Claude Code task system
toonConvert JSON or YAML to token-efficient TOON

📏 Rules

RuleWhat it covers
command-execution (always on)Claude runs commands itself; never asks you to
error-handlingNo silent catches, fail-fast, backoff, structured logging
json-styleJSON and JSONC conventions
md-styleMarkdown conventions for harness files
securityCredential handling, input validation, injection, supply chain
toon-styleToken-efficient tabular data for LLM prompts
visual-verifyScreenshot-verify visual output; no code-only sign-off
yaml-styleYAML and frontmatter conventions

⚡ Hooks

Each hook ships as a .ps1 + .sh pair behind one dispatch.mjs launcher — Windows runs the .ps1, macOS/Linux the .sh, nothing to swap by hand.

HookEventWhat it does
check-credentialsPreToolUseBlocks writes containing detected keys, tokens, or secrets
check-memorySessionStartDetects auto-memory files, prompts migration into CLAUDE.md
cleanup-sessionsSessionStartPrunes stale session artifacts under ~/.claude/
dangerous-cmd-guardPreToolUseBlocks catastrophic shell commands on both shells
format-on-writePostToolUseAuto-formats written files with installed formatters
post-compactSessionStartRe-injects PROJECT.md into context after compaction
pre-compactPreCompactBlocks compaction only when PROJECT.md is missing or stale
session-cost-loggerStop · PreCompact · SessionEndLogs token usage per turn

🤖 Agents

AgentRole
ag-cqoChief Quality Officer — audit and Approved/Rejected stage-gate
ag-csoChief Strategy Officer — outward state-of-the-art assessment
ag-ctoChief Technology Officer — writes, verifies, and self-reviews code

🎭 Output style

StyleMode
ExecutiveBottom-line first, terse, decision-ready

🎨 Base UI

AssetWhat it is
base-uiGreen-blue glassmorphism CSS for AI-generated HTML, no build step

🚀 Quick start — terminal

Fastest path — clone and copy into your project:

git clone https://github.com/MaGe1993/Claude-Code-Base-Harness.git
cp -r Claude-Code-Base-Harness/.claude Claude-Code-Base-Harness/CLAUDE.md your-project/

Then open a Claude Code session in your project and ask:

Read CLAUDE.md and .claude/skills/skills.index.toon, then tell me what's available.

[!TIP] Adapt CLAUDE.md to your project — fill in your build commands and paths, remove what does not apply. Everything else works as copied.

🛠️ Manual install — no terminal

  1. On the GitHub page, click Code → Download ZIP and extract it.
  2. Choose the scope:
    • One project only → the project's root folder.
    • All your projects → ~/.claude/ (your home .claude folder).
  3. Copy the extracted .claude folder and the CLAUDE.md file into the target with your file explorer.
  4. Open a Claude Code session there and ask it to read CLAUDE.md.

[!IMPORTANT] If a settings.json already exists in the target, merge the hooks block manually — each hook event is an array; append rather than overwrite the whole file.

Every artifact is standalone. Copy individual pieces, then trim CLAUDE.md to reference only what you copied:

WantCopy
Just the skills.claude/skills/
Just the format rules.claude/rules/md-style.md, json-style.md, yaml-style.md
Just the output style.claude/output-styles/executive.md + the outputStyle key
Just the hooks.claude/hooks/ (incl. dispatch.mjs) + the hooks block
Just the base UI.claude/skills/frontend/assets/base-ui/

Pull with git pull origin main (or re-download the ZIP). Check CHANGELOG.md for breaking changes, re-read the skill and agent index files in open sessions, and merge any new CLAUDE.md routing rows or settings.json hook registrations manually — do not overwrite your customizations.

If this harness saves you time, a GitHub star helps others find it.

GitHub Stars

Enjoying it? Buy me a coffee on Ko-fi — it keeps the harness growing.

ko-fi

MIT — © 2026 Dr. Marius Gensler. See LICENSE.

footer

Ver o original no GitHub

Bom para

Relacionados