setup-codebase-harness

Solid

Master skill — set up the full agent harness for any repo so an agent can work it reliably: legible (map-not-manual docs + custom lints), executable (one-command dev stack), verifiable (e2e gate + a verify-before-ship loop), plus commit hygiene and entropy control. Use when onboarding a new/unfamiliar codebase to agent-driven development — "set up the harness", "make this repo agent-ready", "harness this codebase".

Code & Development 1,064 stars 141 forks Updated today

Install

View on GitHub

Quality Score: 83/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
0
Description 5%
100

Skill Content

# Set up the codebase harness **Harness engineering:** the model is fixed — what you engineer is the *scaffolding* around it (the environment, the docs, the feedback loops) so an agent can build and verify software with minimal human attention. Humans steer; agents execute. Your job is to make the repo **legible, executable, and verifiable.** Work **incrementally and depth-first**: assess what exists, build the one missing capability, use it to unlock the next. Don't boil the ocean — set up what the repo actually needs. When the agent struggles, the fix is almost never "try harder" — ask *"what capability is missing, and how do I make it legible and enforceable?"* and add it. This skill orchestrates the focused sub-skills: **`dev-local-setup`**, **`e2e-setup`**, **`crabbox-setup`** (cloud/parallel), and **`verifier-setup`** (scaffolds a repo-specific **`/verify`** loop; supersedes the older **`pr`** skill). ## 0. Assess Survey the repo: stack, package manager, services/ports, infra deps, existing docs/tests/CI, and the *implicit* rules (buried in READMEs, PR comments, people's heads). Note what's missing per pillar below. ## 1. Legible — the agent can reason about the repo > What the agent can't see doesn't exist. Knowledge in chat threads / heads is > invisible — push it into versioned, repo-local artifacts. - **a) Map, not manual.** Shrink the root agent doc (`AGENTS.md` / `CLAUDE.md`) to a ~100-line **table of contents**: one-line overview, project tree, **golden...

Details

Author
AI-Builder-Club
Repository
AI-Builder-Club/skills
Created
1 months ago
Last Updated
today
Language
Python
License
None

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

harness-eng

Use when designing, evaluating, or simplifying an agent project harness: AGENTS.md/CLAUDE.md rules, startup scripts, progress logs, feature trackers, handoffs, evaluator rubrics, quality documents, repo-local knowledge maps, and mechanical guardrails for coding agents. Especially useful when converting raw agent-workflow notes into a concise, verifiable project control layer.

3 Updated today
MasihMoafi
AI & Automation Listed

init-harness

One-shot initialization of a parallel-terminal Claude Code build harness in a project - phase checkboxes as the task queue, pinned model/effort per agent, mechanical git-tag gates, hardened read/gate/log hooks, Obsidian memory vault plus SQLite agent memory, human-gated pivots, and CI drift checks. Use when the user says "/init-harness", "init-harness", "initialize the harness", "set up the build harness", "scaffold this project's harness", "bootstrap the agent harness", or drops in a project-context.yml and asks to initialize. Also use when a project needs multi-terminal agent orchestration with gates, or when an existing harness must be verified/repaired (hooks not firing, guards not blocking, .agents drift). Do NOT use for adding a single agent or skill to an existing project.

1 Updated 5 days ago
M4NUSH7
AI & Automation Listed

bootstrap-harness

Create a complete AI-agent harness (CLAUDE.md + supporting docs system) for any project. Portable across Python/Java/TS/Go. Based on 2025-2026 best practices (AGENTS.md spec, GitHub's 2,500-repo study, ACE paper, context-engineering research). Use when a repo has no harness, was just cloned/scaffolded, or its docs are bloated/stale and need a structured rebuild.

3 Updated 1 weeks ago
TIANTIAN-ZHAN