How bkferareza/adapt works
ADAPT is a file-based governance framework for AI-assisted software work, not an application-code runtime. The principal workflow is to scaffold a project-specific governance instance from canonical artifacts, then use bounded human-directed handoffs and evidence to guide work; optional read-only commands inspect state, diagnose consistency, preview the next prompt, or summarize Git evidence. The graph preserves the documented governance lanes and tool capabilities. Source excerpts show the operator and state reader implementations, but not their complete internal wiring, so undocumented calls are omitted.
Main entry points: SCAFFOLD_WORKFLOW_AGENT.md Scaffold workflow · operator.py Operator commands · 02_DIRECTOR_LANE Director control · 03_WORKCELLS Workcells
Components 20
Framework Source
- Canonical artifacts
ADAPT/CANONICAL_STARTERS - Scaffold workflow
ADAPT/SCAFFOLD_WORKFLOW_AGENT.md - Deployment modes
ADAPT/DEPLOYMENT_MODES.md
Instance Governance
- Governance instance
ADAPT/CANONICAL_STARTERS - Source truth
ADAPT/CANONICAL_STARTERS/01_SOURCE_TRUTH - Director control
ADAPT/CANONICAL_STARTERS/02_DIRECTOR_LANE - Workcells
ADAPT/CANONICAL_STARTERS/03_WORKCELLS - Integration lane
ADAPT/CANONICAL_STARTERS/04_INTEGRATION - Validation lane
ADAPT/CANONICAL_STARTERS/05_VALIDATION - Handoffs
ADAPT/CANONICAL_STARTERS/06_HANDOFFS - Guardrails
ADAPT/CANONICAL_STARTERS/07_GUARDRAILS - Supporting lanes
ADAPT/CANONICAL_STARTERS
Operator Tooling
- Tool entry point
ADAPT/TOOLS/adapt.py - Operator commands
ADAPT/TOOLS/supporting_modules/operator.py - State reader
ADAPT/TOOLS/supporting_modules/state_reader.py
Evidence and Review
- Git evidence
ADAPT/TOOLS/supporting_modules/operator.py
Other components
- AI agent
- Human operator
- Project repository
- Local Git metadata
Connections 17
- AI agent → Scaffold workflow: starts scaffold
README.md - Scaffold workflow → Canonical artifacts: uses artifacts
README.md - Scaffold workflow → Deployment modes: selects mode
README.md - Scaffold workflow → Governance instance: creates instance
README.md - Project repository → Scaffold workflow: supplies project
README.md - Human operator → Director control: approves work
README.md - Source truth → Director control: grounds decisions
README.md - Director control → Workcells: assigns bounded work
README.md - Workcells → Handoffs: records handoffs
README.md - Integration lane → Validation lane: defines contracts
README.md - Guardrails → Workcells: constrains scope
README.md - Human operator → Tool entry point: runs commands
README.md - Tool entry point → Operator commands: dispatches main
ADAPT/TOOLS/adapt.py - Operator commands → Governance instance: inspects instance
README.md - Operator commands → Git evidence: computes evidence
README.md - Git evidence → Local Git metadata: reads metadata
README.md - Human operator → Validation lane: reviews evidence
README.md