# {{PROJECT_NAME}}

Multi-agent pipeline built with [arccrew](https://github.com/amonrreal/arccrew).

## Setup

```bash
# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate        # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure API keys
cp .env.example .env
# Set ANTHROPIC_API_KEY (or another provider) in .env

arccrew check
```

## Build your pipeline

Open this project in Claude Code and run:

```
/build-agents  — generate a full pipeline from a description
/add-agent     — add a single agent to an existing pipeline
```

## Run

```bash
# Start the API server
arccrew serve

# Call the pipeline
curl -X POST http://localhost:8000/api/run \
  -H "Content-Type: application/json" \
  -d '{"pipeline": "my_pipeline", "tasks": [{"description": "your task here"}]}'

# Health check
curl http://localhost:8000/api/health

# MCP server (for Claude Desktop and other MCP clients)
arccrew serve-mcp
```

## Project structure

```
agents/          — agent classes (extend arccrew.BaseAgent)
prompts/         — prompt files
  global.md      — rules applied to all agents
  {agent}.md     — role, tools, output schema for each agent
tools/           — custom @tool functions
state.py         — custom state (extend PipelineState for domain-specific fields)
pipeline.py      — graph wiring + pipeline registration
tests/           — agent and tool tests
.env             — API keys and config (never commit this)
```

## Other commands

```bash
pytest                    # Run tests
ruff check .              # Lint
arccrew sync-skills     # Update skills after pip upgrade
```
