mcaf-solution-governance

A workflow for organizing project-wide rules in MCAF repositories, including root and project-level AGENTS.md files. It also defines how rules, skills, project structure, and maintainability limits are applied.

In plain words
What is it for?
Use it when starting a repository, restructuring a multi-project solution, or clarifying rule precedence, skill routing, and maintainability policies.
Why use it?
It reduces uncertainty about which instructions apply to each project in a repository containing multiple projects or modules.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/managedcode/mcpgateway/mcaf-solution-governance
Any agent
npx skills add managedcode/MCPGateway --skill mcaf-solution-governance
Clone the repo
git clone --depth 1 https://github.com/managedcode/MCPGateway

Made for: Claude Code, Codex.

Per session 64 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 982 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00064 $0.00982
Opus 5 $0.00032 $0.00491
Sonnet 5 $0.00013 $0.00196
Haiku 4.5 $0.00006 $0.00098

Measured 2d ago against content hash ab98e920b442, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

mcaf-solution-governance scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.codex/skills/mcaf-solution-governance/SKILL.md · 114 lines

How it starts

The opening of the file, as written. The whole thing — 114 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MCAF: Solution Governance

Trigger On

  • bootstrap or rewrite a repo-wide AGENTS.md
  • add project-local AGENTS.md files for a multi-project solution
  • clarify rule precedence, skill routing, or maintainability policy placement

Value

  • produce a concrete project delta: code, docs, config, tests, CI, or review artifact
  • reduce ambiguity through explicit planning, verification, and final validation skills
  • leave reusable project context so future tasks are faster and safer

Do Not Use For

  • writing feature specs or ADR content
  • code-level refactoring without a governance change

Inputs

  • current repo topology and module roots
  • existing root or local AGENTS.md files
  • actual build, test, format, and analyze commands
  • the active stack when commands or tooling are platform-specific

Quick Start

  1. Read the nearest AGENTS.md and confirm scope and constraints.
  2. Run this skill's Workflow through the Ralph Loop until outcomes are acceptable.
  3. Return the Required Result Format with concrete artifacts and verification evidence.

Workflow

  1. Identify the solution root and any project or module roots that need their own AGENTS.md.
  2. Keep the root file global:
    • shared workflow
    • shared commands
    • rule precedence
    • global skill list
    • maintainability-limit keys
  3. Keep local files narrow:
    • project purpose
    • entry points
    • boundaries
    • local commands
    • applicable skills
    • stricter local constraints
  4. Resolve overlap explicitly. Local rules may be stricter or more specific, never silently weaker.
  5. When the stack is .NET, record:
    • the test framework
    • the runner model (VSTest or Microsoft.Testing.Platform)
    • the repo-root .editorconfig as the analyzer config owner
  6. Put numeric maintainability limits in AGENTS.md, not in framework prose or skill bodies.

Deliver

  • one clear root AGENTS.md
  • local AGENTS.md files only where boundaries justify them
  • explicit precedence rules and skill-routing guidance

Read the full file on GitHub · 114 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 114 lines · 64 tokens per session scan A ab98e920b442

Subscribe to this mod's changes

mcaf-solution-governance is a skill published in the GitHub repository managedcode/MCPGateway (5 stars, last pushed 2d ago), licensed MIT. It adds 64 tokens to every session and 982 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.