How matbanik/agentic-framework works
This is a portable agentic-work governance framework: it guides adopters in configuring safety gates, then structures agent work through research, planning, independent review, implementation, validation, and human-gated completion. Its issue-to-MEU loop turns defects into tracked work; durable files, review limits, and structural gates support evidence and fail-closed behavior. The README documents broader workflow and model-routing capabilities; sampled source confirms selected triage, MEU, review-ledger, and validation behavior, not every connection shown.
Main entry points: workflows Delivery Workflows · AGENTS.md Operating Contract · ADOPTION-GUIDE.md Adoption Guide · ADOPTION-QUESTIONS.md Adoption Questions
Components 25
Adoption
- Adoption Questions
ADOPTION-QUESTIONS.md - Adoption Guide
ADOPTION-GUIDE.md - Domain Mapping
DOMAIN-MAPPING.md - Project Instantiation
scripts/instantiate.py
Work Delivery
- Delivery Workflows
core/.agent/workflows - Agent Roles
core/.agent/roles - Workflow Skills
core/.agent/skills - Work Templates
core/templates
Learning Loop
- Issue Triage CLI
core/tools/issue_triage.py - Issue Registry
core/.agent/context/known-issues.yaml - Issue-to-MEU Guidance
core/.agent/docs/triage-meu-loop.md - MEU Status CLI
core/tools/meu_status.py - MEU Registry
core/.agent/context/meu-status.yaml
Safety Controls
- Operating Contract
core/AGENTS.md - Safety Guardrails
core/GUARDRAILS.md - Bounded Review Ledger
core/tools/review_ledger.py - Closeout Gate
core/tools/validate_closeout_artifacts.py - Task Contract Gate
core/tools/lint_task_contract.py
Agent Configuration
- Harness Profiles
core/.agent/docs/harness-profiles.md - Model Routing
core/.agent/docs/model-routing.md - Model Registry Tools
.agent/tools/resolve_model.py
Other components
- Adopting User
- Working Agent
- Human Reviewer
- External Model Provider
Connections 25
- Adopting User → Adoption Questions: answers first
- Adoption Questions → Adoption Guide: configures adoption
- Adoption Guide → Domain Mapping: translates practice
- Adoption Guide → Project Instantiation: instructs setup
- Adopting User → Project Instantiation: runs setup
- Working Agent → Operating Contract: follows contract
- Operating Contract → Safety Guardrails: enforces constraints
- Operating Contract → Delivery Workflows: directs work
- Delivery Workflows → Agent Roles: assigns roles
- Delivery Workflows → Workflow Skills: uses practices
- Delivery Workflows → Work Templates: produces artifacts
- Working Agent → Issue Triage CLI: triages defects
- Issue Triage CLI → Issue Registry: reads and updates
- Issue-to-MEU Guidance → MEU Status CLI: guides registration
- MEU Status CLI → MEU Registry: reads and updates
- Delivery Workflows → Issue-to-MEU Guidance: feeds learning loop
- Working Agent → Bounded Review Ledger: records review rounds
- Bounded Review Ledger → Human Reviewer: requests continuation
- Working Agent → Closeout Gate: checks closeout
- Working Agent → Task Contract Gate: checks task contract
- Operating Contract → Harness Profiles: configures capabilities
- Operating Contract → Model Routing: describes delegation
- Model Routing → Model Registry Tools: resolves models
- Model Registry Tools → External Model Provider: supports provider selection
- Delivery Workflows → Human Reviewer: gates irreversible work