1.4 KiB
1.4 KiB
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)
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:
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:
cd ~/.agent-framework && git pull