How agenticubed/a3 works
AgentiCubed is a governed project-orchestration platform: users define projects, plans are decomposed and assigned, tasks execute and are evaluated, and gaps can trigger remediation and re-execution until acceptance. The backend exposes versioned APIs, with a Next.js interface and a durable Celery worker option. The README documents the domain loop; sampled source confirms selected API, audit, execution, and browser-extension behavior. Most feature routers and several services were not sampled, so their internal call relationships are not inferred.
Main entry points: execution_service.py Task execution · main.js Content detector · router.py Versioned API · app Project UI
Components 24
User experience
- Project UI
frontend/src/app - Versioned API
backend/app/api/v1/router.py
Planning and assignment
- Project intake
backend/app/services/project_service.py - Methodology
backend/app/services/methodology.py - Work decomposition
backend/app/services/decomposition_service.py - Capability analysis
backend/app/core/capabilities.py - Agent matching
backend/app/services/matching.py - Agent registry
backend/app/services/agent_service.py
Execution and evaluation
- Task execution
backend/app/services/execution_service.py - Execution lifecycle
backend/app/orchestration/state_machine/states.py - Provider adapters
backend/app/orchestration/adapters/registry.py - Workflow engine
backend/app/orchestration/engines.py - Celery worker
backend/app/workers/tasks.py - Output evaluation
backend/app/evaluation/specs.py - Remediation policy
backend/app/remediation/policy.py
Governance and reporting
- Human approval
backend/app/services/approval_service.py - Audit and events
backend/app/core/audit.py - Analytics
backend/app/analytics/compute.py - Project closeout
backend/app/services/closeout_service.py
Banner extension
- Content detector
bananers/src/content/main.js - Banner detection
bananers/src/core/detect.js - Dismissal planner
bananers/src/core/dismiss.js - Extension storage
bananers/src/shared/store.js
Other components
- Project user
Connections 25
- Project user → Project UI: uses
- Project UI → Versioned API: requests
- Versioned API → Project intake: handles intake
- Project intake → Methodology: recommends
README.md - Methodology → Work decomposition: plans work
README.md - Work decomposition → Capability analysis: identifies needs
README.md - Capability analysis → Agent matching: informs assignment
README.md - Agent matching → Agent registry: selects agents
README.md - Agent registry → Task execution: assigned work
README.md - Task execution → Output evaluation: evaluates outputs
README.md - Output evaluation → Remediation policy: identifies gaps
README.md - Remediation policy → Task execution: re-executes
README.md - Task execution → Execution lifecycle: uses states
backend/app/services/execution_service.py - Task execution → Provider adapters: selects adapter
backend/app/services/execution_service.py - Task execution → Workflow engine: dispatches work
backend/app/services/execution_service.py - Workflow engine → Celery worker: queues execution
backend/app/orchestration/engines.py - Celery worker → Task execution: runs task
backend/app/workers/tasks.py - Task execution → Human approval: requests approval
- Task execution → Audit and events: records changes
backend/app/services/execution_service.py - Audit and events → Extension storage: publishes events
- Versioned API → Analytics: serves reporting
- Human approval → Project closeout: supports acceptance
README.md - Content detector → Banner detection: finds banners
bananers/src/content/main.js - Content detector → Dismissal planner: plans dismissal
bananers/src/content/main.js - Content detector → Extension storage: stores learning
bananers/src/content/main.js