Claude-Code-Base-Harness

English | Deutsch

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

📏 Rules

⚡ 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.

🤖 Agents

🎭 Output style

🎨 Base UI

🚀 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:

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.

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

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