AGENTS.mdAn AGENTS.md file is the de-facto standard for providing coding agents with context about a project or a part thereof. Microbus utilizes this concept to train coding agents how to work correctly on a Microbus solution in general, and on each individual microservice.
A global AGENTS.md file at the root of the project includes context that is applicable to the project as a whole. The first instruction in that file points the coding agent to AGENTS-MICROBUS.md.
The AGENTS-MICROBUS.md file (also located at the root of the project) includes instructions for working on a Microbus solution in general. This file may be updated with each release of Microbus and should not be edited by hand. Use the code generator to refresh this file in your project with each new release of Microbus.
The .claude/skills directory is a collection of workflows that guide the coding agent when working on complex multi-step tasks. These skills are referenced in AGENTS-MICROBUS.md.
An AGENTS.md file placed in the directory of each microservice keeps context that is applicable to that single microservice alone. This local AGENTS.md is maintained by the coding agent itself as it works on the microservice, but it can also be edited by hand.
Since Claude may not recognize AGENTS.md, next to each AGENTS.md file you’ll find a simple CLAUDE.md file that tells Claude to read AGENTS.md.