# agent-framework

Minimal, prompt-driven agent framework for Claude Code / Codex / any CLI agent.

Radical simplicity. One focused session per task. Context hygiene first.

## Install (One-time)

```bash
git clone https://gitea.yourdomain.com/you/agent-framework.git ~/.agent-framework
```

That's it. The framework now lives at `~/.agent-framework`.

## Per-Project Setup

Every project only needs two files:

```bash
mkdir -p /path/to/project/.agent-framework
```

Create:

- `.agent-framework/AGENT.md` — project router (points to global framework)
- `.agent-framework/RULES.md` — project-specific hard constraints

Then run the onboarding prompt:

> "Onboard this project to the agent framework"

## Usage

All work happens through prompts in `~/.agent-framework/prompts/`:

- Research → `prompts/research.md`
- Implement → `prompts/implement.md`
- Bug finding → `prompts/bug_finder.md`
- Disprove → `prompts/disprover.md`
- Referee → `prompts/referee.md`
- Onboarding → `prompts/onboarding.md`
- Compaction → `prompts/compaction.md`

See `ONBOARDING.md` for detailed drop-in vs from-scratch scenarios and the full philosophy.

## Principles

- Less is more
- Separate research from implementation (fresh sessions)
- AGENT.md is a lightweight if/else router, not a dump
- Clear contracts and stop conditions
- Multi-agent verification loop when quality matters

## Updating

Pull the latest changes anytime:

```bash
cd ~/.agent-framework && git pull
```