share-harness

A minimal Claude Code harness designed to be dropped into any repository. The /onboard-shared command provisions the full .claude/ directory into a target repo in one shot.

What's inside

• agents/code-reviewer-shared.md — A subagent dedicated to diff review. Returns findings on SOLID, maintainability, and security.
• skills/code-review-shared/ — A thin wrapper skill that dispatches code-reviewer-shared via Task.
• skills/pr-create-shared/ — A skill that analyzes the branch and drives gh pr create to open a Pull Request.
• commands/onboard-shared.md — The slash command that installs this harness into another repository.
• scripts/install.sh — The installer that /onboard-shared invokes under the hood.
• settings.json.example — Permission policy with allow / ask / deny tiers (rm -rf, sudo, git push --force, .env access, etc. are denied by default).
• docs/templates/ — Templates copied into the target repo: AGENTS.md, CODING_GUIDELINES.md, PULL_REQUEST_GUIDELINES.md, progress.md, handoff/CURRENT.md.

Usage

1. Clone

git clone git@github.com:<owner>/share-harness.git ~/src/share-harness

2. Run install.sh against the target repo

cd /path/to/your-project
~/src/share-harness/scripts/install.sh .

install.sh is idempotent. Any existing .claude/ is first backed up with a timestamp, then the harness files are copied on top (files you've added under .claude/ are preserved). Root-level templates such as CLAUDE.md, AGENTS.md, CODING_GUIDELINES.md, and PULL_REQUEST_GUIDELINES.md are placed only when they don't already exist — existing ones are never overwritten.

3. Launch

claude
> /onboard-shared    # Sanity-check the installation

From there, run /code-review-shared to review the current diff, or /pr-create-shared to open a Pull Request.

License

MIT