How buildsomethingai/aegis-framework works
Aegis is a documentation- and configuration-driven framework for collaborative AI-assisted project management. The documented workflow is for people and AI to plan work, manage tasks, preserve project context, and track and validate state. The tree exposes command catalogs, operation definitions, memory files, and task-state directories, but no source excerpts show runtime call paths; relationships below therefore reflect documented capabilities and named responsibilities, not inferred implementation wiring.
Main entry points: tasks Task management · plan AI planning · session Session state · COMMANDS.md Command catalog
Components 16
Commands and guidance
- Command catalog
COMMANDS.md - Command definitions
COMMANDS.json - Operation guides
.context/ai/operations - Framework guidance
.context/AI_INSTRUCTIONS.md
Planning and tasks
- AI planning
.context/plan - Task management
.context/tasks - Task state directories
.context/tasks/active
Memory and state
- Core memory
.context/memory/core - Project context
.context/memory/project/context - Session state
.context/memory/session - State tracking guidance
.context/memory/STATE_TRACKING.md
Validation and templates
- Validation rules
.context/ai/operations/validation.yaml - Work templates
.context/templates - Task guidance
.context/tasks/README.md
Other components
- Human collaborator
- AI collaborator
Connections 12
- Human collaborator → Command catalog: uses commands
- AI collaborator → AI planning: assists planning
- AI planning → Task management: breaks down work
- Human collaborator → Task management: manages tasks
- Task management → Task state directories: tracks progress
- AI collaborator → Core memory: maintains context
- Human collaborator → Project context: shares context
- Session state → State tracking guidance: records state
- Task management → Validation rules: checks consistency
- Task management → Work templates: uses templates
- AI collaborator → Operation guides: follows procedures
- Human collaborator → Framework guidance: consults guidance