For the past few weeks I've been using several agents privately and at the company I'm working for. In that time, across several harnesses, I generated quite a few chats used to plan, architect, implement, release, and deploy various tools and modules. I assembled those conversations and outcomes into a set of AGENTS.md files which I wanted to share. It is still a work in progress and will be extended in the future. It is MIT-licensed and free to use. Any feedback is welcome.
michail-peterlis
/
AGENTS.md
A modular, enterprise-grade AGENTS.md framework for reliable multi-agent software engineering with explicit roles, policies, workflows, review gates, and progressive context loading.
Enterprise Agents
A modular AGENTS.md framework for disciplined multi-agent software engineering.
Coding agents can produce code quickly. Reliable software engineering also requires:
- explicit edit ownership
- scoped acceptance criteria
- independent review
- evidence preservation
- test integrity
- architecture discipline
- production safety
- progressive context loading
Enterprise Agents is an opinionated governance framework built around the open AGENTS.md convention. It is not a new AGENTS.md standard.
What this repository provides
AGENTS.md universal repository rules
.agents/roles/ who the agent is
.agents/policies/
cross-cutting engineering rules
.agents/skills/
just-in-time workflows
nested AGENTS.md
component-specific rules
task/plan what is being done now
The root AGENTS.md acts as a router for the framework unless a particular harness provides native support for additional files.
Compatibility statement
This project uses the open AGENTS.md convention for repository-level instructions. The .agents/roles, .agents/policies, .agents/skills, templates, and related structure are an opinionated extension provided by this framework and are not part of the core AGENTS.md…
How it is structured
Instead of packing every rule into one huge AGENTS.md file that consumes the context window, the root AGENTS.md acts as a lightweight router for progressive context loading across .agents/:
AGENTS.md universal repository rules
.agents/roles/ who the agent is (architect, implementer, challenger, etc.)
.agents/policies/ cross-cutting engineering rules
.agents/skills/ just-in-time workflows and POSIX sh coordination helpers
.agents/templates/ reusable task, state, handoff, and review records
Key principles
- Progressive context loading: Agents read only the root AGENTS.md, their assigned role, and task-relevant policies or skills rather than preloading every document.
- Independent review: Separates implementation from adversarial review (challenger role) with explicit single-writer ownership and acceptance tiers (T0–T2).
- Harness-independent: Works across single sessions, delegated subagents, headless staged runs, or live peer sessions coordinating over a git-ignored .agents/workspace// file channel.
- Dual-edition releases: Ships both the full kit and a condensed lite edition for smaller context windows, for local models.
Top comments (0)