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/:

Core Phases

• Research → prompts/research.md (produces SPEC.md)
• Design → prompts/design.md (produces DESIGN.md) — recommended for greenfield projects
• Implement → prompts/implement.md

Quality Phases (Optional)

• Bug finding → prompts/bug_finder.md
• Disprove → prompts/disprover.md
• Referee → prompts/referee.md

Other

• Onboarding → prompts/onboarding.md
• Compaction → prompts/compaction.md
• Orchestrate → prompts/orchestrate.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