stSean Tosello
06

Agentic Governance and Execution Framework

Execution-layer governance architecture for AI coding agents with deterministic routing, mandatory runtime gates, and a planned CLI bootstrap.

agentic-aigovernanceorchestrationclideveloper-toolingautomation

AGEF is a governance-first orchestration architecture for agentic software execution. The framework has evolved from initial architecture design into a working system with 40+ formal Architecture Decision Records (ADRs), machine-readable policy documents (intake, planning, and context policies), a git-backed event log, and the Consumer Bootstrap Protocol v0.1 for initializing and upgrading the framework across consumer repositories. The control-plane separates intent classification, planning, gate-controlled execution, and audit persistence into explicit layers. A Schema Evolution Protocol (SEP) governs framework-level changes separately from product feature work. Released under Apache 2.0.

StatusActive
RoleBuilder / Architect
Stack
Prompt ArchitectureArchitecture Decision Records (ADRs)JSON Policy DocumentsGit-backed Event LogAgentic Workflow Design
// project · governance · execution framework

Agentic Governance & Execution Framework

policy governs · gates decide · workers execute within bounds
Markdown-native task contracts & module specs
Python reference implementation · conformance tests
CLI v1.0.0 · init · validate · test-routing · upgrade · reset
runtime-agnostic at the agent layer
NOT A CHATBOT LOOPGovernance-gated pipeline.Discrete entry · audit output.RUNTIME-AGNOSTICClaude Code · Cowork · CopilotChatGPT · manual pasteUser Requestraw input · domain override · contextDomain Classifierfires EXACTLY ONCE · deterministicRouterselects single task flowTask ContractMARKDOWN · execution rules · acceptance criteriaPlanPLAN-FIRST · structured approach · scope boundingGate DecisionsPlanReview · ScopeDeviation · UnclearBehaviorExecution WorkerBOUNDED WORK ITEM · per-item loopVerificationCOMPLETION CHECKS · before loop exitSEPSchema Evolution ProtocolADR Loggate outcomes preservedConformance Testsvalidates lifecycle behaviorPython Reference Impl.canonical runtimeCLI Bootstrap · v1.0.0init · validate · test-routing · upgrade · reset01 · USER INTENT02 · CLASSIFICATION03 · PLANNING04 · GATE05 · EXECUTION06 · GOVERNANCE EVOLUTION07 · PERSISTENCE & AUDIT08 · DISTRIBUTION
Primary execution path
Governance · gate · SEP
Gate revise / escalate
Validation & distribution
Optional reclassify
click any node for details · esc to close
Interactive architecture diagram — click nodes for details