Mission: Save tokens for the machine. Save orientation for the human.
BEMYAGENT is a lightweight, self-bootstrapping protocol designed to initialize AI-assisted software projects. It establishes a structured environment that prevents AI context bloat, reduces token consumption, and keeps developers perfectly oriented.
When working with autonomous agents or AI coding assistants on complex projects, the context window quickly becomes cluttered. Agents lose track of the architecture, hallucinate changes outside the scope, or read thousands of irrelevant lines, slowing down the process and increasing costs.
BEMYAGENT provides a single markdown file (BEMYAGENT.md) that acts as a bootstrap prompt. When fed to an AI, it automatically generates a structured filesystem:
docs/: Permanent, immutable truth (architecture, code map, tech stack).work/: Tactical, volatile memory organized by Task/Milestone.
- Lazy Loading: The AI is explicitly instructed never to read documentation drafts or specs during context restoration unless strictly required by the current task.
- Think-Task-Execute (TTE): A rigid workflow inside the
work/directory. The AI must strategize (01_think.md), plan atomic steps (02_tasks.json), and log actions (03_execute.log) before writing any code. - Self-Registration: The AI automatically configures the project's native rule files (e.g.,
.cursorrules,AGENTS.md) to read the core00-ai-rules.mdat the start of every session.
- Drop
BEMYAGENT.mdinto the root of your project. - Ask your AI assistant to read the file and execute its instructions sequentially.
- The AI will generate the directories and templates.
- Delete
BEMYAGENT.md(or keep it if you are iterating on the protocol!) and start coding.
This repository itself uses the BEMYAGENT protocol. You can explore the sandbox/ directory to see a live example of the generated architecture. In fact, we use this very sandbox to document, plan, and evolve the BEMYAGENT protocol itself.
This project is licensed under the MIT License - see the LICENSE file for details.