How dammar01/agent-workflow works
agent-workflow is a Python control plane around a primary coding agent. The primary agent submits a task to the runtime, which routes and governs it, manages session/job state, builds a bounded prompt, and dispatches to a secondary provider. The runtime checks and shapes the returned evidence, persists artifacts, and returns a digest and evidence reference for the primary agent to assess. It also supports local workspace operations, browser-based verification, and promotion of verified knowledge. The README documents these capabilities; some internal wiring is inferred only where the sampled source supports it.
Main entry points: main.py Command entry · executor.py Delegation executor · runner.py Browser verification · providers Provider adapters
Components 22
Runtime orchestration
- Command entry
main.py - Command routing
core/prompt/router.py - Job lifecycle
core/jobs/job_manager.py - Session manager
core/workspace/session_manager.py
Provider delegation
- Delegation executor
core/provider/executor.py - Prompt builder
core/prompt/prompt_builder.py - Adapter registry
adapters/contract/registry.py - Provider adapters
adapters/providers
Evidence processing
- Evidence contracts
core/evidence/contract.py - Result shaping
core/evidence/result_shaping.py - Evidence artifacts
core/evidence/evidence_store.py - Browser verification
core/evidence/e2e/runner.py - Browser player
core/evidence/e2e/browser.py
Workspace and policy
- Workspace runtime
core/workspace/workspace_paths.py - Provider governance
core/policy/governance.py - Audit and diagnostics
core/audit
Knowledge lifecycle
- Knowledge retrieval
core/knowledge/retrieve.py - Knowledge store
core/knowledge/store.py - Knowledge verification
core/knowledge/verify.py - Claim reconciliation
core/knowledge/reconcile.py
Other components
- Primary agent
- Secondary agent
Connections 25
- Primary agent → Command entry: submits command
- Command entry → Job lifecycle: manages jobs
- Command entry → Session manager: loads session
- Command entry → Delegation executor: executes task
- Delegation executor → Command routing: routes command
- Command routing → Provider governance: checks provider
- Delegation executor → Prompt builder: builds prompt
- Delegation executor → Adapter registry: resolves adapter
- Adapter registry → Provider adapters: selects provider
- Provider adapters → Secondary agent: sends task
- Secondary agent → Provider adapters: returns response
- Delegation executor → Evidence contracts: validates result
- Delegation executor → Result shaping: shapes result
- Delegation executor → Evidence artifacts: reads and writes
- Result shaping → Primary agent: returns digest
- Command entry → Browser verification: dispatches verification
- Browser verification → Browser player: runs scenario
- Browser verification → Evidence contracts: checks evidence
- Delegation executor → Knowledge retrieval: retrieves context
- Knowledge retrieval → Knowledge store: reads documents
- Command entry → Knowledge store: loads promoted document
- Command entry → Knowledge verification: verifies promotion
- Command entry → Claim reconciliation: reconciles claims
- Command entry → Workspace runtime: manages workspace
- Command entry → Audit and diagnostics: reports diagnostics