Version: 4.0.0 Last Updated: 2026-02-11 Status: Official Framework Standard Repository: SynkraAI/aiox-core
- Overview
- Modular Architecture
- Framework Core (.aiox-core/)
- Module Details
- Documentation (docs/)
- Squads System
- Autonomous Development Engine (ADE)
- File Naming Conventions
- Where to Put New Files
AIOX uses a modular architecture with clear separation of concerns:
- Framework Core (
.aiox-core/) - Portable framework components organized by domain - Project Workspace (root) - Project-specific implementation
Philosophy:
- Domain-driven organization - Components grouped by function
- Portability - Framework components work across projects
- Separation of concerns - Clear boundaries between modules
aiox-core/ # Root project
├── .aiox-core/ # Framework core (modular)
│ ├── cli/ # CLI commands and utilities
│ ├── core/ # Framework essentials
│ ├── data/ # Shared data files
│ ├── development/ # Development assets (agents, tasks, workflows)
│ ├── docs/ # Internal framework docs
│ ├── elicitation/ # Elicitation engines
│ ├── infrastructure/ # Infrastructure tools and scripts
│ ├── manifests/ # Installation manifests
│ ├── product/ # PM/PO assets (templates, checklists)
│ ├── quality/ # Quality gate schemas
│ ├── scripts/ # Utility scripts
│ └── core-config.yaml # Framework configuration
│
├── docs/ # Public documentation
│ ├── architecture/ # Architecture docs
│ ├── framework/ # Official framework standards
│ ├── guides/ # How-to guides
│ ├── installation/ # Installation guides
│ └── community/ # Community docs
│
├── templates/ # Project templates
│ └── squad/ # Squad template (see docs/guides/squads-guide.md)
│
├── bin/ # CLI executables
│ └── aiox.js # Main CLI entry point
│
├── tools/ # Build and utility tools
│ ├── cli.js # CLI builder
│ └── installer/ # Installation scripts
│
├── tests/ # Test suites
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── e2e/ # End-to-end tests
│
├── .claude/ # Claude Code configuration
│ ├── CLAUDE.md # Project instructions
│ ├── commands/ # Agent slash commands
│ └── rules/ # IDE rules
│
├── index.js # Main entry point
├── package.json # Package manifest
└── README.md # Project README
Purpose: Portable framework components organized by domain for clear separation of concerns.
.aiox-core/
├── cli/ # CLI System
│ ├── commands/ # CLI command implementations
│ │ ├── generate/ # Code generation commands
│ │ ├── manifest/ # Manifest management
│ │ ├── mcp/ # MCP tool commands
│ │ ├── metrics/ # Quality metrics
│ │ ├── migrate/ # Migration tools
│ │ ├── qa/ # QA commands
│ │ └── workers/ # Background workers
│ └── utils/ # CLI utilities
│
├── core/ # Framework Essentials
│ ├── config/ # Configuration system
│ ├── data/ # Core knowledge base
│ ├── docs/ # Core documentation
│ ├── elicitation/ # Interactive prompting engine
│ ├── manifest/ # Manifest processing
│ ├── mcp/ # MCP orchestration
│ ├── migration/ # Migration utilities
│ ├── quality-gates/ # Quality gate validators
│ ├── registry/ # Service registry
│ ├── session/ # Runtime state management
│ └── utils/ # Core utilities
│
├── data/ # Shared Data
│ ├── aiox-kb.md # AIOX knowledge base (@aiox-master, lazy-loaded)
│ ├── agent-config-requirements.yaml # Per-agent config loading rules (@architect, updated on agent changes)
│ ├── technical-preferences.md # User/team technical preferences (@architect, updated on preference changes)
│ └── workflow-patterns.yaml # Workflow detection patterns (@sm, updated on workflow changes)
│
├── development/ # Development Assets
│ ├── agents/ # Agent definitions (11 core agents)
│ │ ├── aiox-master.md # Master orchestrator
│ │ ├── dev.md # Developer agent
│ │ ├── qa.md # QA engineer agent
│ │ ├── architect.md # System architect agent
│ │ ├── po.md # Product Owner agent
│ │ ├── pm.md # Product Manager agent
│ │ ├── sm.md # Scrum Master agent
│ │ ├── analyst.md # Business Analyst agent
│ │ ├── ux-design-expert.md # UX Designer agent
│ │ ├── data-engineer.md # Data Engineer agent
│ │ └── devops.md # DevOps agent
│ ├── agent-teams/ # Agent team configurations
│ ├── tasks/ # Task workflows (60+ tasks)
│ ├── workflows/ # Multi-step workflows
│ └── scripts/ # Development scripts
│
├── docs/ # Internal Documentation
│ └── standards/ # Framework standards
│
├── elicitation/ # Elicitation Engines
│ ├── agent-elicitation.js # Agent creation elicitation
│ ├── task-elicitation.js # Task creation elicitation
│ └── workflow-elicitation.js # Workflow creation elicitation
│
├── infrastructure/ # Infrastructure
│ ├── integrations/ # External integrations
│ │ └── pm-adapters/ # PM tool adapters (ClickUp, GitHub, Jira)
│ ├── scripts/ # Infrastructure scripts
│ │ ├── documentation-integrity/ # Doc integrity system
│ │ └── llm-routing/ # LLM routing utilities
│ ├── templates/ # Infrastructure templates
│ │ ├── core-config/ # Config templates
│ │ ├── github-workflows/ # CI/CD templates
│ │ ├── gitignore/ # Gitignore templates
│ │ └── project-docs/ # Project documentation templates
│ ├── tests/ # Infrastructure tests
│ └── tools/ # Tool integrations
│ ├── cli/ # CLI tool wrappers
│ ├── local/ # Local tools
│ └── mcp/ # MCP server configs
│
├── manifests/ # Installation Manifests
│ └── schema/ # Manifest schemas
│
├── product/ # PM/PO Assets
│ ├── checklists/ # Validation checklists
│ │ ├── po-master-checklist.md # PO validation
│ │ ├── story-draft-checklist.md # Story draft validation
│ │ ├── architect-checklist.md # Architecture review
│ │ └── change-checklist.md # Change management
│ ├── data/ # PM-specific data files
│ │ ├── brainstorming-techniques.md # Brainstorming methods (@analyst, reference doc, rarely updated)
│ │ ├── elicitation-methods.md # Elicitation techniques (@po, reference doc, rarely updated)
│ │ ├── mode-selection-best-practices.md # Mode selection guide (@sm, updated on workflow changes)
│ │ ├── test-levels-framework.md # Test level definitions (@qa, updated when test strategy changes)
│ │ └── test-priorities-matrix.md # Test priority rules (@qa, updated when priorities shift)
│ └── templates/ # Document templates
│ ├── engine/ # Template engine
│ ├── ide-rules/ # IDE rule templates
│ ├── story-tmpl.yaml # Story template
│ ├── prd-tmpl.yaml # PRD template
│ └── epic-tmpl.md # Epic template
│
├── quality/ # Quality System
│ └── schemas/ # Quality gate schemas
│
├── scripts/ # Root Scripts
│ └── ... # Utility scripts
│
├── core-config.yaml # Framework configuration
├── install-manifest.yaml # Installation manifest
├── user-guide.md # User guide
└── working-in-the-brownfield.md # Brownfield guide
Agents:
Location: .aiox-core/development/agents/
Format: Markdown with YAML frontmatter
Naming: {agent-name}.md (kebab-case)
Example: dev.md, qa.md, architect.md
Tasks:
Location: .aiox-core/development/tasks/
Format: Markdown workflow
Naming: {task-name}.md (kebab-case)
Example: create-next-story.md, develop-story.md
Templates:
Location: .aiox-core/product/templates/
Format: YAML or Markdown
Naming: {template-name}-tmpl.{yaml|md}
Example: story-tmpl.yaml, prd-tmpl.md
Workflows:
Location: .aiox-core/development/workflows/
Format: YAML
Naming: {workflow-type}-{scope}.yaml
Example: greenfield-fullstack.yaml, brownfield-service.yaml
Checklists:
Location: .aiox-core/product/checklists/
Format: Markdown
Naming: {checklist-name}-checklist.md
Example: story-draft-checklist.md, architect-checklist.md
Core Utilities:
Location: .aiox-core/core/utils/
Format: JavaScript (CommonJS)
Naming: {utility-name}.js (kebab-case)
Example: component-generator.js, story-manager.js
CLI Commands:
Location: .aiox-core/cli/commands/{category}/
Format: JavaScript (CommonJS)
Naming: {command-name}.js (kebab-case)
Example: generate/agent.js, manifest/install.js
Infrastructure Scripts:
Location: .aiox-core/infrastructure/scripts/{category}/
Format: JavaScript
Naming: {script-name}.js (kebab-case)
Example: documentation-integrity/link-verifier.jsAll data files used by agents during activation must have documented ownership, fill rules, and update triggers.
| File | Owner | Fill Rule | Update Trigger | Used By |
|---|---|---|---|---|
coding-standards.md |
@dev | Updated when coding standards change | *update-standards task or manual edit |
@dev, @pm, @ux-design-expert, @sm |
tech-stack.md |
@architect | Updated on tech stack decisions | *create-doc architecture or manual edit |
@dev, @pm, @ux-design-expert, @analyst |
source-tree.md |
@architect | Updated when structure changes | *update-source-tree task |
@dev, @analyst |
| File | Owner | Fill Rule | Update Trigger | Used By |
|---|---|---|---|---|
aiox-kb.md |
@aiox-master | Updated on major framework changes | Manual edit | @aiox-master (lazy) |
agent-config-requirements.yaml |
@architect | Updated when agent config needs change | Story-driven | AgentConfigLoader |
technical-preferences.md |
@architect | Updated on preference changes | Manual edit or *add-tech-doc |
@dev, @qa, @devops, @architect, @data-engineer |
workflow-patterns.yaml |
@sm | Updated on workflow changes | Manual edit | @sm, WorkflowNavigator |
| File | Owner | Fill Rule | Update Trigger | Used By |
|---|---|---|---|---|
brainstorming-techniques.md |
@analyst | Reference doc, rarely updated | Manual edit | @analyst |
elicitation-methods.md |
@po | Reference doc, rarely updated | Manual edit | @po |
mode-selection-best-practices.md |
@sm | Updated on workflow changes | Manual edit | @sm |
test-levels-framework.md |
@qa | Updated when test strategy changes | *update-test-strategy or manual edit |
@qa |
test-priorities-matrix.md |
@qa | Updated when priorities shift | *update-test-strategy or manual edit |
@qa |
docs/
├── architecture/ # ⚠️ Mixed: official + project-specific
│ ├── coding-standards.md # ✅ Official (migrates to REPO 1)
│ ├── tech-stack.md # ✅ Official (migrates to REPO 1)
│ ├── source-tree.md # ✅ Official (migrates to REPO 1)
│ ├── decision-analysis-*.md # Project-specific decisions
│ ├── architectural-review-*.md # Project-specific reviews
│ └── mcp-*.md # Framework docs (migrates to REPO 1)
│
├── framework/ # ⭐ NEW: Official framework docs (Q2 2026)
│ ├── coding-standards.md # Framework coding standards
│ ├── tech-stack.md # Framework tech stack
│ ├── source-tree.md # Framework source tree
│ └── README.md # Migration notice
│
├── stories/ # Development stories
│ ├── aiox migration/ # AIOX migration stories
│ │ ├── story-6.1.2.1.md
│ │ ├── story-6.1.2.2.md
│ │ ├── story-6.1.2.3.md
│ │ ├── story-6.1.2.4.md
│ │ └── story-6.1.2.5.md
│ └── ... # Other stories
│
├── epics/ # Epic planning
│ ├── epic-6.1-agent-identity-system.md
│ └── ... # Other epics
│
├── decisions/ # Architecture Decision Records
│ ├── decision-005-repository-restructuring-FINAL.md
│ └── ... # Other ADRs
│
├── guides/ # How-to guides
│ ├── git-workflow-guide.md
│ ├── migration-guide.md
│ └── ... # Other guides
│
├── qa/ # QA artifacts
│ └── backlog-archive/ # Archived QA items
│
├── prd/ # Product Requirements Documents
│ └── ... # PRD files
│
├── planning/ # Planning documents
│ └── ... # Sprint plans, roadmaps
│
├── standards/ # Framework standards
│ └── AGENT-PERSONALIZATION-STANDARD-V1.md
│
└── STORY-BACKLOG.md # ⭐ Story backlog index
docs/
├── framework/ # ✅ Official framework docs
│ ├── coding-standards.md
│ ├── tech-stack.md
│ ├── source-tree.md
│ ├── agent-spec.md
│ ├── task-spec.md
│ └── workflow-spec.md
│
├── architecture/ # Project-specific architecture
│ ├── project-decisions/ # ✅ ADRs for this project
│ │ ├── decision-005-repository-restructuring-FINAL.md
│ │ ├── architectural-review-contextual-agent-load.md
│ │ └── ...
│ └── diagrams/ # Architecture diagrams
│
├── stories/ # Development stories
│ ├── index.md # ⭐ Story index (auto-generated)
│ ├── backlog.md # ⭐ Story backlog (official)
│ └── ... # Story files
│
├── epics/
├── guides/
├── qa/
├── prd/
└── standards/
Note: Squads replaced the legacy "Squads" system in OSR-8. See Squads Guide for complete documentation.
Squads are modular extensions that add specialized capabilities to AIOX. Unlike the deprecated Squads, Squads follow a standardized template structure.
templates/squad/ # Squad template for creating extensions
├── squad.yaml # Squad manifest template
├── package.json # NPM package template
├── README.md # Documentation template
├── LICENSE # License template
├── .gitignore # Git ignore template
├── agents/ # Squad-specific agents
│ └── example-agent.yaml
├── tasks/ # Squad-specific tasks
│ └── example-task.yaml
├── workflows/ # Squad-specific workflows
│ └── example-workflow.yaml
├── templates/ # Squad-specific templates
│ └── example-template.md
└── tests/ # Squad tests
└── example-agent.test.js
# Future CLI (planned):
npx create-aiox-squad my-squad-name
# Current method:
cp -r templates/squad/ squads/my-squad-name/
# Then customize squad.yaml and components# squad.yaml
name: my-custom-squad
version: 1.0.0
description: Description of what this squad does
author: Your Name
license: MIT
# Components provided by this squad
agents:
- custom-agent-1
- custom-agent-2
tasks:
- custom-task-1
workflows:
- custom-workflow-1
# Dependencies
dependencies:
aiox-core: '>=2.1.0'| Legacy (Deprecated) | Current (Squads) |
|---|---|
Squads/ directory |
templates/squad/ template |
legacyPacksLocation config |
squadsTemplateLocation config |
pack.yaml manifest |
squad.yaml manifest |
| Direct loading | Template-based creation |
Decision 005 defines 5 separate repositories:
aiox-core/
├── .aiox-core/ # Framework assets (modular v2.0)
│ ├── cli/ # CLI commands and utilities
│ ├── core/ # Framework essentials
│ │ ├── config/ # Configuration system
│ │ ├── quality-gates/ # Quality validators
│ │ └── utils/ # Core utilities
│ ├── development/ # Development assets
│ │ ├── agents/ # Agent definitions (11 core)
│ │ ├── tasks/ # Task workflows (60+)
│ │ └── workflows/ # Multi-step workflows
│ ├── infrastructure/ # Infrastructure tools
│ │ ├── integrations/ # PM adapters, tools
│ │ ├── scripts/ # Automation scripts
│ │ └── templates/ # Infrastructure templates
│ ├── product/ # PM/PO assets
│ │ ├── checklists/ # Validation checklists
│ │ └── templates/ # Document templates
│ └── ...
│
├── bin/ # CLI entry points
│ └── aiox.js # Main CLI
│
├── tools/ # Build and utility tools
│ ├── cli.js # CLI builder
│ └── installer/ # Installation scripts
│
├── docs/ # Framework documentation
│ ├── framework/ # Official standards
│ ├── guides/ # How-to guides
│ ├── installation/ # Setup guides
│ └── architecture/ # Architecture docs
│
├── templates/ # Project templates
│ └── squad/ # Squad template
│
├── tests/ # Test suites
│ ├── unit/
│ ├── integration/
│ └── e2e/
│
└── examples/ # Example projects
├── basic-agent/
├── vibecoder-demo/
└── multi-agent-workflow/
squads/
├── verified/ # AIOX-curated squads
│ ├── github-devops/
│ ├── db-sage/
│ └── coderabbit-workflow/
│
├── community/ # Community submissions
│ ├── marketing-agency/
│ ├── sales-automation/
│ └── ...
│
├── templates/ # Squad templates
│ ├── minimal-squad/
│ └── agent-squad/
│
└── tools/ # Squad development tools
└── create-aiox-squad/
mcp-ecosystem/
├── presets/ # MCP presets (Docker MCP Toolkit)
│ ├── aiox-dev/
│ ├── aiox-research/
│ └── aiox-docker/
│
├── mcps/ # Base MCP configs
│ ├── exa/
│ ├── context7/
│ └── desktop-commander/
│
└── ide-configs/ # IDE integrations
├── claude-code/
├── gemini-cli/
└── cursor/
certified-partners/
├── premium-packs/ # Premium Squads
│ ├── enterprise-deployment/
│ └── advanced-devops/
│
├── partner-portal/ # Partner Success Platform
│ ├── dashboard/
│ └── analytics/
│
└── marketplace/ # Marketplace platform
├── api/
└── web/
mmos/
├── minds/ # 34 cognitive clones
│ ├── pedro-valerio/
│ ├── paul-graham/
│ └── ...
│
├── emulator/ # MMOS emulation engine
│ ├── mirror-agent/
│ └── dna-mental/
│
└── research/ # Research artifacts
└── transcripts/
Directories: kebab-case (lowercase, hyphen-separated)
✅ .aiox-core/
✅ Squads/
❌ .AIOX-Core/
❌ legacy-packs/
Files (Code): kebab-case with extension
✅ agent-executor.js
✅ task-runner.js
❌ AgentExecutor.js
❌ taskRunner.js
Files (Docs): kebab-case with .md extension
✅ coding-standards.md
✅ story-6.1.2.5.md
❌ CodingStandards.md
❌ Story_6_1_2_5.md
Files (Config): lowercase or kebab-case
✅ package.json
✅ tsconfig.json
✅ core-config.yaml
❌ PackageConfig.jsonStories:
Format: story-{epic}.{story}.{substory}.md
Example: story-6.1.2.5.md
Epics:
Format: epic-{number}-{name}.md
Example: epic-6.1-agent-identity-system.md
Decisions:
Format: decision-{number}-{name}.md
Example: decision-005-repository-restructuring-FINAL.md
Templates:
Format: {name}-tmpl.{yaml|md}
Example: story-tmpl.yaml, prd-tmpl.md
Checklists:
Format: {name}-checklist.md
Example: architect-checklist.md# I'm creating a new agent:
Location: .aiox-core/development/agents/{agent-name}.md
Example: .aiox-core/development/agents/security-expert.md
# I'm creating a new task:
Location: .aiox-core/development/tasks/{task-name}.md
Example: .aiox-core/development/tasks/deploy-to-production.md
# I'm creating a new workflow:
Location: .aiox-core/development/workflows/{workflow-name}.yaml
Example: .aiox-core/development/workflows/continuous-deployment.yaml
# I'm creating a new template:
Location: .aiox-core/product/templates/{template-name}-tmpl.{yaml|md}
Example: .aiox-core/product/templates/deployment-plan-tmpl.yaml
# I'm creating a new checklist:
Location: .aiox-core/product/checklists/{checklist-name}-checklist.md
Example: .aiox-core/product/checklists/security-review-checklist.md
# I'm creating a CLI command:
Location: .aiox-core/cli/commands/{category}/{command-name}.js
Example: .aiox-core/cli/commands/generate/workflow.js
# I'm creating a core utility:
Location: .aiox-core/core/utils/{utility-name}.js
Example: .aiox-core/core/utils/performance-monitor.js
# I'm creating an infrastructure script:
Location: .aiox-core/infrastructure/scripts/{category}/{script-name}.js
Example: .aiox-core/infrastructure/scripts/llm-routing/router.js
# I'm adding a PM tool adapter:
Location: .aiox-core/infrastructure/integrations/pm-adapters/{adapter-name}.js
Example: .aiox-core/infrastructure/integrations/pm-adapters/monday-adapter.js
# I'm writing a story (internal dev docs - gitignored):
Location: docs/stories/{sprint-context}/{story-file}.md
Example: docs/stories/v4.0.4/sprint-6/story-6.14-new-feature.md
# I'm creating official framework documentation:
Location: docs/framework/{doc-name}.md
Example: docs/framework/agent-development-guide.md
# I'm creating a test:
Location: tests/{type}/{test-name}.test.js
Example: tests/unit/agent-executor.test.js
# I'm creating a squad:
Location: Copy templates/squad/ to your squads directory
Example: squads/devops-automation/ (customize from template).ai/ # AI session artifacts
├── decision-log-6.1.2.5.md # Yolo mode decision log
├── decision-log-6.1.2.6.md # Another decision log
└── session-{date}-{agent}.md # Session transcripts (optional)
Purpose: Track AI-driven decisions during development sessions (especially yolo mode)
Auto-generated: Yes (when yolo mode enabled)
outputs/ # Runtime outputs (gitignored)
├── minds/ # MMOS cognitive clones
│ └── pedro_valerio/
│ ├── system-prompt.md
│ ├── kb/
│ └── artifacts/
│
└── architecture-map/ # Architecture analysis
├── MASTER-RELATIONSHIP-MAP.json
└── schemas/
Purpose: Runtime artifacts not committed to git
NEW in v3.0 - The ADE provides autonomous development capabilities through intelligent workflows, pattern learning, and self-healing loops.
.aiox-core/
├── workflow-intelligence/ # WIS - Pattern Learning System
│ ├── __tests__/ # WIS test suite
│ ├── engine/ # Core WIS engines
│ │ ├── confidence-scorer.js # Pattern confidence scoring
│ │ ├── output-formatter.js # Output formatting
│ │ ├── suggestion-engine.js # Intelligent suggestions
│ │ └── wave-analyzer.js # Wave pattern analysis
│ ├── learning/ # Machine learning components
│ │ ├── capture-hook.js # Pattern capture hooks
│ │ ├── index.js # Learning module entry
│ │ ├── pattern-capture.js # Pattern capture engine
│ │ ├── pattern-store.js # Pattern persistence
│ │ └── pattern-validator.js # Pattern validation
│ ├── registry/ # Workflow registry
│ │ └── workflow-registry.js # Workflow registration
│ └── index.js # WIS entry point
│
├── infrastructure/scripts/ # ADE Infrastructure Scripts
│ ├── worktree-manager.js # Git worktree isolation (Epic 1)
│ ├── project-status-loader.js # Project status management (Epic 2)
│ ├── spec-pipeline-runner.js # Spec pipeline automation (Epic 3)
│ ├── plan-tracker.js # Plan progress tracking (Epic 4)
│ ├── subtask-verifier.js # Subtask verification (Epic 4)
│ ├── approach-manager.js # Approach management (Epic 5)
│ ├── stuck-detector.js # Stuck detection logic (Epic 5)
│ ├── recovery-tracker.js # Recovery tracking (Epic 5)
│ ├── rollback-manager.js # Rollback management (Epic 5)
│ ├── qa-report-generator.js # QA report generation (Epic 6)
│ ├── qa-loop-orchestrator.js # QA loop automation (Epic 6)
│ ├── codebase-mapper.js # Codebase mapping (Epic 7)
│ ├── pattern-extractor.js # Pattern extraction (Epic 7)
│ └── gotchas-documenter.js # Gotchas documentation (Epic 7)
│
├── development/workflows/ # ADE Workflows
│ ├── spec-pipeline.yaml # Requirements → Spec workflow (Epic 3)
│ └── qa-loop.yaml # QA review → fix loop (Epic 6)
│
├── development/tasks/ # ADE Tasks
│ ├── spec-assess-complexity.md # Complexity assessment (Epic 3)
│ ├── spec-critique.md # Specification critique (Epic 3)
│ ├── spec-gather-requirements.md # Requirements gathering (Epic 3)
│ ├── spec-research-dependencies.md # Dependency research (Epic 3)
│ ├── spec-write-spec.md # Specification writing (Epic 3)
│ ├── plan-create-context.md # Context generation (Epic 4)
│ ├── plan-create-implementation.md # Implementation planning (Epic 4)
│ ├── plan-execute-subtask.md # Subtask execution (Epic 4)
│ ├── verify-subtask.md # Subtask verification (Epic 4)
│ ├── qa-review-build.md # 10-phase QA review (Epic 6)
│ ├── qa-create-fix-request.md # Fix request generation (Epic 6)
│ ├── qa-fix-issues.md # Issue fixing workflow (Epic 6)
│ ├── capture-session-insights.md # Session insights capture (Epic 7)
│ ├── extract-patterns.md # Pattern extraction (Epic 7)
│ └── document-gotchas.md # Gotchas documentation (Epic 7)
│
└── product/ # ADE Templates & Checklists
├── templates/
│ ├── qa-report-tmpl.md # QA report template (Epic 6)
│ └── current-approach-tmpl.md # Current approach template (Epic 5)
└── checklists/
└── self-critique-checklist.md # Self-critique checklist (Epic 4)
| Epic | Name | Key Components |
|---|---|---|
| Epic 1 | Story Branch Isolation | worktree-manager.js - Git worktree management |
| Epic 2 | Project Status System | project-status-loader.js - YAML status tracking |
| Epic 3 | Spec Pipeline | spec-pipeline.yaml + 5 spec tasks |
| Epic 4 | Implementation Planning | plan-tracker.js, subtask-verifier.js, context generators |
| Epic 5 | Self-Healing Loops | stuck-detector.js, recovery-tracker.js, rollback-manager.js |
| Epic 6 | QA Evolution | qa-loop-orchestrator.js, 10-phase review, fix request generation |
| Epic 7 | Memory Layer | codebase-mapper.js, pattern-extractor.js, session insights |
The ADE is configured via .aiox-core/core-config.yaml:
ade:
enabled: true
worktrees:
enabled: true
baseDir: .worktrees
specPipeline:
enabled: true
maxIterations: 3
qaLoop:
enabled: true
maxIterations: 5
memoryLayer:
enabled: true
patternStore: .aiox/patterns/Runtime state is persisted in .aiox/:
.aiox/
├── project-status.yaml # Current project status
├── status.json # Runtime status
├── patterns/ # Learned patterns (Epic 7)
│ ├── code-patterns.json
│ └── gotchas.json
├── worktrees/ # Worktree state (Epic 1)
│ └── story-{id}.json
└── qa-loops/ # QA loop state (Epic 6)
└── {story-id}/
├── iteration-1.json
└── qa-report.md
- Coding Standards
- Tech Stack
- ADE Architecture (planned)
| Version | Date | Changes | Author |
|---|---|---|---|
| 1.0 | 2025-01-15 | Initial source tree documentation | Aria (architect) |
| 1.1 | 2025-12-14 | Updated org to SynkraAI, replaced Squads with Squads system [Story 6.10] | Dex (dev) |
| 2.0 | 2025-12-15 | Major update to reflect modular architecture (cli/, core/, development/, infrastructure/, product/) [Story 6.13] | Pax (PO) |
| 3.0 | 2026-01-29 | Added ADE (Autonomous Development Engine) section documenting Epics 1-7: workflow-intelligence, ADE scripts, workflows, tasks, and runtime state [ADE Integration] | Aria (architect) |
| 3.1 | 2026-02-06 | Added Data File Governance section: documented 7 missing data files with owner, fill rule, and update trigger. Expanded .aiox-core/data/ and product/data/ tree listings. [Story ACT-8] | Dex (dev) |
This is an official AIOX framework standard. All file placement must follow this structure.