MCAF Adoption

Trigger On

• bootstrapping MCAF in a new or existing repository that also contains .NET work
• updating root or project-local AGENTS.md files to follow a durable repo workflow
• deciding which MCAF governance skills and dotnet-* implementation skills to install together
• organizing repo-native docs for architecture, features, ADRs, testing, development, and operations

Workflow

1. Start from the canonical bootstrap surface:
   • tutorial: https://mcaf.managed-code.com/tutorial
   • concepts: https://mcaf.managed-code.com/
   • public MCAF skills: https://mcaf.managed-code.com/skills
2. Place root AGENTS.md at the repository or solution root.
3. Add project-local AGENTS.md only when the solution has multiple projects with genuinely different local rules.
4. Install MCAF governance skills (dotnet-mcaf-*) for process areas and dotnet-* implementation skills for framework work. Check references/skill-map.md for overlap before adding duplicate surfaces.
5. Route to the narrowest MCAF skill once the governance concern is clear: