60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
|
# 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
|
||
|
|
```
|