governance-architect

governance-architect is a skill for Claude Code from synaptiai/synapti-marketplace. It costs 190 tokens per session (2,621 once invoked), scanned B, original, Apache-2.0.

A guided design tool for creating rules that control how AI agents make decisions. It saves six documents covering authority, boundaries, escalation, policy updates, decision records, and learning.

In plain words
What is it for?
Use it to define agent decision limits, escalation procedures, policy-writing processes, decision records, and review loops for an organization.
Why use it?
It helps replace unclear expectations with written rules for what agents may decide, when they must ask for help, and how those rules should change over time.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: agent in frontmatter; names the AskUserQuestion tool.

Part of the ai-first-org-design-kit plugin — 15 skills shipped together

Good fit Use it to define agent decision limits, escalation procedures, policy-writing processes, decision records, and review loops for an organization.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/synaptiai/synapti-marketplace/governance-architect
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.

Any agent
npx skills add synaptiai/synapti-marketplace --skill governance-architect
Clone the repo
git clone --depth 1 https://github.com/synaptiai/synapti-marketplace

Made for: Claude Code.

Or install ai-first-org-design-kit, the plugin that ships this one along with the rest of its 15 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for governance-architect

README.md
[![agentmods](https://agentmods.dev/badge/skills/synaptiai/synapti-marketplace/governance-architect/github.svg)](https://agentmods.dev/skills/synaptiai/synapti-marketplace/governance-architect)
Your own site
<a href="https://agentmods.dev/skills/synaptiai/synapti-marketplace/governance-architect"><img src="https://agentmods.dev/badge/skills/synaptiai/synapti-marketplace/governance-architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for governance-architect

Your own site · 80×15
<a href="https://agentmods.dev/skills/synaptiai/synapti-marketplace/governance-architect"><img src="https://agentmods.dev/badge/skills/synaptiai/synapti-marketplace/governance-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 190 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,621 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00190 $0.02621
Opus 5 $0.00095 $0.01311
Sonnet 5 $0.00038 $0.00524
Haiku 4.5 $0.00019 $0.00262

Measured 12d ago against content hash 3db9eda011c8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade B, and why

governance-architect scanned grade B with 1 finding 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 12d 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.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

chmod 700 "$HOME/.ai-first-kit" 2>/dev/null
plugins/ai-first-org-design-kit/skills/governance-architect/SKILL.md · 274 lines

How it starts

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

Governance Architect

You are a Governance Systems Designer — you build the complete ecosystem that keeps agents operating within bounds while maximizing their autonomy. One-line guardrails fail. You build ecosystems.

Your core insight: agents don't go rogue because they're malicious. They go rogue because the governance vacuum gave them no boundaries, no success criteria, and no escalation path.

Read ../../shared/concepts.md for Genome Structure before proceeding.

Work through these steps in order, announcing each step as you begin it:

Persona

  • Ecosystem thinker. Governance is not a list of rules. It's an interconnected system.
  • Failure-mode obsessed. For every boundary, ask "what happens when this gets tested?"
  • Learning-loop oriented. Governance that doesn't evolve becomes obsolete or oppressive.
  • Pragmatic about autonomy. More autonomy is better IF the boundaries are clear.

Pre-Flight

# Derive stable project slug from git repo root (not leaf dir, to prevent cross-repo collisions)
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
if [ -n "$REPO_ROOT" ]; then
  SLUG=$(basename "$REPO_ROOT" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | head -c 40)
else
  SLUG=$(echo "${PWD##*/}" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | head -c 40)
fi
[ -z "$SLUG" ] && SLUG="default"
mkdir -p "$HOME/.ai-first-kit/projects/$SLUG/governance"
chmod 700 "$HOME/.ai-first-kit" 2>/dev/null
# Check VALUES.md specifically (governance must align to values, not just identity)
GENOME_VALUES=$(ls "$HOME/.ai-first-kit/projects/$SLUG/genome/00-identity/VALUES.md" 2>/dev/null)
[ -n "$GENOME_VALUES" ] && echo "Genome found — governance will align to values" || echo "WARNING: No genome. Governance without values foundation is fragile."

Read the full file on GitHub · 274 lines

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. 12d ago First seen · 274 lines · 190 tokens per session scan B 3db9eda011c8

Subscribe to this mod's changes

governance-architect is a skill published in the GitHub repository synaptiai/synapti-marketplace (6 stars, last pushed yesterday), licensed Apache-2.0. It adds 190 tokens to every session and 2,621 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.