Initial commit: minimal agent framework

README.md

@@ -0,0 +1,60 @@
+# 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
+```