{"id":45688899,"url":"https://github.com/SynkraAI/aiox-core","last_synced_at":"2026-03-09T22:01:28.895Z","repository":{"id":328064783,"uuid":"1113140733","full_name":"SynkraAI/aiox-core","owner":"SynkraAI","description":"Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0","archived":false,"fork":false,"pushed_at":"2026-03-04T18:42:06.000Z","size":32811,"stargazers_count":2072,"open_issues_count":84,"forks_count":693,"subscribers_count":55,"default_branch":"main","last_synced_at":"2026-03-04T23:30:20.713Z","etag":null,"topics":["agents","ai","ai-agents","automation","claude","cli","development","framework","fullstack","nodejs","orchestration","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/allfluence/aios-core","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SynkraAI.png","metadata":{"files":{"readme":"README.en.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yaml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"docs/security-best-practices.md","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":["https://f5.ventures/aioxfullstack"]}},"created_at":"2025-12-09T15:19:10.000Z","updated_at":"2026-03-04T23:22:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SynkraAI/aiox-core","commit_stats":null,"previous_names":["synkraai/aios-core"],"tags_count":37,"template":false,"template_full_name":null,"purl":"pkg:github/SynkraAI/aiox-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynkraAI%2Faiox-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynkraAI%2Faiox-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynkraAI%2Faiox-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynkraAI%2Faiox-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SynkraAI","download_url":"https://codeload.github.com/SynkraAI/aiox-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynkraAI%2Faiox-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30178284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T12:39:21.703Z","status":"ssl_error","status_checked_at":"2026-03-06T12:36:09.819Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","ai-agents","automation","claude","cli","development","framework","fullstack","nodejs","orchestration","typescript"],"created_at":"2026-02-24T16:00:28.387Z","updated_at":"2026-03-09T22:01:28.888Z","avatar_url":"https://github.com/SynkraAI.png","language":"JavaScript","readme":"# Synkra AIOX: Universal AI Agent Framework πŸš€\n\n\u003e 🌍 **[English](README.en.md)** | [PortuguΓͺs](README.md)\n\n[![NPM Version](https://img.shields.io/npm/v/aiox-core.svg)](https://www.npmjs.com/package/aiox-core)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)\n[![CI](https://github.com/SynkraAI/aiox-core/actions/workflows/ci.yml/badge.svg)](https://github.com/SynkraAI/aiox-core/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/SynkraAI/aiox-core/branch/main/graph/badge.svg)](https://codecov.io/gh/SynkraAI/aiox-core)\n[![Documentation](https://img.shields.io/badge/docs-available-orange.svg)](https://synkra.ai)\n[![Open Source](https://img.shields.io/badge/Open%20Source-Yes-success.svg)](LICENSE)\n[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Code of Conduct](https://img.shields.io/badge/code%20of%20conduct-Contributor%20Covenant-blue.svg)](CODE_OF_CONDUCT.md)\n\nAI-Powered Self-Modifying Development Framework. Founded on Agent-Driven Agile Development, offering revolutionary capabilities for AI-driven development and much more. Transform any domain with specialized AI expertise: software development, entertainment, creative writing, business strategy, personal wellness, and more.\n\n## Start Here (10 Min)\n\nIf this is your first time with AIOX, follow this linear path:\n\n1. Install in a new or existing project:\n```bash\n# new project\nnpx aiox-core init my-project\n\n# existing project\ncd your-project\nnpx aiox-core install\n```\n2. Choose your IDE/CLI and the activation path:\n- Claude Code: `/agent-name`\n- Gemini CLI: `/aiox-menu` β†’ `/aiox-\u003cagent\u003e`\n- Codex CLI: `/skills` β†’ `aiox-\u003cagent-id\u003e`\n- Cursor/Copilot/AntiGravity: follow the limits and workarounds in `docs/ide-integration.md`\n3. Activate 1 agent and confirm the greeting.\n4. Run 1 initial command (`*help` or equivalent) to validate first-value.\n\nFirst-value definition (binary): agent activation + valid greeting + initial command with useful output in \u003c= 10 minutes.\n\n\n## IDE Hook Compatibility (AIOX 4.2 Reality)\n\nMany advanced AIOX features depend on lifecycle events (hooks). The table below shows the actual parity between IDEs/platforms:\n\n| IDE/CLI | Hook Parity vs Claude | Practical Impact |\n| --- | --- | --- |\n| Claude Code | Complete (reference) | Maximum context automation, guardrails, and auditing |\n| Gemini CLI | High (native events) | Strong coverage of pre/post tool and session automations |\n| Codex CLI | Partial/limited | Some automations depend on `AGENTS.md`, `/skills`, MCP, and operational flow |\n| Cursor | No equivalent lifecycle hooks | Less pre/post tool automation; focus on rules, MCP, and agent flow |\n| GitHub Copilot | No equivalent lifecycle hooks | Less session/tooling automation; focus on repository instructions + MCP in VS Code |\n| AntiGravity | Workflow-based (not hook-based) | Integration via workflows, not via hook events equivalent to Claude |\n\nDetailed impacts and mitigation: `docs/ide-integration.md`.\n\n## Acknowledgments \u0026 Attribution\n\nSynkra AIOX was originally derived from the [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD), created by [Brian Madison](https://github.com/bmadcode) (BMad Code, LLC). We gratefully acknowledge the BMad Method for providing the foundation from which this project began.\n\n**Important:** This project is **NOT affiliated with, endorsed by, or sanctioned by** the BMad Method or BMad Code, LLC. Contributors appearing in the git history from the original BMad Method repository do not imply active participation in or endorsement of Synkra AIOX.\n\nSince its origin, AIOX has evolved significantly with its own architecture, terminology, and features (v4.x+), and does not depend on BMad for current operation. The BMad Method remains an excellent framework in its own right β€” please visit the [official BMad Method repository](https://github.com/bmad-code-org/BMAD-METHOD) to learn more.\n\nBMad, BMad Method, and BMad Core are trademarks of BMad Code, LLC. See [TRADEMARK.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/TRADEMARK.md) for usage guidelines.\n\n## Overview\n\n### Architectural Premise: CLI First\n\nSynkra AIOX follows a clear priority hierarchy:\n\n```text\nCLI First β†’ Observability Second β†’ UI Third\n```\n\n| Layer | Priority | Focus | Examples |\n| ----------------- | --------- | ------------------------------------------------------------------------------ | -------------------------------------------- |\n| **CLI** | Highest | Where the intelligence lives. All execution, decisions, and automation happen here. | Agents (`@dev`, `@qa`), workflows, commands |\n| **Observability** | Secondary | Observe and monitor what happens in the CLI in real time. | SSE Dashboard, logs, metrics, timeline |\n| **UI** | Tertiary | Ad-hoc management and visualizations when needed. | Kanban, settings, story management |\n\n**Derived principles:**\n\n- The CLI is the source of truth - dashboards only observe\n- New features must work 100% via CLI before having a UI\n- The UI should never be a requirement for system operation\n- Observability serves to understand what the CLI is doing, not to control it\n\n---\n\n**The Two Key Innovations of Synkra AIOX:**\n\n**1. Agentic Planning:** Dedicated agents (analyst, pm, architect) collaborate with you to create detailed, consistent PRD and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation.\n\n**2. Engineering-Contextualized Development:** The sm (Scrum Master) agent then transforms these detailed plans into hyper-detailed development stories that contain everything the dev agent needs - complete context, implementation details, and architectural guidance embedded directly in the story files.\n\nThis two-phase approach eliminates both **planning inconsistency** and **context loss** - the biggest problems in AI-assisted development. Your dev agent opens a story file with full understanding of what to build, how to build it, and why.\n\n**πŸ“– [See the complete workflow in the User Guide](docs/guides/user-guide.md)** - Planning phase, development cycle, and all agent roles\n\n## Prerequisites\n\n- Node.js \u003e=18.0.0 (v20+ recommended)\n- npm \u003e=9.0.0\n- GitHub CLI (optional, required for team collaboration)\n\n\u003e **Installation issues?** See the [Troubleshooting Guide](docs/guides/installation-troubleshooting.md)\n\n**Platform-specific guides:**\n\n- πŸ“– [macOS Installation Guide](docs/installation/macos.md)\n- πŸ“– [Windows Installation Guide](docs/installation/windows.md)\n- πŸ“– [Linux Installation Guide](docs/installation/linux.md)\n\n**Multilingual documentation available:** [PortuguΓͺs](docs/pt/installation/) | [EspaΓ±ol](docs/es/installation/)\n\n## Quick Navigation\n\n### Understanding the AIOX Workflow\n\n**Before diving in, review these critical workflow diagrams that explain how AIOX works:**\n\n1. **[Planning Workflow (Web Interface)](docs/guides/user-guide.md#the-planning-workflow-web-ui)** - How to create PRD and Architecture documents\n2. **[Core Development Cycle (IDE)](docs/guides/user-guide.md#the-core-development-cycle-ide)** - How the sm, dev, and qa agents collaborate through story files\n\n\u003e ⚠️ **These diagrams explain 90% of the confusion about the Synkra AIOX Agentic Agile workflow** - Understanding PRD+Architecture creation and the sm/dev/qa workflow and how agents pass notes through story files is essential - and it also explains why this is NOT taskmaster or just a simple task runner!\n\n### What would you like to do?\n\n- **[Install and Build software with a Full Stack AI Agile Team](#quick-start)** β†’ Quick Start Instructions\n- **[Learn how to use AIOX](docs/guides/user-guide.md)** β†’ Complete user guide and walkthrough\n- **[See available AI agents](#available-agents)** β†’ Specialized roles for your team\n- **[Explore non-technical uses](#-beyond-software-development---squads)** β†’ Creative writing, business, wellness, education\n- **[Create my own AI agents](#creating-your-own-squad)** β†’ Build agents for your domain\n- **[Browse ready-made Squads](docs/guides/squads-overview.md)** β†’ See how to create and use AI agent teams\n- **[Understand the architecture](docs/architecture/ARCHITECTURE-INDEX.md)** β†’ Deep technical dive\n- **[Report issues](https://github.com/SynkraAI/aiox-core/issues)** β†’ Bug reports and feature requests\n\n## Important: Keep Your AIOX Installation Updated\n\n**Stay up to date effortlessly!** To update your existing AIOX installation:\n\n```bash\nnpx aiox-core@latest install\n```\n\nThis will:\n\n- βœ… Automatically detect your existing installation\n- βœ… Update only the files that have changed\n- βœ… Create `.bak` backup files for any custom modifications\n- βœ… Preserve your project-specific settings\n\nThis makes it easy to benefit from the latest improvements, bug fixes, and new agents without losing your customizations!\n\n## Quick Start\n\n### πŸš€ Installation via NPX (Recommended)\n\n**Install Synkra AIOX with a single command:**\n\n```bash\n# Create a new project with modern interactive wizard\nnpx aiox-core init my-project\n\n# Or install in an existing project\ncd your-project\nnpx aiox-core install\n\n# Or use a specific version\nnpx aiox-core@latest init my-project\n```\n\n### ✨ Modern Installation Wizard\n\nSynkra AIOX now includes a cutting-edge interactive installation experience, inspired by modern tools like Vite and Next.js:\n\n**Interactive Installer Features:**\n\n- 🎨 **Modern Interface**: Colorful and visual prompts with @clack/prompts\n- βœ… **Real-Time Validation**: Instant feedback on invalid inputs\n- πŸ”„ **Progress Indicators**: Spinners for long operations (file copying, dependency installation)\n- πŸ“¦ **Multi-Component Selection**: Choose which components to install with an intuitive interface\n- βš™οΈ **Package Manager Choice**: Select between npm, yarn, or pnpm\n- ⌨️ **Cancellation Support**: Ctrl+C or ESC to exit gracefully at any time\n- πŸ“Š **Installation Summary**: View all settings before proceeding\n- ⏱️ **Duration Tracking**: See how long the installation took\n\n**The installer offers:**\n\n- βœ… Download of the latest version from NPM\n- βœ… Modern interactive installation wizard\n- βœ… Automatic IDE configuration (Codex CLI, Cursor, or Claude Code)\n- βœ… Configuration of all AIOX agents and workflows\n- βœ… Creation of necessary configuration files\n- βœ… Meta-agent system initialization\n- βœ… System health checks\n- βœ… **Cross-Platform Support**: Tested on Windows, macOS, and Linux\n\n\u003e **That's it!** No cloning, no manual configuration - just one command and you're ready to go with a modern, professional installation experience.\n\n**Prerequisites**: [Node.js](https://nodejs.org) v18+ required (v20+ recommended) | [Troubleshooting](docs/guides/installation-troubleshooting.md)\n\n### Updating an Existing Installation\n\nIf you already have AIOX installed:\n\n```bash\nnpx aiox-core@latest install\n# The installer will detect your existing installation and update it\n```\n\n### Configure Your IDE for AIOX Development\n\nSynkra AIOX includes pre-configured IDE rules to enhance your development experience:\n\n#### For Cursor:\n\n1. Open Cursor settings\n2. Navigate to **User Rules**\n3. Copy the contents of `.cursor/global-rules.md`\n4. Paste in the rules section and save\n\n#### For Claude Code:\n\n- βœ… Already configured! The `.claude/CLAUDE.md` file is loaded automatically\n- Dedicated agent sync: `npm run sync:ide:claude`\n- Dedicated validation: `npm run validate:claude-sync \u0026\u0026 npm run validate:claude-integration`\n\n#### For Codex CLI:\n\n- βœ… First-class integration in AIOX 4.2 (shared activation and greeting pipeline)\n- βœ… Already configured! The `AGENTS.md` file at the root is loaded automatically\n- Optional: sync auxiliary agents with `npm run sync:ide:codex`\n- Recommended in this repository: generate and version local skills with `npm run sync:skills:codex`\n- Use `npm run sync:skills:codex:global` only outside this project (to avoid duplication in `/skills`)\n- Dedicated validation: `npm run validate:codex-sync \u0026\u0026 npm run validate:codex-integration`\n- Skills/paths guardrails: `npm run validate:codex-skills \u0026\u0026 npm run validate:paths`\n\n#### For Gemini CLI:\n\n- βœ… Rules and agents syncable with `npm run sync:ide:gemini`\n- Generated files in `.gemini/rules.md`, `.gemini/rules/AIOX/agents/`, and `.gemini/commands/*.toml`\n- βœ… Local hooks and settings in the installation flow (`.gemini/hooks/` + `.gemini/settings.json`)\n- βœ… Quick activation via slash commands (`/aiox-menu`, `/aiox-dev`, `/aiox-architect`, etc.)\n- Dedicated validation: `npm run validate:gemini-sync \u0026\u0026 npm run validate:gemini-integration`\n- Multi-IDE parity in one command: `npm run validate:parity`\n\nThese rules provide:\n\n- πŸ€– Agent command recognition and integration\n- πŸ“‹ Story-driven development workflow\n- βœ… Automatic checkbox tracking\n- πŸ§ͺ Testing and validation patterns\n- πŸ“ AIOX-specific code patterns\n\n### Fastest Start with Web Interface (2 minutes)\n\n1. **Install AIOX**: Run `npx aiox-core init my-project`\n2. **Configure your IDE**: Follow the setup instructions for Codex CLI, Cursor, or Claude Code\n3. **Start Planning**: Activate an agent like `@analyst` to begin creating your briefing\n4. **Use AIOX commands**: Type `*help` to see available commands\n5. **Follow the flow**: See the [User Guide](docs/guides/user-guide.md) for more details\n\n### CLI Command Reference\n\nSynkra AIOX offers a modern, cross-platform CLI with intuitive commands:\n\n```bash\n# Project Management (with interactive wizard)\nnpx aiox-core init \u003cproject-name\u003e [options]\n --force Force creation in non-empty directory\n --skip-install Skip npm dependency installation\n --template \u003cname\u003e Use specific template (default, minimal, enterprise)\n\n# Installation and Configuration (with modern prompts)\nnpx aiox-core install [options]\n --force Overwrite existing configuration\n --quiet Minimal output during installation\n --dry-run Simulate installation without modifying files\n\n# System Commands\nnpx aiox-core --version Display installed version\nnpx aiox-core --help Display detailed help\nnpx aiox-core info Display system information\nnpx aiox-core doctor Run system diagnostics\nnpx aiox-core doctor --fix Automatically fix detected issues\n\n# Maintenance\nnpx aiox-core update Update to latest version\nnpx aiox-core uninstall Remove Synkra AIOX\n```\n\n**CLI Features:**\n\n- βœ… **Comprehensive Help System**: `--help` on any command shows detailed documentation\n- βœ… **Input Validation**: Immediate feedback on invalid parameters\n- βœ… **Colored Messages**: Errors in red, successes in green, warnings in yellow\n- βœ… **Cross-Platform**: Works seamlessly on Windows, macOS, and Linux\n- βœ… **Dry-Run Support**: Test installations without modifying files\n\n### πŸ’‘ Usage Examples\n\n#### Full Interactive Installation\n\n```bash\n$ npx aiox-core install\n\nπŸš€ Synkra AIOX Installation\n\nβ—† What is your project name?\nβ”‚ my-awesome-project\nβ”‚\nβ—‡ Which directory should we use?\nβ”‚ ./my-awesome-project\nβ”‚\nβ—† Choose components to install:\nβ”‚ ● Core Framework (Required)\nβ”‚ ● Agent System (Required)\nβ”‚ ● Squads (optional)\nβ”‚ β—‹ Example Projects (optional)\nβ”‚\nβ—‡ Select package manager:\nβ”‚ ● npm\nβ”‚ β—‹ yarn\nβ”‚ β—‹ pnpm\nβ”‚\nβ—† Initialize Git repository?\nβ”‚ Yes\nβ”‚\nβ—† Install dependencies?\nβ”‚ Yes\nβ”‚\nβ–Έ Creating project directory...\nβ–Έ Copying framework files...\nβ–Έ Initializing Git repository...\nβ–Έ Installing dependencies (this may take a minute)...\nβ–Έ Configuring environment...\nβ–Έ Running post-installation setup...\n\nβœ” Installation completed successfully! (34.2s)\n\nNext steps:\n cd my-awesome-project\n aiox-core doctor # Verify installation\n aiox-core --help # See available commands\n```\n\n#### Silent Installation (CI/CD)\n\n```bash\n# Automated installation without prompts\n$ npx aiox-core install --quiet --force\nβœ” Synkra AIOX installed successfully\n```\n\n#### Installation Simulation (Dry-Run)\n\n```bash\n# Test installation without modifying files\n$ npx aiox-core install --dry-run\n\n[DRY RUN] Would create: ./my-project/\n[DRY RUN] Would copy: .aiox-core/ (45 files)\n[DRY RUN] Would initialize: Git repository\n[DRY RUN] Would install: npm dependencies\nβœ” Dry run completed - no files were modified\n```\n\n#### System Diagnostics\n\n```bash\n$ npx aiox-core doctor\n\nπŸ₯ AIOX System Diagnostics\n\nβœ” Node.js version: v20.10.0 (meets requirement: \u003e=18.0.0)\nβœ” npm version: 10.2.3\nβœ” Git installed: version 2.43.0\nβœ” GitHub CLI: gh 2.40.1\nβœ” Synkra AIOX: v4.2.11\n\nConfiguration:\nβœ” .aiox-core/ directory exists\nβœ” Agent files: 11 found\nβœ” Workflow files: 8 found\nβœ” Templates: 15 found\n\nDependencies:\nβœ” @clack/prompts: ^0.7.0\nβœ” commander: ^12.0.0\nβœ” execa: ^9.0.0\nβœ” fs-extra: ^11.0.0\nβœ” picocolors: ^1.0.0\n\nβœ… All checks passed! Your installation is healthy.\n```\n\n#### Get Help\n\n```bash\n$ npx aiox-core --help\n\nUsage: aiox-core [options] [command]\n\nSynkra AIOX: AI-Orchestrated System for Full Stack Development\n\nOptions:\n -V, --version output the version number\n -h, --help display help for command\n\nCommands:\n init \u003cproject-name\u003e Create new AIOX project with interactive wizard\n install [options] Install AIOX in current directory\n info Display system information\n doctor [options] Run system diagnostics and health checks\n help [command] display help for command\n\nRun 'aiox-core \u003ccommand\u003e --help' for detailed information about each command.\n```\n\n### Alternative: Clone and Build\n\nFor contributors or advanced users who want to modify the source code:\n\n```bash\n# Clone the repository\ngit clone https://github.com/SynkraAI/aiox-core.git\ncd aiox-core\n\n# Install dependencies\nnpm install\n\n# Run the installer\nnpm run install:aiox\n```\n\n### Quick Team Setup\n\nFor team members joining the project:\n\n```bash\n# Install AIOX in the project\nnpx aiox-core@latest install\n\n# This will:\n# 1. Detect existing installation (if any)\n# 2. Install/update AIOX framework\n# 3. Configure agents and workflows\n```\n\n## 🌟 Beyond Software Development - Squads\n\nThe AIOX natural language framework works in ANY domain. Squads provide specialized AI agents for creative writing, business strategy, health and wellness, education, and more. Additionally, Squads can expand the Synkra AIOX core with domain-specific functionality that isn't generic for all use cases. [See the Squads Guide](docs/guides/squads-guide.md) and learn to create your own!\n\n## Available Agents\n\nSynkra AIOX comes with 12 specialized agents:\n\n### Meta Agents\n\n- **aiox-master** - Master orchestration agent (includes framework development capabilities)\n- **aiox-orchestrator** - Workflow orchestrator and team coordination\n\n### Planning Agents (Web Interface)\n\n- **analyst** - Business analysis specialist and PRD creation\n- **pm** (Product Manager) - Product manager and prioritization\n- **architect** - System architect and technical design\n- **ux-expert** - User experience design and usability\n\n### Development Agents (IDE)\n\n- **sm** (Scrum Master) - Sprint management and story creation\n- **dev** - Developer and implementation\n- **qa** - Quality assurance and testing\n- **po** (Product Owner) - Backlog and story management\n- **data-engineer** - Database design and data modeling\n- **devops** - CI/CD, infrastructure, and git operations (exclusive push authority)\n\n## Documentation and Resources\n\n### Essential Guides\n\n- πŸ“– **[User Guide](docs/guides/user-guide.md)** - Complete walkthrough from conception to project completion\n- πŸ—οΈ **[Core Architecture](docs/architecture/ARCHITECTURE-INDEX.md)** - Deep technical dive and system design\n- πŸš€ **[Squads Guide](docs/guides/squads-guide.md)** - Extend AIOX to any domain beyond software development\n\n### Additional Documentation\n\n- πŸ€– **[Squads Guide](docs/guides/squads-guide.md)** - Create and publish AI agent teams\n- πŸ“‹ **[Getting Started](docs/getting-started.md)** - Step-by-step tutorial for beginners\n- πŸ”§ **[Troubleshooting](docs/troubleshooting.md)** - Solutions for common issues\n- 🎯 **[Guiding Principles](docs/GUIDING-PRINCIPLES.md)** - AIOX philosophy and best practices\n- πŸ›οΈ **[Architecture Overview](docs/architecture/ARCHITECTURE-INDEX.md)** - Detailed view of system architecture\n- βš™οΈ **[Performance Tuning Guide](docs/performance-tuning-guide.md)** - Optimize your AIOX workflow\n- πŸ”’ **[Security Best Practices](docs/security-best-practices.md)** - Security and data protection\n- πŸ”„ **[Migration Guide](docs/migration-guide.md)** - Migration from previous versions\n- πŸ“¦ **[Versioning and Releases](docs/versioning-and-releases.md)** - Versioning policy\n\n## πŸ€– AIOX Autonomous Development Engine (ADE)\n\nSynkra AIOX introduces the **Autonomous Development Engine (ADE)** - a complete system for autonomous development that transforms requirements into working code.\n\n### 🎯 What is ADE?\n\nADE is a set of **7 Epics** that enable autonomous development execution:\n\n| Epic | Name | Description |\n| ----- | ---------------- | ------------------------------------------ |\n| **1** | Worktree Manager | Branch isolation via Git worktrees |\n| **2** | Migration V2β†’V3 | Migration to autoClaude V3 format |\n| **3** | Spec Pipeline | Transforms requirements into executable specs |\n| **4** | Execution Engine | Executes specs with 13 steps + self-critique |\n| **5** | Recovery System | Automatic failure recovery |\n| **6** | QA Evolution | Structured review in 10 phases |\n| **7** | Memory Layer | Persistent memory of patterns and insights |\n\n### πŸ”„ Main Flow\n\n```text\nUser Request β†’ Spec Pipeline β†’ Execution Engine β†’ QA Review β†’ Working Code\n ↓\n Recovery System\n ↓\n Memory Layer\n```\n\n### ⚑ Quick Start ADE\n\n```bash\n# 1. Create spec from requirement\n@pm *gather-requirements\n@architect *assess-complexity\n@analyst *research-deps\n@pm *write-spec\n@qa *critique-spec\n\n# 2. Execute approved spec\n@architect *create-plan\n@architect *create-context\n@dev *execute-subtask 1.1\n\n# 3. QA Review\n@qa *review-build STORY-42\n```\n\n### πŸ“– ADE Documentation\n\n- **[Complete ADE Guide](docs/guides/ade-guide.md)** - Step-by-step tutorial\n- **[Agent Changes](docs/architecture/ADE-AGENT-CHANGES.md)** - Commands and capabilities per agent\n- **[Epic 1 - Worktree Manager](docs/architecture/ADE-EPIC1-HANDOFF.md)**\n- **[Epic 2 - Migration V2β†’V3](docs/architecture/ADE-EPIC2-HANDOFF.md)**\n- **[Epic 3 - Spec Pipeline](docs/architecture/ADE-EPIC3-HANDOFF.md)**\n- **[Epic 4 - Execution Engine](docs/architecture/ADE-EPIC4-HANDOFF.md)**\n- **[Epic 5 - Recovery System](docs/architecture/ADE-EPIC5-HANDOFF.md)**\n- **[Epic 6 - QA Evolution](docs/architecture/ADE-EPIC6-HANDOFF.md)**\n- **[Epic 7 - Memory Layer](docs/architecture/ADE-EPIC7-HANDOFF.md)**\n\n### πŸ†• New Commands per Agent\n\n**@devops:**\n\n- `*create-worktree`, `*list-worktrees`, `*merge-worktree`, `*cleanup-worktrees`\n- `*inventory-assets`, `*analyze-paths`, `*migrate-agent`, `*migrate-batch`\n\n**@pm:**\n\n- `*gather-requirements`, `*write-spec`\n\n**@architect:**\n\n- `*assess-complexity`, `*create-plan`, `*create-context`, `*map-codebase`\n\n**@analyst:**\n\n- `*research-deps`, `*extract-patterns`\n\n**@qa:**\n\n- `*critique-spec`, `*review-build`, `*request-fix`, `*verify-fix`\n\n**@dev:**\n\n- `*execute-subtask`, `*track-attempt`, `*rollback`, `*capture-insights`, `*list-gotchas`, `*apply-qa-fix`\n\n## Creating Your Own Squad\n\nSquads allow you to extend AIOX to any domain. Basic structure:\n\n```text\nsquads/your-squad/\nβ”œβ”€β”€ config.yaml # Squad configuration\nβ”œβ”€β”€ agents/ # Specialized agents\nβ”œβ”€β”€ tasks/ # Task workflows\nβ”œβ”€β”€ templates/ # Document templates\nβ”œβ”€β”€ checklists/ # Validation checklists\nβ”œβ”€β”€ data/ # Knowledge base\nβ”œβ”€β”€ README.md # Squad documentation\n└── user-guide.md # User guide\n```\n\nSee the [Squads Guide](docs/guides/squads-guide.md) for detailed instructions.\n\n## Available Squads\n\nSquads are modular AI agent teams. See the [Squads Overview](docs/guides/squads-overview.md) for more information.\n\n### External Squads\n\n- **[hybrid-ops](https://github.com/SynkraAI/aiox-hybrid-ops-pedro-valerio)** - Human-agent hybrid operations (separate repository)\n\n## AIOX Pro\n\n**AIOX Pro** (`@aiox-fullstack/pro`) is the premium module of Synkra AIOX, offering advanced features for teams and larger-scale projects.\n\n\u003e **Restricted availability:** AIOX Pro is available exclusively to members of the **AIOX Cohort Advanced**. [Learn more about the program](https://synkra.ai).\n\n### Installation\n\n```bash\nnpm install @aiox-fullstack/pro\n```\n\n### Premium Features\n\n- **Advanced Squads** - Specialized squads with expanded capabilities\n- **Memory Layer** - Persistent memory of patterns and insights across sessions\n- **Metrics \u0026 Analytics** - Productivity dashboard and development metrics\n- **Enterprise Integrations** - Connectors for Jira, Linear, Notion, and more\n- **Layered Configuration** - L1-L4 configuration system with inheritance\n- **Licensing** - License management via `aiox pro activate --key \u003cKEY\u003e`\n\nFor more information, run `npx aiox-core pro --help` after installation.\n\n## Support\n\n- πŸ› [Issue Tracker](https://github.com/SynkraAI/aiox-core/issues) - Bug reports and feature requests\n- πŸ’‘ [Feature Process](docs/FEATURE_PROCESS.md) - How to propose new features\n- πŸ“‹ [How to Contribute](CONTRIBUTING.md)\n- πŸ—ΊοΈ [Roadmap](docs/roadmap.md) - See what we're building\n- πŸ€– [Squads Guide](docs/guides/squads-guide.md) - Create AI agent teams\n\n## Git Workflow and Validation\n\nSynkra AIOX implements a multi-layer validation system to ensure code quality and consistency:\n\n### πŸ›‘οΈ Defense in Depth - 3 Validation Layers\n\n**Layer 1: Pre-commit (Local - Fast)**\n\n- βœ… ESLint - Code quality\n- βœ… TypeScript - Type checking\n- ⚑ Performance: \u003c5s\n- πŸ’Ύ Cache enabled\n\n**Layer 2: Pre-push (Local - Story Validation)**\n\n- βœ… Story checkbox validation\n- βœ… Status consistency\n- βœ… Required sections\n\n**Layer 3: CI/CD (Cloud - Required for merge)**\n\n- βœ… All tests\n- βœ… Test coverage (80% minimum)\n- βœ… Complete validations\n- βœ… GitHub Actions\n\n### πŸ“– Detailed Documentation\n\n- πŸ“‹ **[Complete Git Workflow Guide](docs/git-workflow-guide.md)** - Detailed workflow guide\n- πŸ“‹ **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guide\n\n### Available Commands\n\n```bash\n# Local validations\nnpm run lint # ESLint\nnpm run typecheck # TypeScript\nnpm test # Tests\nnpm run test:coverage # Tests with coverage\n\n# AIOX Validator\nnode .aiox-core/utils/aiox-validator.js pre-commit # Pre-commit validation\nnode .aiox-core/utils/aiox-validator.js pre-push # Pre-push validation\nnode .aiox-core/utils/aiox-validator.js stories # Validate all stories\n```\n\n### Branch Protection\n\nConfigure master branch protection with:\n\n```bash\nnode scripts/setup-branch-protection.js\n```\n\nRequires:\n\n- GitHub CLI (gh) installed and authenticated\n- Admin access to the repository\n\n## Contributing\n\n**We're excited about contributions and welcome your ideas, improvements, and Squads!** πŸŽ‰\n\nTo contribute:\n\n1. Fork the repository\n2. Create a branch for your feature (`git checkout -b feature/MyNewFeature`)\n3. Commit your changes (`git commit -m 'feat: Add new feature'`)\n4. Push to the branch (`git push origin feature/MyNewFeature`)\n5. Open a Pull Request\n\nSee also:\n\n- πŸ“‹ [How to Contribute with Pull Requests](docs/how-to-contribute-with-pull-requests.md)\n- πŸ“‹ [Git Workflow Guide](docs/git-workflow-guide.md)\n\n## πŸ“„ Legal\n\n| Document | English | PortuguΓͺs |\n| --------------------- | ------------------------------------------- | ------------------------------------- |\n| **License** | [MIT License](LICENSE) | - |\n| **License Model** | [Core vs Pro](docs/legal/license-clarification.md) | - |\n| **Privacy** | [Privacy Policy](docs/legal/privacy.md) | - |\n| **Terms of Use** | [Terms of Use](docs/legal/terms.md) | - |\n| **Code of Conduct** | [Code of Conduct](CODE_OF_CONDUCT.md) | [PT-BR](docs/pt/code-of-conduct.md) |\n| **Contributing** | [Contributing](CONTRIBUTING.md) | [PT-BR](docs/pt/contributing.md) |\n| **Security** | [Security](docs/security.md) | [PT-BR](docs/pt/security.md) |\n| **Community** | [Community](docs/community.md) | [PT-BR](docs/pt/community.md) |\n| **Roadmap** | [Roadmap](docs/roadmap.md) | [PT-BR](docs/pt/roadmap.md) |\n| **Changelog** | [Version History](CHANGELOG.md) | - |\n\n## Acknowledgments\n\nThis project was originally derived from the [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD) by [Brian Madison](https://github.com/bmadcode). We thank Brian and all BMad Method contributors for the original work that made this project possible.\n\n**Note:** Some contributors shown in the GitHub contributors graph are inherited from the original BMad Method git history and do not represent active participation in or endorsement of Synkra AIOX.\n\n[![Contributors](https://contrib.rocks/image?repo=SynkraAI/aiox-core)](https://github.com/SynkraAI/aiox-core/graphs/contributors)\n\n\u003csub\u003eBuilt with ❀️ for the AI-assisted development community\u003c/sub\u003e\n\n---\n\n**[⬆ Back to top](#synkra-aiox-universal-ai-agent-framework-)**\n","funding_links":["https://f5.ventures/aioxfullstack"],"categories":["Repos"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSynkraAI%2Faiox-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSynkraAI%2Faiox-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSynkraAI%2Faiox-core/lists"}