All notable changes to Synkra AIOX will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
-
🤖 AIOX Autonomous Development Engine (ADE): Complete autonomous development system with 7 Epics:
- Epic 1 - Worktree Manager: Git worktree isolation for parallel story development
- Epic 2 - Migration V2→V3: autoClaude V3 format with capability flags
- Epic 3 - Spec Pipeline: Transform requirements into executable specifications
- Epic 4 - Execution Engine: 13-step subtask execution with mandatory self-critique
- Epic 5 - Recovery System: Automatic failure recovery with attempt tracking and rollback
- Epic 6 - QA Evolution: 10-phase structured review process
- Epic 7 - Memory Layer: Persistent memory for patterns, insights, and gotchas
-
New Agent Commands:
@devops:*create-worktree,*list-worktrees,*merge-worktree,*cleanup-worktrees,*inventory-assets,*analyze-paths,*migrate-agent,*migrate-batch@pm:*gather-requirements,*write-spec@architect:*assess-complexity,*create-plan,*create-context,*map-codebase@analyst:*research-deps,*extract-patterns@qa:*critique-spec,*review-build,*request-fix,*verify-fix@dev:*execute-subtask,*track-attempt,*rollback,*capture-insights,*list-gotchas,*apply-qa-fix
-
New Scripts:
worktree-manager.js,story-worktree-hooks.js,project-status-loader.jsasset-inventory.js,path-analyzer.js,migrate-agent.jssubtask-verifier.js,plan-tracker.jsrecovery-tracker.js,approach-manager.js,rollback-manager.js,stuck-detector.jsqa-loop-orchestrator.js,qa-report-generator.jscodebase-mapper.js,pattern-extractor.js,gotchas-documenter.js
-
New Workflows:
auto-worktree.yaml- Automatic worktree creation for storiesspec-pipeline.yaml- 5-phase specification pipelineqa-loop.yaml- QA review and fix loop
-
New Tasks (15+ new tasks for ADE):
- Spec Pipeline:
spec-gather-requirements.md,spec-assess-complexity.md,spec-research-dependencies.md,spec-write-spec.md,spec-critique.md - Execution:
plan-create-implementation.md,plan-create-context.md,plan-execute-subtask.md - QA:
qa-review-build.md,qa-fix-issues.md,qa-structured-review.md - Memory:
capture-session-insights.md - Worktree:
worktree-create.md,worktree-list.md,worktree-merge.md
- Spec Pipeline:
-
JSON Schemas:
agent-v3-schema.json- V3 agent definition validationtask-v3-schema.json- V3 task definition validation
-
Templates:
spec-tmpl.md- Specification document templateqa-report-tmpl.yaml- QA report template
-
Checklists:
self-critique-checklist.md- Mandatory self-critique for developers
-
Documentation:
- ADE Complete Guide - Full tutorial
- Epic 1-7 Handoffs - Technical handoffs (ADE-EPIC-1 through ADE-EPIC-7)
- Agent Changes - All agent modifications with capability matrix
- Agent Format: All 12 agents migrated to autoClaude V3 format with capability flags
- Agent Sync: All agents now synced between
.aiox-core/development/agents/and.claude/commands/AIOX/agents/
- Agent command registration for all ADE Epics
- Schema validation for V3 format
- Interactive Installation Wizard: Step-by-step guided setup with component selection
- Multi-IDE Support: Added support for 4 IDEs (Claude Code, Cursor, Gemini CLI, GitHub Copilot)
- Squads System: Modular add-ons including HybridOps for ClickUp integration
- Cross-Platform Testing: Full test coverage for Windows, macOS, and Linux
- Error Handling & Rollback: Automatic rollback on installation failure with recovery suggestions
- Agent Improvements:
- Decision logging in yolo mode for
devagent - Backlog management commands for
qaagent - CodeRabbit integration for automated code review
- Contextual greetings with project status
- Decision logging in yolo mode for
- Documentation Suite:
- Troubleshooting Guide with 23 documented issues
- FAQ with 22 Q&As
- Migration Guide v2.0 to v4.0.4
- Directory Structure: Renamed
.legacy-core/to.aiox-core/ - Configuration Format: Enhanced
core-config.yamlwith new sections for git, projectStatus, and sharding options - Agent Format: Updated agent YAML schema with persona_profile, commands visibility, and whenToUse fields
- IDE Configuration: Claude Code agents moved to
.claude/commands/AIOX/agents/ - File Locations:
docs/architecture/coding-standards.md→docs/framework/coding-standards.mddocs/architecture/tech-stack.md→docs/framework/tech-stack.md.aiox-core/utils/→.aiox-core/scripts/
- Installation failures on Windows with long paths
- PowerShell execution policy blocking scripts
- npm permission issues on Linux/macOS
- IDE configuration not applying after installation
- Manual installation process (use
npx aiox-core installinstead) .legacy-core/directory name (automatically migrated)
- Added validation for installation directory to prevent system directory modifications
- Improved handling of environment variables and API keys
- Initial public release of Synkra AIOX
- 11 specialized AI agents (dev, qa, architect, pm, po, sm, analyst, ux-expert, data-engineer, devops, db-sage)
- Task workflow system with 60+ pre-built tasks
- Template system with 20+ document templates
- Story-driven development methodology
- Basic Claude Code integration
- Manual installation required (2-4 hours)
- Limited cross-platform support
- No interactive wizard
- Initial internal release
- Core agent framework
- Basic task execution
Quick upgrade:
npx aiox-core install --force-upgradeKey changes:
- Directory renamed:
.legacy-core/→.aiox-core/ - Update
core-config.yamlwith new fields - Re-run IDE configuration