Skip to content

SETUP.md

Latest commit

 

History

History
65 lines (50 loc) · 2.11 KB

SETUP.md

File metadata and controls

65 lines (50 loc) · 2.11 KB

Getting Started

The Freelance Developer Harness is a Claude Code operating system for running a structured agency team across multiple client projects. It gives you 17 specialized roles (architects, designers, developers, QA, security) organized into three councils, enforced quality gates, and an automated PM-driven workflow.

Quick start

git clone <this-repo> harness
cd harness
bash scripts/setup.sh

The setup wizard will ask for:

  • Your studio name
  • Where your project repos live on disk
  • API keys (Anthropic, Google — optional)
  • GitHub token (optional)

Then open Claude Code in this directory and follow the prompts at the end of setup.

What setup does

  • Writes .env from .env.template with your values
  • Substitutes your studio name into CLAUDE.md
  • Prints exact next steps

After setup

# In Claude Code:
/onboard-client acme-corp        # creates clients/acme-corp/ workspace
/use-client acme-corp            # locks this session to acme-corp
/pm on                           # enables automatic PM routing
/kickoff                         # run full project kickoff

Directory layout

harness/                  ← this repo (docs, specs, configs only)
clients/
  _template/              ← blueprint for new clients
  example-client/         ← example of a populated workspace
  your-client/            ← created by /onboard-client
    brief.md
    requirements.md
    projects/
      your-project/
        specs/            ← ADRs, PM summaries
        design/           ← design assets
        qa/               ← test reports
        deliverables/     ← client-facing outputs

../your-project/          ← source code lives HERE (sibling repo)

The harness holds intent (specs, briefs, deliverables). Source code lives in separate repos alongside it.

Full documentation

  • README.md — architecture, diagrams, how pieces connect
  • CLAUDE.md — complete operating model (loaded automatically by Claude Code)
  • AGENTS.md — team roster, authorities, governance matrix
  • docs/onboarding.md — team guide
  • docs/workflows/ — detailed per-stage workflow docs