tools/skills/aaf-epistemic-gates/SKILL.md
Guides when and where to place epistemic gates; candidate → validated → authority; gates scale with risk. Use when defining validation vs authority, reducing "AI said so" authority, or designing high-stakes decision flows.
npx skillsauth add agenticaf-community/frameworkcore aaf-epistemic-gatesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
An epistemic gate is the point where an AI output stops being a possibility and becomes something the system (or a human) treats as knowledge, decision, or action. This skill helps place and scale those gates.
Epistemic gates must scale with risk.
1. Generation
The model produces candidates: drafts, options, plans, hypotheses, tool arguments. At this stage treat outputs as candidates, not truth.
2. Validation
Truth and constraints are reintroduced through mechanisms the model does not control:
3. Authority
A defined actor (human, policy engine, or supervisor under strict rules) converts validated output into action. If authority is implicitly granted to the model (“because the AI said so”), the epistemic boundary has collapsed.
When the agent cannot verify, or action is high-risk or irreversible, the system should stop and escalate—not proceed. Escalation should be a first-class interrupt (e.g. APPROVAL_REQUIRED) with a structured packet: proposed action, risk class, policy binding, evidence so far, resume semantics. This makes approvals auditable and resumption deterministic.
“Done” cannot be a narrative claim. Every task class should have a Definition of Done, acceptance checks, and evidence artifacts. Validation gates should be deterministic where possible; verification evidence should be surfaced to operations.
docs/03-what-is-an-agent.md (§2.5)docs/13-autonomy-governance.mddocs/01-executive-summary.mdtools
--- name: aaf-security description: Applies the AAF Security pillar: boundaries, tool actuation, epistemic gatekeeping, supply chain. Use when designing security for agentic systems, tool gateways, prompt-injection mitigations, privilege separation, or supply-chain risk for skills/tools. --- # AAF Security Security in agentic systems is impact-reduction: assume the reasoning layer can be influenced, and architect so that influence cannot easily become harmful actions. This skill distills the A
tools
Helps build agent orchestration properly using the Orchestrator Capability Contract (OCC) and governance-above-orchestration pattern. Use when choosing or implementing orchestration (graphs, multi-agent, workflows), ensuring tool gateway is non-bypassable, or satisfying OCC requirements for audit and safety.
development
Applies the two AAF cross-cutting foundations—Context Optimization and Autonomy & Outcome Governance. Use when designing context vs memory, context budgeting, autonomy levels, Definition of Done, budgets, or escalation.
tools
--- name: aaf-cost-context description: Applies AAF Cost pillar and context optimization: budgets, model routing, token economics, context discipline. Use when controlling cost in agentic systems, budgeting context, choosing model routing, or designing for token economics. --- # AAF Cost & Context Cost optimization in agentic systems is an architectural requirement: autonomy without budgets is cost volatility by design. Context optimization cross-cuts cost, performance, reliability, and securi