[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-SynkraAI--aiox-core":3,"tool-SynkraAI--aiox-core":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":77,"owner_url":78,"languages":79,"stars":119,"forks":120,"last_commit_at":121,"license":122,"difficulty_score":23,"env_os":123,"env_gpu":124,"env_ram":124,"env_deps":125,"category_tags":132,"github_topics":133,"view_count":10,"oss_zip_url":77,"oss_zip_packed_at":77,"status":16,"created_at":146,"updated_at":147,"faqs":148,"releases":175},719,"SynkraAI\u002Faiox-core","aiox-core","Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0","aiox-core 是一款专为全栈开发打造的 AI 编排核心框架，致力于将人工智能的协作能力深度融入开发流程。面对当前 AI 辅助编程中智能体分散、工作流难以标准化的挑战，aiox-core 提供了一套统一的解决方案，让开发者能够灵活调度专业智能体并自动化执行任务。\n\naiox-core 主要适合追求高效交付的全栈开发者及 AI 应用构建者。它最大的技术亮点在于坚持“命令行优先（CLI First）”的架构理念，将智能决策与自动化执行集中在终端完成，同时兼顾可观测性与界面扩展。此外，aiox-core 具备强大的跨平台兼容性，支持 Claude Code、Gemini CLI 及 Cursor 等多种环境，并通过 Hooks 机制实现对开发生命周期的精细控制。作为开源项目，aiox-core 不仅降低了 AI 集成的门槛，还赋予了开发者对构建过程的完全掌控权，真正实现了以人为核心的智能开发体验。","# AIOX Squad: Artificial Intelligence Orchestration eXperience\n\n> 🌍 [English](README.en.md) | **[Português](README.md)**\n\n[![Versão NPM](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Faiox-core.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faiox-core)\n[![Licença: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![Versão Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-brightgreen.svg)](https:\u002F\u002Fnodejs.org\u002F)\n[![CI](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Factions\u002Fworkflows\u002Fci.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002FSynkraAI\u002Faiox-core\u002Fbranch\u002Fmain\u002Fgraph\u002Fbadge.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002FSynkraAI\u002Faiox-core)\n[![Documentação](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocs-disponível-orange.svg)](https:\u002F\u002Faioxsquad.ai)\n[![Open Source](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen%20Source-Yes-success.svg)](LICENSE)\n[![Contributions Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcontributions-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Code of Conduct](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode%20of%20conduct-Contributor%20Covenant-blue.svg)](CODE_OF_CONDUCT.md)\n\n> 🌐 README por idioma: [EN](docs\u002FREADME.md) | [PT](docs\u002Fpt\u002FREADME.md) | [ES](docs\u002Fes\u002FREADME.md) | [ZH](docs\u002Fzh\u002FREADME.md)\n>\n> **Devolvendo às pessoas o poder de criar** — Framework open source de orquestração de IA que devolve o controle a quem tem coragem de construir. Agentes especializados, workflows e experiência CLI First para qualquer domínio.\n\n## Comece Aqui (10 Min)\n\nSe é sua primeira vez no AIOX, siga este caminho linear:\n\n1. Instale em um projeto novo ou existente:\n```bash\n# novo projeto\nnpx aiox-core init meu-projeto\n\n# projeto existente\ncd seu-projeto\nnpx aiox-core install\n```\n2. Escolha sua IDE\u002FCLI e o caminho de ativação:\n- Claude Code: `\u002Fagent-name`\n- Gemini CLI: `\u002Faiox-menu` → `\u002Faiox-\u003Cagent>`\n- Codex CLI: `\u002Fskills` → `aiox-\u003Cagent-id>`\n- Cursor\u002FCopilot\u002FAntiGravity: siga os limites e workarounds em `docs\u002Fide-integration.md`\n3. Ative 1 agente e confirme o greeting.\n4. Rode 1 comando inicial (`*help` ou equivalente) para validar first-value.\n\nDefinição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em \u003C= 10 minutos.\n\n\n## Compatibilidade de Hooks por IDE (Realidade AIOX 4.2)\n\nMuitos recursos avançados do AIOX dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs\u002Fplataformas:\n\n| IDE\u002FCLI | Paridade de Hooks vs Claude | Impacto Prático |\n| --- | --- | --- |\n| Claude Code | Completa (referência) | Automação máxima de contexto, guardrails e auditoria |\n| Gemini CLI | Alta (eventos nativos) | Cobertura forte de automações pre\u002Fpost tool e sessão |\n| Codex CLI | Parcial\u002Flimitada | Parte das automações depende de `AGENTS.md`, `\u002Fskills`, MCP e fluxo operacional |\n| Cursor | Sem lifecycle hooks equivalentes | Menor automação de pre\u002Fpost tool; foco em regras, MCP e fluxo do agente |\n| GitHub Copilot | Sem lifecycle hooks equivalentes | Menor automação de sessão\u002Ftooling; foco em instruções de repositório + MCP no VS Code |\n| AntiGravity | Workflow-based (não hook-based) | Integração por workflows, não por eventos de hook equivalentes ao Claude |\n\nImpactos e mitigação detalhados: `docs\u002Fide-integration.md`.\n\n## Visão Geral\n\n### Premissa Arquitetural: CLI First\n\nO AIOX segue uma hierarquia clara de prioridades:\n\n```\nCLI First → Observability Second → UI Third\n```\n\n| Camada            | Prioridade | Foco                                                                          | Exemplos                                     |\n| ----------------- | ---------- | ----------------------------------------------------------------------------- | -------------------------------------------- |\n| **CLI**           | Máxima     | Onde a inteligência vive. Toda execução, decisões e automação acontecem aqui. | Agentes (`@dev`, `@qa`), workflows, comandos |\n| **Observability** | Secundária | Observar e monitorar o que acontece no CLI em tempo real.                     | Dashboard SSE, logs, métricas, timeline      |\n| **UI**            | Terciária  | Gestão pontual e visualizações quando necessário.                             | Kanban, settings, story management           |\n\n**Princípios derivados:**\n\n- A CLI é a fonte da verdade - dashboards apenas observam\n- Funcionalidades novas devem funcionar 100% via CLI antes de ter UI\n- A UI nunca deve ser requisito para operação do sistema\n- Observabilidade serve para entender o que o CLI está fazendo, não para controlá-lo\n\n---\n\n**As Duas Inovações Chave do AIOX:**\n\n**1. Planejamento Agêntico:** Agentes dedicados (analyst, pm, architect) colaboram com você para criar documentos de PRD e Arquitetura detalhados e consistentes. Através de engenharia avançada de prompts e refinamento com human-in-the-loop, estes agentes de planejamento produzem especificações abrangentes que vão muito além da geração genérica de tarefas de IA.\n\n**2. Desenvolvimento Contextualizado por Engenharia:** O agente sm (Scrum Master) então transforma estes planos detalhados em histórias de desenvolvimento hiperdetalhadas que contêm tudo que o agente dev precisa - contexto completo, detalhes de implementação e orientação arquitetural incorporada diretamente nos arquivos de histórias.\n\nEsta abordagem de duas fases elimina tanto a **inconsistência de planejamento** quanto a **perda de contexto** - os maiores problemas no desenvolvimento assistido por IA. Seu agente dev abre um arquivo de história com compreensão completa do que construir, como construir e por quê.\n\n**📖 [Veja o fluxo de trabalho completo no Guia do Usuário](docs\u002Fguides\u002Fuser-guide.md)** - Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes\n\n## Pré-requisitos\n\n- Node.js >=18.0.0 (v20+ recomendado)\n- npm >=9.0.0\n- GitHub CLI (opcional, necessário para colaboração em equipe)\n\n> **Problemas de instalação?** Consulte o [Guia de Troubleshooting](docs\u002Fguides\u002Finstallation-troubleshooting.md)\n\n**Guias específicos por plataforma:**\n\n- 📖 [Guia de Instalação para macOS](docs\u002Finstallation\u002Fmacos.md)\n- 📖 [Guia de Instalação para Windows](docs\u002Finstallation\u002Fwindows.md)\n- 📖 [Guia de Instalação para Linux](docs\u002Finstallation\u002Flinux.md)\n\n**Documentação multilíngue disponível:** [English](docs\u002FREADME.md) | [Português](docs\u002Fpt\u002FREADME.md) | [Español](docs\u002Fes\u002FREADME.md) | [中文](docs\u002Fzh\u002FREADME.md)\n\n## Navegação Rápida\n\n### Entendendo o Fluxo de Trabalho AIOX\n\n**Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o AIOX funciona:**\n\n1. **[Fluxo de Planejamento (Interface Web)](docs\u002Fguides\u002Fuser-guide.md#the-planning-workflow-web-ui)** - Como criar documentos de PRD e Arquitetura\n2. **[Ciclo Principal de Desenvolvimento (IDE)](docs\u002Fguides\u002Fuser-guide.md#the-core-development-cycle-ide)** - Como os agentes sm, dev e qa colaboram através de arquivos de histórias\n\n> ⚠️ **Estes diagramas explicam 90% da confusão sobre o fluxo AIOX Agentic Agile** - Entender a criação de PRD+Arquitetura e o fluxo de trabalho sm\u002Fdev\u002Fqa e como os agentes passam notas através de arquivos de histórias é essencial - e também explica por que isto NÃO é taskmaster ou apenas um simples executor de tarefas!\n\n### O que você gostaria de fazer?\n\n- **[Instalar e Construir software com Equipe Ágil Full Stack de IA](#início-rápido)** → Instruções de Início Rápido\n- **[Aprender como usar o AIOX](docs\u002Fguides\u002Fuser-guide.md)** → Guia completo do usuário e passo a passo\n- **[Ver agentes IA disponíveis](#agentes-disponíveis)** → Papéis especializados para sua equipe\n- **[Explorar usos não técnicos](#-além-do-desenvolvimento-de-software---squads)** → Escrita criativa, negócios, bem-estar, educação\n- **[Criar meus próprios agentes IA](#criando-seu-próprio-squad)** → Construir agentes para seu domínio\n- **[Navegar Squads prontos](docs\u002Fguides\u002Fsquads-overview.md)** → Veja como criar e usar equipes de agentes IA\n- **[Entender a arquitetura](docs\u002Farchitecture\u002FARCHITECTURE-INDEX.md)** → Mergulho técnico profundo\n- **[Reportar problemas](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues)** → Bug reports e feature requests\n\n## Importante: Mantenha Sua Instalação AIOX Atualizada\n\n**Mantenha-se atualizado sem esforço!** Para atualizar sua instalação AIOX existente:\n\n```bash\nnpx aiox-core@latest install\n```\n\nIsto vai:\n\n- ✅ Detectar automaticamente sua instalação existente\n- ✅ Atualizar apenas os arquivos que mudaram\n- ✅ Criar arquivos de backup `.bak` para quaisquer modificações customizadas\n- ✅ Preservar suas configurações específicas do projeto\n\nIsto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!\n\n## Início Rápido\n\n### 🚀 Instalação via NPX (Recomendado)\n\n**Instale o AIOX com um único comando:**\n\n```bash\n# Criar um novo projeto com assistente interativo moderno\nnpx aiox-core init meu-projeto\n\n# Ou instalar em projeto existente\ncd seu-projeto\nnpx aiox-core install\n\n# Ou usar uma versão específica\nnpx aiox-core@latest init meu-projeto\n```\n\n### ✨ Assistente de Instalação Moderno\n\nO AIOX agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:\n\n**Recursos do Instalador Interativo:**\n\n- 🎨 **Interface Moderna**: Prompts coloridos e visuais com @clack\u002Fprompts\n- ✅ **Validação em Tempo Real**: Feedback instantâneo sobre entradas inválidas\n- 🔄 **Indicadores de Progresso**: Spinners para operações longas (cópia de arquivos, instalação de deps)\n- 📦 **Seleção Multi-Componente**: Escolha quais componentes instalar com interface intuitiva\n- ⚙️ **Escolha de Gerenciador de Pacotes**: Selecione entre npm, yarn ou pnpm\n- ⌨️ **Suporte a Cancelamento**: Ctrl+C ou ESC para sair graciosamente a qualquer momento\n- 📊 **Resumo de Instalação**: Visualize todas as configurações antes de prosseguir\n- ⏱️ **Rastreamento de Duração**: Veja quanto tempo levou a instalação\n\n**O instalador oferece:**\n\n- ✅ Download da versão mais recente do NPM\n- ✅ Assistente de instalação interativo moderno\n- ✅ Configuração automática do IDE (Codex CLI, Cursor ou Claude Code)\n- ✅ Configuração de todos os agentes e fluxos de trabalho AIOX\n- ✅ Criação dos arquivos de configuração necessários\n- ✅ Inicialização do sistema de meta-agentes\n- ✅ Verificações de saúde do sistema\n- ✅ **Suporte Cross-Platform**: Testado em Windows, macOS e Linux\n\n> **É isso!** Sem clonar, sem configuração manual - apenas um comando e você está pronto para começar com uma experiência de instalação moderna e profissional.\n\n**Pré-requisitos**: [Node.js](https:\u002F\u002Fnodejs.org) v18+ necessário (v20+ recomendado) | [Troubleshooting](docs\u002Fguides\u002Finstallation-troubleshooting.md)\n\n### Atualizando uma Instalação Existente\n\nSe você já tem o AIOX instalado:\n\n```bash\nnpx aiox-core@latest install\n# O instalador detectará sua instalação existente e a atualizará\n```\n\n### Configure Seu IDE para Desenvolvimento AIOX\n\nO AIOX inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:\n\n#### Para Cursor:\n\n1. Abra as configurações do Cursor\n2. Navegue até **User Rules**\n3. Copie o conteúdo de `.cursor\u002Fglobal-rules.md`\n4. Cole na seção de regras e salve\n\n#### Para Claude Code:\n\n- ✅ Já configurado! O arquivo `.claude\u002FCLAUDE.md` é carregado automaticamente\n- Sync dedicado de agentes: `npm run sync:ide:claude`\n- Validacao dedicada: `npm run validate:claude-sync && npm run validate:claude-integration`\n\n#### Para Codex CLI:\n\n- ✅ Integração de primeira classe no AIOX 4.2 (pipeline de ativação e greeting compartilhado)\n- ✅ Já configurado! O arquivo `AGENTS.md` na raiz é carregado automaticamente\n- Opcional: sincronize agentes auxiliares com `npm run sync:ide:codex`\n- Recomendado neste repositório: gerar e versionar skills locais com `npm run sync:skills:codex`\n- Use `npm run sync:skills:codex:global` apenas fora deste projeto (para evitar duplicidade no `\u002Fskills`)\n- Validacao dedicada: `npm run validate:codex-sync && npm run validate:codex-integration`\n- Guardrails de skills\u002Fpaths: `npm run validate:codex-skills && npm run validate:paths`\n\n#### Para Gemini CLI:\n\n- ✅ Regras e agentes sincronizaveis com `npm run sync:ide:gemini`\n- Arquivos gerados em `.gemini\u002Frules.md`, `.gemini\u002Frules\u002FAIOX\u002Fagents\u002F` e `.gemini\u002Fcommands\u002F*.toml`\n- ✅ Hooks e settings locais no fluxo de instalacao (`.gemini\u002Fhooks\u002F` + `.gemini\u002Fsettings.json`)\n- ✅ Ativacao rapida por slash commands (`\u002Faiox-menu`, `\u002Faiox-dev`, `\u002Faiox-architect`, etc.)\n- Validacao dedicada: `npm run validate:gemini-sync && npm run validate:gemini-integration`\n- Paridade multi-IDE em um comando: `npm run validate:parity`\n\nEstas regras fornecem:\n\n- 🤖 Reconhecimento e integração de comandos de agentes\n- 📋 Fluxo de trabalho de desenvolvimento dirigido por histórias\n- ✅ Rastreamento automático de checkboxes\n- 🧪 Padrões de teste e validação\n- 📝 Padrões de código específicos do AIOX\n\n### Início Mais Rápido com Interface Web (2 minutos)\n\n1. **Instale o AIOX**: Execute `npx aiox-core init meu-projeto`\n2. **Configure seu IDE**: Siga as instruções de configuração para Codex CLI, Cursor ou Claude Code\n3. **Comece a Planejar**: Ative um agente como `@analyst` para começar a criar seu briefing\n4. **Use comandos AIOX**: Digite `*help` para ver comandos disponíveis\n5. **Siga o fluxo**: Veja o [Guia do usuário](docs\u002Fguides\u002Fuser-guide.md) para mais detalhes\n\n### Referência de Comandos CLI\n\nO AIOX oferece uma CLI moderna e cross-platform com comandos intuitivos:\n\n```bash\n# Gerenciamento de Projeto (com assistente interativo)\nnpx aiox-core init \u003Cnome-projeto> [opções]\n  --force              Forçar criação em diretório não vazio\n  --skip-install       Pular instalação de dependências npm\n  --template \u003Cnome>    Usar template específico (default, minimal, enterprise)\n\n# Instalação e Configuração (com prompts modernos)\nnpx aiox-core install [opções]\n  --force              Sobrescrever configuração existente\n  --quiet              Saída mínima durante instalação\n  --dry-run            Simular instalação sem modificar arquivos\n\n# Comandos do Sistema\nnpx aiox-core --version   Exibir versão instalada\nnpx aiox-core --help      Exibir ajuda detalhada\nnpx aiox-core info        Exibir informações do sistema\nnpx aiox-core doctor      Executar diagnósticos do sistema\nnpx aiox-core doctor --fix Corrigir problemas detectados automaticamente\n\n# Manutenção\nnpx aiox-core update      Atualizar para versão mais recente\nnpx aiox-core uninstall   Remover AIOX\n```\n\n**Recursos da CLI:**\n\n- ✅ **Help System Abrangente**: `--help` em qualquer comando mostra documentação detalhada\n- ✅ **Validação de Entrada**: Feedback imediato sobre parâmetros inválidos\n- ✅ **Mensagens Coloridas**: Erros em vermelho, sucessos em verde, avisos em amarelo\n- ✅ **Cross-Platform**: Funciona perfeitamente em Windows, macOS e Linux\n- ✅ **Suporte a Dry-Run**: Teste instalações sem modificar arquivos\n\n### 💡 Exemplos de Uso\n\n#### Instalação Interativa Completa\n\n```bash\n$ npx aiox-core install\n\n🚀 AIOX Installation\n\n◆ What is your project name?\n│  my-awesome-project\n│\n◇ Which directory should we use?\n│  .\u002Fmy-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#### Instalação Silenciosa (CI\u002FCD)\n\n```bash\n# Instalação automatizada sem prompts\n$ npx aiox-core install --quiet --force\n✔ AIOX installed successfully\n```\n\n#### Simulação de Instalação (Dry-Run)\n\n```bash\n# Testar instalação sem modificar arquivos\n$ npx aiox-core install --dry-run\n\n[DRY RUN] Would create: .\u002Fmy-project\u002F\n[DRY RUN] Would copy: .aiox-core\u002F (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#### Diagnóstico do Sistema\n\n```bash\n$ npx aiox-core doctor\n\n🏥 AIOX System Diagnostics\n\n✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)\n✔ npm version: 10.2.3\n✔ Git installed: version 2.43.0\n✔ GitHub CLI: gh 2.40.1\n✔ AIOX: v4.2.11\n\nConfiguration:\n✔ .aiox-core\u002F directory exists\n✔ Agent files: 11 found\n✔ Workflow files: 8 found\n✔ Templates: 15 found\n\nDependencies:\n✔ @clack\u002Fprompts: ^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#### Obter Ajuda\n\n```bash\n$ npx aiox-core --help\n\nUsage: aiox-core [options] [command]\n\nAIOX: 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>          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> --help' for detailed information about each command.\n```\n\n### Alternativa: Clonar e Construir\n\nPara contribuidores ou usuários avançados que queiram modificar o código fonte:\n\n```bash\n# Clonar o repositório\ngit clone https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core.git\ncd aiox-core\n\n# Instalar dependências\nnpm install\n\n# Executar o instalador\nnpm run install:aiox\n```\n\n### Configuração Rápida para Equipe\n\nPara membros da equipe ingressando no projeto:\n\n```bash\n# Instalar AIOX no projeto\nnpx aiox-core@latest install\n\n# Isto vai:\n# 1. Detectar instalação existente (se houver)\n# 2. Instalar\u002Fatualizar framework AIOX\n# 3. Configurar agentes e workflows\n```\n\n## 🌟 Além do Desenvolvimento de Software - Squads\n\nO framework de linguagem natural do AIOX funciona em QUALQUER domínio. Os Squads fornecem agentes IA especializados para escrita criativa, estratégia de negócios, saúde e bem-estar, educação e muito mais. Além disso, os Squads podem expandir o núcleo do AIOX com funcionalidade específica que não é genérica para todos os casos. [Veja o Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md) e aprenda a criar os seus próprios!\n\n## Agentes Disponíveis\n\nO AIOX vem com 12 agentes especializados:\n\n### Agentes Meta\n\n- **aiox-master** - Agente mestre de orquestração (inclui capacidades de desenvolvimento de framework)\n- **aiox-orchestrator** - Orquestrador de fluxo de trabalho e coordenação de equipe\n\n### Agentes de Planejamento (Interface Web)\n\n- **analyst** - Especialista em análise de negócios e criação de PRD\n- **pm** (Product Manager) - Gerente de produto e priorização\n- **architect** - Arquiteto de sistema e design técnico\n- **ux-expert** - Design de experiência do usuário e usabilidade\n\n### Agentes de Desenvolvimento (IDE)\n\n- **sm** (Scrum Master) - Gerenciamento de sprint e criação de histórias\n- **dev** - Desenvolvedor e implementação\n- **qa** - Garantia de qualidade e testes\n- **po** (Product Owner) - Gerenciamento de backlog e histórias\n- **data-engineer** - Design de banco de dados e modelagem de dados\n- **devops** - CI\u002FCD, infraestrutura e operações git (autoridade exclusiva de push)\n\n## Documentação e Recursos\n\n### Guias Essenciais\n\n- 📖 **[Guia do Usuário](docs\u002Fguides\u002Fuser-guide.md)** - Passo a passo completo desde a concepção até a conclusão do projeto\n- 🏗️ **[Arquitetura Principal](docs\u002Farchitecture\u002FAIOX-VISUAL-OVERVIEW.md)** - Mergulho técnico profundo e design do sistema\n- 🚀 **[Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md)** - Estenda o AIOX para qualquer domínio além do desenvolvimento de software\n\n### Documentação Adicional\n\n- 🤖 **[Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md)** - Crie e publique equipes de agentes IA\n- 📋 **[Primeiros Passos](docs\u002Fgetting-started.md)** - Tutorial passo a passo para iniciantes\n- 🔧 **[Solução de Problemas](docs\u002Ftroubleshooting.md)** - Soluções para problemas comuns\n- 🎯 **[Princípios Orientadores](docs\u002FGUIDING-PRINCIPLES.md)** - Filosofia e melhores práticas do AIOX\n- 🏛️ **[Visão Geral da Arquitetura](docs\u002Farchitecture\u002FAIOX-VISUAL-OVERVIEW.md)** - Visão detalhada da arquitetura do sistema\n- ⚙️ **[Guia de Ajuste de Performance](docs\u002Fperformance-tuning-guide.md)** - Otimize seu fluxo de trabalho AIOX\n- 🔒 **[Melhores Práticas de Segurança](docs\u002Fsecurity-best-practices.md)** - Segurança e proteção de dados\n- 🔄 **[Guia de Migração](docs\u002Fmigration-guide.md)** - Migração de versões anteriores\n- 📦 **[Versionamento e Releases](docs\u002Fversioning-and-releases.md)** - Política de versões\n\n## 🤖 AIOX Autonomous Development Engine (ADE)\n\nO AIOX introduz o **Autonomous Development Engine (ADE)** - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.\n\n### 🎯 O Que é o ADE?\n\nO ADE é um conjunto de **7 Epics** que habilitam execução autônoma de desenvolvimento:\n\n| Epic  | Nome             | Descrição                                  |\n| ----- | ---------------- | ------------------------------------------ |\n| **1** | Worktree Manager | Isolamento de branches via Git worktrees   |\n| **2** | Migration V2→V3  | Migração para formato autoClaude V3        |\n| **3** | Spec Pipeline    | Transforma requisitos em specs executáveis |\n| **4** | Execution Engine | Executa specs com 13 steps + self-critique |\n| **5** | Recovery System  | Recuperação automática de falhas           |\n| **6** | QA Evolution     | Review estruturado em 10 fases             |\n| **7** | Memory Layer     | Memória persistente de padrões e insights  |\n\n### 🔄 Fluxo Principal\n\n```\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. Criar spec a partir de requisito\n@pm *gather-requirements\n@architect *assess-complexity\n@analyst *research-deps\n@pm *write-spec\n@qa *critique-spec\n\n# 2. Executar spec aprovada\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### 📖 Documentação ADE\n\n- **[Guia Completo do ADE](docs\u002Fguides\u002Fade-guide.md)** - Tutorial passo a passo\n- **[Alterações nos Agentes](docs\u002Farchitecture\u002FADE-AGENT-CHANGES.md)** - Comandos e capabilities por agente\n- **[Epic 1 - Worktree Manager](docs\u002Farchitecture\u002FADE-EPIC1-HANDOFF.md)**\n- **[Epic 2 - Migration V2→V3](docs\u002Farchitecture\u002FADE-EPIC2-HANDOFF.md)**\n- **[Epic 3 - Spec Pipeline](docs\u002Farchitecture\u002FADE-EPIC3-HANDOFF.md)**\n- **[Epic 4 - Execution Engine](docs\u002Farchitecture\u002FADE-EPIC4-HANDOFF.md)**\n- **[Epic 5 - Recovery System](docs\u002Farchitecture\u002FADE-EPIC5-HANDOFF.md)**\n- **[Epic 6 - QA Evolution](docs\u002Farchitecture\u002FADE-EPIC6-HANDOFF.md)**\n- **[Epic 7 - Memory Layer](docs\u002Farchitecture\u002FADE-EPIC7-HANDOFF.md)**\n\n### 🆕 Novos Comandos por Agente\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## Criando Seu Próprio Squad\n\nSquads permitem estender o AIOX para qualquer domínio. Estrutura básica:\n\n```\nsquads\u002Fseu-squad\u002F\n├── config.yaml           # Configuração do squad\n├── agents\u002F              # Agentes especializados\n├── tasks\u002F               # Fluxos de trabalho de tarefas\n├── templates\u002F           # Templates de documentos\n├── checklists\u002F          # Checklists de validação\n├── data\u002F                # Base de conhecimento\n├── README.md            # Documentação do squad\n└── user-guide.md        # Guia do usuário\n```\n\nVeja o [Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md) para instruções detalhadas.\n\n## Squads Disponíveis\n\nSquads são equipes modulares de agentes IA. Veja a [Visão Geral de Squads](docs\u002Fguides\u002Fsquads-overview.md) para mais informações.\n\n### Squads Externos\n\n- **[hybrid-ops](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-hybrid-ops-pedro-valerio)** - Operações híbridas humano-agente (repositório separado)\n\n## AIOX Pro\n\nO **AIOX Pro** (`@aiox-fullstack\u002Fpro`) é o módulo premium do AIOX, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.\n\n> **Disponibilidade restrita:** O AIOX Pro está disponível exclusivamente para membros do **AIOX Cohort Advanced**. [Saiba mais sobre o programa](https:\u002F\u002Faioxsquad.ai).\n\n### Instalação\n\n```bash\nnpm install @aiox-fullstack\u002Fpro\n```\n\n### Features Premium\n\n- **Squads Avançados** - Squads especializados com capacidades expandidas\n- **Memory Layer** - Memória persistente de padrões e insights entre sessões\n- **Métricas & Analytics** - Dashboard de produtividade e métricas de desenvolvimento\n- **Integrações Enterprise** - Conectores para Jira, Linear, Notion e mais\n- **Configuração em Camadas** - Sistema de configuração L1-L4 com herança\n- **Licenciamento** - Gerenciamento de licença via `aiox pro activate --key \u003CKEY>`\n\nPara mais informações, execute `npx aiox-core pro --help` após a instalação.\n\n## Suporte\n\n- 🐛 [Rastreador de Issues](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues) - Bug reports e feature requests\n- 💡 [Processo de Features](docs\u002FFEATURE_PROCESS.md) - Como propor novas funcionalidades\n- 📋 [Como Contribuir](CONTRIBUTING.md)\n- 🗺️ [Roadmap](docs\u002Froadmap.md) - Veja o que estamos construindo\n- 🤖 [Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md) - Crie equipes de agentes IA\n\n## Git Workflow e Validação\n\nO AIOX implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência:\n\n### 🛡️ Defense in Depth - 3 Camadas de Validação\n\n**Camada 1: Pre-commit (Local - Rápida)**\n\n- ✅ ESLint - Qualidade de código\n- ✅ TypeScript - Verificação de tipos\n- ⚡ Performance: \u003C5s\n- 💾 Cache habilitado\n\n**Camada 2: Pre-push (Local - Validação de Stories)**\n\n- ✅ Validação de checkboxes de histórias\n- ✅ Consistência de status\n- ✅ Seções obrigatórias\n\n**Camada 3: CI\u002FCD (Cloud - Obrigatório para merge)**\n\n- ✅ Todos os testes\n- ✅ Cobertura de testes (80% mínimo)\n- ✅ Validações completas\n- ✅ GitHub Actions\n\n### 📖 Documentação Detalhada\n\n- 📋 **[Guia Completo de Git Workflow](docs\u002Fgit-workflow-guide.md)** - Guia detalhado do fluxo de trabalho\n- 📋 **[CONTRIBUTING.md](CONTRIBUTING.md)** - Guia de contribuição\n\n### Comandos Disponíveis\n\n```bash\n# Validações locais\nnpm run lint           # ESLint\nnpm run typecheck      # TypeScript\nnpm test              # Testes\nnpm run test:coverage # Testes com cobertura\n\n# Validador AIOX\nnode .aiox-core\u002Futils\u002Faiox-validator.js pre-commit   # Validação pre-commit\nnode .aiox-core\u002Futils\u002Faiox-validator.js pre-push     # Validação pre-push\nnode .aiox-core\u002Futils\u002Faiox-validator.js stories      # Validar todas stories\n```\n\n### Branch Protection\n\nConfigure proteção da branch master com:\n\n```bash\nnode scripts\u002Fsetup-branch-protection.js\n```\n\nRequer:\n\n- GitHub CLI (gh) instalado e autenticado\n- Acesso de admin ao repositório\n\n## Contribuindo\n\n**Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e Squads!** 🎉\n\nPara contribuir:\n\n1. Fork o repositório\n2. Crie uma branch para sua feature (`git checkout -b feature\u002FMinhaNovaFeature`)\n3. Commit suas mudanças (`git commit -m 'feat: Adicionar nova feature'`)\n4. Push para a branch (`git push origin feature\u002FMinhaNovaFeature`)\n5. Abra um Pull Request\n\nVeja também:\n\n- 📋 [Como Contribuir com Pull Requests](docs\u002Fhow-to-contribute-with-pull-requests.md)\n- 📋 [Guia de Git Workflow](docs\u002Fgit-workflow-guide.md)\n\n## 📄 Legal\n\n| Documento             | English                                     | Português                             |\n| --------------------- | ------------------------------------------- | ------------------------------------- |\n| **Licença**           | [MIT License](LICENSE)                      | -                                     |\n| **Modelo de Licença** | [Core vs Pro](docs\u002Flegal\u002Flicense-clarification.md) | -                               |\n| **Privacidade**       | [Privacy Policy](docs\u002Flegal\u002Fprivacy.md)     | -                                     |\n| **Termos de Uso**     | [Terms of Use](docs\u002Flegal\u002Fterms.md)         | -                                     |\n| **Código de Conduta** | [Code of Conduct](CODE_OF_CONDUCT.md)       | [PT-BR](docs\u002Fpt\u002Fcode-of-conduct.md)   |\n| **Contribuição**      | [Contributing](CONTRIBUTING.md)             | [PT-BR](docs\u002Fpt\u002Fcontributing.md)      |\n| **Segurança**         | [Security](docs\u002Fsecurity.md)                | [PT-BR](docs\u002Fpt\u002Fsecurity.md)          |\n| **Comunidade**        | [Community](docs\u002Fcommunity.md)              | [PT-BR](docs\u002Fpt\u002Fcommunity.md)         |\n| **Roadmap**           | [Roadmap](docs\u002Froadmap.md)                  | [PT-BR](docs\u002Fpt\u002Froadmap.md)           |\n| **Changelog**         | [Version History](CHANGELOG.md)             | -                                     |\n\n## Contribuidores\n\n[![Contributors](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSynkraAI_aiox-core_readme_a9b64057b611.png)](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fgraphs\u002Fcontributors)\n\n### 🌟 Contribuidores da Comunidade\n\n\u003C!-- prettier-ignore-start -->\n\u003C!-- Manually maintained — add new community contributors here -->\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnikolasdehor\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSynkraAI_aiox-core_readme_064dcccdcd01.png\" width=\"100px;\" alt=\"Nikolas de Hor\"\u002F>\u003Cbr \u002F>\u003Csub>\u003Cb>Nikolas de Hor\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003Cbr \u002F>💻🐛⚠️👀\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003C!-- prettier-ignore-end -->\n\n\u003Csub>Construído com ❤️ para a comunidade de desenvolvimento assistido por IA\u003C\u002Fsub>\n\n---\n\n**[⬆ Voltar ao topo](#aiox-squad-artificial-intelligence-orchestration-experience)**\n","# AIOX Squad：人工智能编排体验 (Artificial Intelligence Orchestration eXperience)\n\n> 🌍 [English](README.en.md) | **[Português](README.md)**\n\n[![NPM 版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Faiox-core.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faiox-core)\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![Node.js 版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-brightgreen.svg)](https:\u002F\u002Fnodejs.org\u002F)\n[![CI](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Factions\u002Fworkflows\u002Fci.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002FSynkraAI\u002Faiox-core\u002Fbranch\u002Fmain\u002Fgraph\u002Fbadge.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002FSynkraAI\u002Faiox-core)\n[![文档](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocs-available-orange.svg)](https:\u002F\u002Faioxsquad.ai)\n[![开源](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen%20Source-Yes-success.svg)](LICENSE)\n[![欢迎贡献](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcontributions-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![行为准则](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode%20of%20conduct-Contributor%20Covenant-blue.svg)](CODE_OF_CONDUCT.md)\n\n> 🌐 README 语言选择：[EN](docs\u002FREADME.md) | [PT](docs\u002Fpt\u002FREADME.md) | [ES](docs\u002Fes\u002FREADME.md) | [ZH](docs\u002Fzh\u002FREADME.md)\n>\n> **将创造的力量归还给人类** —— 开源 AI 编排框架，赋予敢于构建者控制权。专用智能体、工作流和面向任何领域的 CLI First 体验。\n\n## 快速开始（10 分钟）\n\n如果是第一次使用 AIOX，请遵循此线性路径：\n\n1. 在新项目或现有项目中安装：\n```bash\n# 新项目\nnpx aiox-core init meu-projeto\n\n# 现有项目\ncd seu-projeto\nnpx aiox-core install\n```\n2. 选择您的 IDE\u002FCLI 和激活路径：\n- Claude Code: `\u002Fagent-name`\n- Gemini CLI: `\u002Faiox-menu` → `\u002Faiox-\u003Cagent>`\n- Codex CLI: `\u002Fskills` → `aiox-\u003Cagent-id>`\n- Cursor\u002FCopilot\u002FAntiGravity: 遵循 `docs\u002Fide-integration.md` 中的限制和变通方案\n3. 激活 1 个智能体并确认问候语。\n4. 运行 1 个初始命令 (`*help` 或等效命令) 以验证首要价值。\n\n首要价值 (first-value) 定义（二元）：智能体激活 + 有效问候 + \u003C= 10 分钟内输出有用的初始命令。\n\n\n## IDE 钩子兼容性（AIOX 现状 4.2）\n\nAIOX 的许多高级功能依赖于生命周期事件（Hooks）。下表显示了 IDE\u002F平台之间的实际对等性：\n\n| IDE\u002FCLI | 与 Claude 的钩子对等性 | 实际影响 |\n| --- | --- | --- |\n| Claude Code | 完整（参考标准） | 上下文、护栏和审计的最大自动化 |\n| Gemini CLI | 高（原生事件） | 强大的预\u002F后工具及会话自动化覆盖 |\n| Codex CLI | 部分\u002F受限 | 部分自动化取决于 `AGENTS.md`、`\u002Fskills`、MCP 和工作流 |\n| Cursor | 无等效生命周期钩子 | 预\u002F后工具自动化较少；专注于规则、MCP 和智能体流程 |\n| GitHub Copilot | 无等效生命周期钩子 | 会话\u002F工具自动化较少；专注于 VS Code 中的仓库指令 + MCP |\n| AntiGravity | 基于工作流（非钩子） | 通过工作流集成，而非等同于 Claude 的钩子事件 |\n\n详细影响和缓解措施：`docs\u002Fide-integration.md`。\n\n## 概述\n\n### 架构前提：CLI First\n\nAIOX 遵循清晰的优先级层次结构：\n\n```\nCLI First → 可观测性第二 → UI 第三\n```\n\n| 层级            | 优先级 | 重点                                                                          | 示例                                     |\n| ----------------- | ---------- | ----------------------------------------------------------------------------- | -------------------------------------------- |\n| **CLI**           | 最高       | 智能体所在之处。所有执行、决策和自动化均在此发生。                            | 智能体 (`@dev`, `@qa`)、工作流、命令         |\n| **可观测性**      | 次要       | 实时观察和监控 CLI 中发生的事情。                                             | SSE 仪表盘、日志、指标、时间线               |\n| **UI**            | 第三       | 按需进行特定管理和可视化。                                                    | Kanban、设置、故事管理                       |\n\n**衍生原则：**\n\n- CLI 是真理来源——仪表盘仅用于观察\n- 新功能必须先通过 CLI 实现 100% 功能，然后才拥有 UI\n- UI 永远不应成为系统运行的必要条件\n- 可观测性旨在理解 CLI 在做什么，而不是控制它\n\n---\n\n**AIOX 的两大关键创新：**\n\n**1. 智能体规划 (Agentic Planning)：** 专用智能体（分析师、产品经理、架构师）与您协作创建详细且一致的产品需求文档 (PRD) 和架构文档。通过先进的提示工程和人与回路 (human-in-the-loop) 优化，这些规划智能体生成的规范远超通用的 AI 任务生成。\n\n**2. 工程化情境开发 (Contextualized Engineering Development)：** 随后，Scrum Master (sm) 智能体将这些详细计划转化为超详细的开发故事，其中包含开发人员智能体所需的一切——完整的上下文、实施细节以及直接嵌入故事文件中的架构指导。\n\n这种两阶段方法消除了**规划不一致**和**上下文丢失**——这是 AI 辅助开发中最大的两个问题。您的开发智能体打开一个故事文件时，便完全理解要构建什么、如何构建以及为什么构建。\n\n**📖 [在用户指南中查看完整工作流程](docs\u002Fguides\u002Fuser-guide.md)** - 规划阶段、开发生命周期及所有智能体角色\n\n## 前置要求\n\n- Node.js >=18.0.0 (推荐 v20+)\n- npm >=9.0.0\n- GitHub CLI (可选，团队协作需要)\n\n> **安装遇到问题？** 请参阅 [故障排除指南](docs\u002Fguides\u002Finstallation-troubleshooting.md)\n\n**特定平台指南：**\n\n- 📖 [macOS 安装指南](docs\u002Finstallation\u002Fmacos.md)\n- 📖 [Windows 安装指南](docs\u002Finstallation\u002Fwindows.md)\n- 📖 [Linux 安装指南](docs\u002Finstallation\u002Flinux.md)\n\n**多语言文档可用：** [English](docs\u002FREADME.md) | [Português](docs\u002Fpt\u002FREADME.md) | [Español](docs\u002Fes\u002FREADME.md) | [中文](docs\u002Fzh\u002FREADME.md)\n\n## 快速导航\n\n### 理解 AIOX 工作流程\n\n**在深入之前，请回顾这些关键的工作流图表，它们解释了 AIOX 如何运作：**\n\n1. **[规划流程（Web 界面）](docs\u002Fguides\u002Fuser-guide.md#the-planning-workflow-web-ui)** - 如何创建 PRD（产品需求文档）和架构文档\n2. **[核心开发周期（IDE）](docs\u002Fguides\u002Fuser-guide.md#the-core-development-cycle-ide)** - SM、Dev 和 QA 智能体如何通过故事文件协作\n\n> ⚠️ **这些图表解释了 AIOX 代理敏捷（Agentic Agile）工作流中 90% 的困惑** - 理解 PRD+ 架构的创建以及 SM\u002FDev\u002FQA 的工作流，以及智能体如何通过故事文件传递笔记是至关重要的 - 这也解释了为什么这**不是** Taskmaster（任务管理工具）或仅仅是一个简单的任务执行器！\n\n### 您想要做什么？\n\n- **[使用全栈 AI 敏捷团队安装并构建软件](#início-rápido)** → 快速开始指南\n- **[学习如何使用 AIOX](docs\u002Fguides\u002Fuser-guide.md)** → 完整用户指南和分步教程\n- **[查看可用 AI 智能体](#agentes-disponíveis)** → 适合您团队的专业角色\n- **[探索非技术用途](#-além-do-desenvolvimento-de-software---squads)** → 创意写作、商业、健康、教育\n- **[创建自己的 AI 智能体](#criando-seu-próprio-squad)** → 为您的领域构建智能体\n- **[浏览现成的小队](docs\u002Fguides\u002Fsquads-overview.md)** → 查看如何创建和使用 AI 智能体团队\n- **[了解架构](docs\u002Farchitecture\u002FARCHITECTURE-INDEX.md)** → 深入技术分析\n- **[报告问题](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues)** → 错误报告和功能请求\n\n## 重要：保持您的 AIOX 安装为最新版本\n\n**轻松保持更新！** 要更新现有的 AIOX 安装：\n\n```bash\nnpx aiox-core@latest install\n```\n\n这将：\n\n- ✅ 自动检测您的现有安装\n- ✅ 仅更新已更改的文件\n- ✅ 为任何自定义修改创建 `.bak` 备份文件\n- ✅ 保留您的项目特定配置\n\n这使得您可以在不丢失自定义设置的情况下受益于最新的改进、错误修复和新智能体！\n\n## 快速开始\n\n### 🚀 通过 NPX 安装（推荐）\n\n**使用单个命令安装 AIOX：**\n\n```bash\n# 使用现代交互式助手创建新项目\nnpx aiox-core init meu-projeto\n\n# 或者安装到现有项目\ncd seu-projeto\nnpx aiox-core install\n\n# 或者使用特定版本\nnpx aiox-core@latest init meu-projeto\n```\n\n### ✨ 现代安装助手\n\nAIOX 现在包含最新的交互式安装体验，灵感源自 Vite 和 Next.js 等现代工具：\n\n**交互式安装程序功能：**\n\n- 🎨 **现代界面**：带有 @clack\u002Fprompts 的彩色视觉提示\n- ✅ **实时验证**：无效输入的即时反馈\n- 🔄 **进度指示器**：长时间操作（文件复制、依赖安装）的加载动画\n- 📦 **多组件选择**：使用直观界面选择要安装的组件\n- ⚙️ **包管理器选择**：在 npm、yarn 或 pnpm 之间选择\n- ⌨️ **支持取消**：随时按 Ctrl+C 或 ESC 优雅退出\n- 📊 **安装摘要**：继续前查看所有配置\n- ⏱️ **耗时追踪**：查看安装耗时多久\n\n**安装程序提供：**\n\n- ✅ 下载 NPM 最新版本\n- ✅ 现代交互式安装助手\n- ✅ IDE 自动配置（Codex CLI、Cursor 或 Claude Code）\n- ✅ 所有 AIOX 智能体和流程的配置\n- ✅ 创建必要的配置文件\n- ✅ 元智能体系统初始化\n- ✅ 系统健康检查\n- ✅ **跨平台支持**：已在 Windows、macOS 和 Linux 上测试\n\n> **就是这样！** 无需克隆，无需手动配置 - 只需一个命令即可准备就绪，享受现代专业的安装体验。\n\n**前置条件**: [Node.js](https:\u002F\u002Fnodejs.org) v18+ 必需 (v20+ 推荐) | [故障排除](docs\u002Fguides\u002Finstallation-troubleshooting.md)\n\n### 更新现有安装\n\n如果您已经安装了 AIOX：\n\n```bash\nnpx aiox-core@latest install\n# 安装程序将检测您的现有安装并进行更新\n```\n\n### 配置您的 IDE 以进行 AIOX 开发\n\nAIOX 包含预配置的 IDE 规则以提升您的开发体验：\n\n#### 对于 Cursor：\n\n1. 打开 Cursor 设置\n2. 导航至 **User Rules**\n3. 复制 `.cursor\u002Fglobal-rules.md` 的内容\n4. 粘贴到规则部分并保存\n\n#### 对于 Claude Code：\n\n- ✅ 已配置好！`.claude\u002FCLAUDE.md` 文件会自动加载\n- 专用智能体同步：`npm run sync:ide:claude`\n- 专用验证：`npm run validate:claude-sync && npm run validate:claude-integration`\n\n#### 对于 Codex CLI：\n\n- ✅ AIOX 4.2 中的第一类集成（激活流程和共享问候语）\n- ✅ 已配置好！根目录下的 `AGENTS.md` 会自动加载\n- 可选：使用 `npm run sync:ide:codex` 同步辅助智能体\n- 推荐在此仓库中：使用 `npm run sync:skills:codex` 生成和本地化技能版本\n- 仅在项目外使用 `npm run sync:skills:codex:global`（以避免 `\u002Fskills` 重复）\n- 专用验证：`npm run validate:codex-sync && npm run validate:codex-integration`\n- 技能\u002F路径护栏：`npm run validate:codex-skills && npm run validate:paths`\n\n#### 对于 Gemini CLI：\n\n- ✅ 规则和智能体可通过 `npm run sync:ide:gemini` 同步\n- 生成的文件位于 `.gemini\u002Frules.md`、`.gemini\u002Frules\u002FAIOX\u002Fagents\u002F` 和 `.gemini\u002Fcommands\u002F*.toml`\n- ✅ 安装流程中的本地钩子和设置 (`.gemini\u002Fhooks\u002F` + `.gemini\u002Fsettings.json`)\n- ✅ 通过斜杠命令快速激活 (`\u002Faiox-menu`, `\u002Faiox-dev`, `\u002Faiox-architect` 等)\n- 专用验证：`npm run validate:gemini-sync && npm run validate:gemini-integration`\n- 一键实现多 IDE 一致性：`npm run validate:parity`\n\n这些规则提供：\n\n- 🤖 智能体命令识别与集成\n- 📋 基于故事的开发工作流\n- ✅ 复选框自动跟踪\n- 🧪 测试和验证模式\n- 📝 AIOX 特定代码规范\n\n### 通过 Web 界面更快开始（2 分钟）\n\n1. **安装 AIOX**：运行 `npx aiox-core init meu-projeto`\n2. **配置您的 IDE**：遵循 Codex CLI、Cursor 或 Claude Code 的配置说明\n3. **开始规划**：激活如 `@analyst` 的智能体以开始创建您的简报\n4. **使用 AIOX 命令**：输入 `*help` 查看可用命令\n5. **遵循流程**：查看 [用户指南](docs\u002Fguides\u002Fuser-guide.md) 了解更多详情\n\n### CLI 命令参考\n\nAIOX 提供了一个现代化的跨平台 CLI（命令行界面），拥有直观的命令：\n\n```bash\n# Gerenciamento de Projeto (com assistente interativo)\nnpx aiox-core init \u003Cnome-projeto> [opções]\n  --force              Forçar criação em diretório não vazio\n  --skip-install       Pular instalação de dependências npm\n  --template \u003Cnome>    Usar template específico (default, minimal, enterprise)\n\n# Instalação e Configuração (com prompts modernos)\nnpx aiox-core install [opções]\n  --force              Sobrescrever configuração existente\n  --quiet              Saída mínima durante instalação\n  --dry-run            Simular instalação sem modificar arquivos\n\n# Comandos do Sistema\nnpx aiox-core --version   Exibir versão instalada\nnpx aiox-core --help      Exibir ajuda detalhada\nnpx aiox-core info        Exibir informações do sistema\nnpx aiox-core doctor      Executar diagnósticos do sistema\nnpx aiox-core doctor --fix Corrigir problemas detectados automaticamente\n\n# Manutenção\nnpx aiox-core update      Atualizar para versão mais recente\nnpx aiox-core uninstall   Remover AIOX\n```\n\n**CLI 功能：**\n\n- ✅ **全面的帮助系统**：在任何命令中使用 `--help` 显示详细文档\n- ✅ **输入验证**：对无效参数提供即时反馈\n- ✅ **彩色消息**：错误显示为红色，成功显示为绿色，警告显示为黄色\n- ✅ **跨平台**：在 Windows、macOS 和 Linux 上完美运行\n- ✅ **支持 Dry-Run（模拟运行）**：在不修改文件的情况下测试安装\n\n### 💡 使用示例\n\n#### 完整交互式安装\n\n```bash\n$ npx aiox-core install\n\n🚀 AIOX Installation\n\n◆ What is your project name?\n│  my-awesome-project\n│\n◇ Which directory should we use?\n│  .\u002Fmy-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#### 静默安装 (CI\u002FCD)\n\n```bash\n# Instalação automatizada sem prompts\n$ npx aiox-core install --quiet --force\n✔ AIOX installed successfully\n```\n\n#### 安装模拟 (Dry-Run)\n\n```bash\n# Testar instalação sem modificar arquivos\n$ npx aiox-core install --dry-run\n\n[DRY RUN] Would create: .\u002Fmy-project\u002F\n[DRY RUN] Would copy: .aiox-core\u002F (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#### 系统诊断\n\n```bash\n$ npx aiox-core doctor\n\n🏥 AIOX System Diagnostics\n\n✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)\n✔ npm version: 10.2.3\n✔ Git installed: version 2.43.0\n✔ GitHub CLI: gh 2.40.1\n✔ AIOX: v4.2.11\n\nConfiguration:\n✔ .aiox-core\u002F directory exists\n✔ Agent files: 11 found\n✔ Workflow files: 8 found\n✔ Templates: 15 found\n\nDependencies:\n✔ @clack\u002Fprompts: ^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#### 获取帮助\n\n```bash\n$ npx aiox-core --help\n\nUsage: aiox-core [options] [command]\n\nAIOX: 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>          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> --help' for detailed information about each command.\n```\n\n### 替代方案：克隆并构建\n\n对于想要修改源代码的贡献者或高级用户：\n\n```bash\n# Clonar o repositório\ngit clone https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core.git\ncd aiox-core\n\n# Instalar dependências\nnpm install\n\n# Executar o instalador\nnpm run install:aiox\n```\n\n### 团队快速配置\n\n对于加入项目的团队成员：\n\n```bash\n# Instalar AIOX no projeto\nnpx aiox-core@latest install\n\n# Isto vai:\n# 1. Detectar instalação existente (se houver)\n# 2. Instalar\u002Fatualizar framework AIOX\n# 3. Configurar agentes e workflows\n```\n\n## 🌟 超越软件开发 - Squads\n\nAIOX 的自然语言框架适用于任何领域。Squads（小队）提供专门的 AI 智能体用于创意写作、商业策略、健康与福祉、教育等更多领域。此外，Squads 可以为 AIOX 核心扩展特定领域的功能，这些功能并非通用型。[查看 Squads 指南](docs\u002Fguides\u002Fsquads-guide.md) 并学习如何创建您自己的！\n\n## 可用智能体\n\nAIOX 自带 12 个专用智能体：\n\n### 元智能体\n\n- **aiox-master** - 编排主智能体（包含框架开发能力）\n- **aiox-orchestrator** - 工作流编排器和团队协调器\n\n### 规划智能体 (Web 界面)\n\n- **analyst** - 业务分析和 PRD（产品需求文档）创建专家\n- **pm** (Product Manager) - 产品经理和优先级管理\n- **architect** - 系统架构师和技术设计\n- **ux-expert** - 用户体验设计和可用性\n\n### 开发智能体 (IDE)\n\n- **sm** (Scrum Master) - 冲刺管理和故事创建\n- **dev** - 开发和实现\n- **qa** - 质量保证和测试\n- **po** (Product Owner) - 待办事项列表管理和故事管理\n- **data-engineer** - 数据库设计和数据建模\n- **devops** - CI\u002FCD、基础设施和 git 操作（唯一推送权限）\n\n## 文档与资源\n\n### 核心指南\n\n- 📖 **[用户指南](docs\u002Fguides\u002Fuser-guide.md)** - 从项目构思到完成的完整分步指南\n- 🏗️ **[主要架构](docs\u002Farchitecture\u002FAIOX-VISUAL-OVERVIEW.md)** - 深入的技术探索和系统设计\n- 🚀 **[Squads 指南](docs\u002Fguides\u002Fsquads-guide.md)** - 将 AIOX 扩展到软件开发以外的任何领域\n\n### 附加文档\n\n- 🤖 **[Squads 指南](docs\u002Fguides\u002Fsquads-guide.md)** - 创建并发布 AI 智能体团队\n- 📋 **[入门指南](docs\u002Fgetting-started.md)** - 初学者分步教程\n- 🔧 **[故障排除](docs\u002Ftroubleshooting.md)** - 常见问题解决方案\n- 🎯 **[指导原则](docs\u002FGUIDING-PRINCIPLES.md)** - AIOX 的理念与最佳实践\n- 🏛️ **[架构概览](docs\u002Farchitecture\u002FAIOX-VISUAL-OVERVIEW.md)** - 系统架构的详细视图\n- ⚙️ **[性能调整指南](docs\u002Fperformance-tuning-guide.md)** - 优化您的 AIOX 工作流程\n- 🔒 **[安全最佳实践](docs\u002Fsecurity-best-practices.md)** - 数据安全与保护\n- 🔄 **[迁移指南](docs\u002Fmigration-guide.md)** - 从旧版本迁移\n- 📦 **[版本与发布](docs\u002Fversioning-and-releases.md)** - 版本政策\n\n## 🤖 AIOX 自主开发引擎 (ADE)\n\nAIOX 引入了 **自主开发引擎 (Autonomous Development Engine, ADE)** —— 一个完整的自主开发系统，可将需求转化为功能代码。\n\n### 🎯 ADE 是什么？\n\nADE 是一组 **7 个史诗 (Epics)**，支持开发的自主执行：\n\n| Epic  | 名称             | 描述                                  |\n| ----- | ---------------- | ------------------------------------------ |\n| **1** | Worktree Manager | 通过 Git worktrees 隔离分支   |\n| **2** | Migration V2→V3  | 迁移至 autoClaude V3 格式        |\n| **3** | Spec Pipeline    | 将需求转换为可执行的规范 |\n| **4** | Execution Engine | 执行规范，包含 13 个步骤 + 自我批判 |\n| **5** | Recovery System  | 自动故障恢复           |\n| **6** | QA Evolution     | 结构化审查，共 10 个阶段             |\n| **7** | Memory Layer     | 持久化模式与洞察的记忆层  |\n\n### 🔄 主流程\n\n```\nUser Request → Spec Pipeline → Execution Engine → QA Review → Working Code\n                                      ↓\n                              Recovery System\n                                      ↓\n                               Memory Layer\n```\n\n### ⚡ ADE 快速开始\n\n```bash\n# 1. Criar spec a partir de requisito\n@pm *gather-requirements\n@architect *assess-complexity\n@analyst *research-deps\n@pm *write-spec\n@qa *critique-spec\n\n# 2. Executar spec aprovada\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 文档\n\n- **[ADE 完整指南](docs\u002Fguides\u002Fade-guide.md)** - 分步教程\n- **[代理变更](docs\u002Farchitecture\u002FADE-AGENT-CHANGES.md)** - 各代理的命令和能力\n- **[史诗 1 - Worktree Manager](docs\u002Farchitecture\u002FADE-EPIC1-HANDOFF.md)**\n- **[史诗 2 - Migration V2→V3](docs\u002Farchitecture\u002FADE-EPIC2-HANDOFF.md)**\n- **[史诗 3 - Spec Pipeline](docs\u002Farchitecture\u002FADE-EPIC3-HANDOFF.md)**\n- **[史诗 4 - Execution Engine](docs\u002Farchitecture\u002FADE-EPIC4-HANDOFF.md)**\n- **[史诗 5 - Recovery System](docs\u002Farchitecture\u002FADE-EPIC5-HANDOFF.md)**\n- **[史诗 6 - QA Evolution](docs\u002Farchitecture\u002FADE-EPIC6-HANDOFF.md)**\n- **[史诗 7 - Memory Layer](docs\u002Farchitecture\u002FADE-EPIC7-HANDOFF.md)**\n\n### 🆕 各代理的新命令\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## 创建您自己的 Squad\n\nSquads 允许将 AIOX 扩展到任何领域。基本结构如下：\n\n```\nsquads\u002Fseu-squad\u002F\n├── config.yaml           # Configuração do squad\n├── agents\u002F              # Agentes especializados\n├── tasks\u002F               # Fluxos de trabalho de tarefas\n├── templates\u002F           # Templates de documentos\n├── checklists\u002F          # Checklists de validação\n├── data\u002F                # Base de conhecimento\n├── README.md            # Documentação do squad\n└── user-guide.md        # Guia do usuário\n```\n\n查看 [Squads 指南](docs\u002Fguides\u002Fsquads-guide.md) 以获取详细说明。\n\n## 可用 Squads\n\nSquads 是模块化 AI 智能体团队。查看 [Squads 概览](docs\u002Fguides\u002Fsquads-overview.md) 以获取更多信息。\n\n### 外部 Squads\n\n- **[hybrid-ops](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-hybrid-ops-pedro-valerio)** - 人机混合操作（独立仓库）\n\n## AIOX Pro\n\n**AIOX Pro** (`@aiox-fullstack\u002Fpro`) 是 AIOX 的高级模块，为大型团队和项目提供高级功能。\n\n> **限制可用性：** AIOX Pro 仅对 **AIOX Cohort Advanced** 成员开放。[了解更多关于该计划](https:\u002F\u002Faioxsquad.ai)。\n\n### 安装\n\n```bash\nnpm install @aiox-fullstack\u002Fpro\n```\n\n### 高级功能\n\n- **高级 Squads** - 具有扩展能力的专业 Squads\n- **Memory Layer** - 跨会话的持久化模式与洞察记忆层\n- **指标与分析** - 生产力仪表板与开发指标\n- **企业集成** - Jira、Linear、Notion 等的连接器\n- **分层配置** - 具有继承关系的 L1-L4 配置系统\n- **许可管理** - 通过 `aiox pro activate --key \u003CKEY>` 进行许可证管理\n\n安装后，运行 `npx aiox-core pro --help` 获取更多信息。\n\n## 支持\n\n- 🐛 [问题跟踪器](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues) - Bug 报告和功能请求\n- 💡 [功能流程](docs\u002FFEATURE_PROCESS.md) - 如何提议新功能\n- 📋 [如何贡献](CONTRIBUTING.md)\n- 🗺️ [路线图](docs\u002Froadmap.md) - 了解我们正在构建的内容\n- 🤖 [Squads 指南](docs\u002Fguides\u002Fsquads-guide.md) - 创建 AI 智能体团队\n\n## Git 工作流与验证\n\nAIOX 实施了一个多层验证系统，以确保代码质量和一致性：\n\n### 🛡️ 纵深防御 - 3 层验证\n\n**第 1 层：Pre-commit（本地 - 快速）**\n\n- ✅ ESLint - 代码质量\n- ✅ TypeScript - 类型检查\n- ⚡ 性能：\u003C5 秒\n- 💾 启用缓存\n\n**第 2 层：Pre-push（本地 - 故事验证）**\n\n- ✅ 故事复选框验证\n- ✅ 状态一致性\n- ✅ 必填部分\n\n**第 3 层：CI\u002FCD（云端 - 合并必需）**\n\n- ✅ 所有测试\n- ✅ 测试覆盖率（最低 80%）\n- ✅ 全面验证\n- ✅ GitHub Actions\n\n### 📖 详细文档\n\n- 📋 **[Git 工作流完整指南](docs\u002Fgit-workflow-guide.md)** - 工作流程详细指南\n- 📋 **[CONTRIBUTING.md](CONTRIBUTING.md)** - 贡献指南\n\n### 可用命令\n\n```bash\n# Validações locais\nnpm run lint           # ESLint\nnpm run typecheck      # TypeScript\nnpm test              # Testes\nnpm run test:coverage # Testes com cobertura\n\n# Validador AIOX\nnode .aiox-core\u002Futils\u002Faiox-validator.js pre-commit   # Validação pre-commit\nnode .aiox-core\u002Futils\u002Faiox-validator.js pre-push     # Validação pre-push\nnode .aiox-core\u002Futils\u002Faiox-validator.js stories      # Validar todas stories\n```\n\n### 分支保护\n\n使用以下命令配置 master 分支保护：\n\n```bash\nnode scripts\u002Fsetup-branch-protection.js\n```\n\n需要：\n\n- 已安装并认证 GitHub CLI (gh)\n- 拥有仓库的管理员 (admin) 访问权限\n\n## 贡献\n\n**我们非常期待您的贡献，并欢迎您的想法、改进和 Squads (团队)！** 🎉\n\n要参与贡献：\n\n1. Fork (复制) 仓库\n2. 为您的功能创建分支 (`git checkout -b feature\u002FMinhaNovaFeature`)\n3. 提交您的更改 (`git commit -m 'feat: Adicionar nova feature'`)\n4. 推送到分支 (`git push origin feature\u002FMinhaNovaFeature`)\n5. 打开一个 Pull Request (拉取请求)\n\n另见：\n\n- 📋 [如何贡献 Pull Requests](docs\u002Fhow-to-contribute-with-pull-requests.md)\n- 📋 [Git 工作流指南](docs\u002Fgit-workflow-guide.md)\n\n## 📄 法律条款\n\n| 文档             | 英文版                                     | 葡语版                             |\n| ---------------- | ------------------------------------------- | ------------------------------------- |\n| **许可证**           | [MIT License](LICENSE)                      | -                                     |\n| **许可模式** | [Core vs Pro](docs\u002Flegal\u002Flicense-clarification.md) | -                               |\n| **隐私**       | [Privacy Policy](docs\u002Flegal\u002Fprivacy.md)     | -                                     |\n| **使用条款**     | [Terms of Use](docs\u002Flegal\u002Fterms.md)         | -                                     |\n| **行为准则** | [Code of Conduct](CODE_OF_CONDUCT.md)       | [PT-BR](docs\u002Fpt\u002Fcode-of-conduct.md)   |\n| **贡献**      | [Contributing](CONTRIBUTING.md)             | [PT-BR](docs\u002Fpt\u002Fcontributing.md)      |\n| **安全**         | [Security](docs\u002Fsecurity.md)                | [PT-BR](docs\u002Fpt\u002Fsecurity.md)          |\n| **社区**        | [Community](docs\u002Fcommunity.md)              | [PT-BR](docs\u002Fpt\u002Fcommunity.md)         |\n| **路线图**           | [Roadmap](docs\u002Froadmap.md)                  | [PT-BR](docs\u002Fpt\u002Froadmap.md)           |\n| **更新日志**         | [Version History](CHANGELOG.md)             | -                                     |\n\n## 贡献者\n\n[![贡献者](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSynkraAI_aiox-core_readme_a9b64057b611.png)](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fgraphs\u002Fcontributors)\n\n### 🌟 社区贡献者\n\n\u003C!-- prettier-ignore-start -->\n\u003C!-- Manually maintained — add new community contributors here -->\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnikolasdehor\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSynkraAI_aiox-core_readme_064dcccdcd01.png\" width=\"100px;\" alt=\"Nikolas de Hor\"\u002F>\u003Cbr \u002F>\u003Csub>\u003Cb>Nikolas de Hor\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003Cbr \u002F>💻🐛⚠️👀\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003C!-- prettier-ignore-end -->\n\n\u003Csub>用 ❤️ 为人工智能辅助开发社区构建\u003C\u002Fsub>\n\n---\n\n**[⬆ 返回顶部](#aiox-squad-artificial-intelligence-orchestration-experience)**","# AIOX Core 快速上手指南\n\n**AIOX Squad** 是一个开源的 AI 编排框架（Artificial Intelligence Orchestration eXperience），旨在将控制权交还给构建者。它采用 **CLI First**（命令行优先）架构，支持专用智能体、工作流及跨平台集成。\n\n## 1. 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n- **Node.js**: >= 18.0.0 (推荐 v20+)\n- **npm**: >= 9.0.0\n- **GitHub CLI**: 可选（用于团队协作功能）\n\n> **注意**: 如遇安装问题，请参考官方提供的 [安装故障排除指南](docs\u002Fguides\u002Finstallation-troubleshooting.md)。\n\n## 2. 安装步骤\n\nAIOX 提供了现代化的交互式安装体验，无需手动克隆仓库。\n\n### 创建新项目\n```bash\nnpx aiox-core init meu-projeto\n```\n\n### 添加到现有项目\n```bash\ncd seu-projeto\nnpx aiox-core install\n```\n\n### 更新现有安装\n保持工具为最新版本，同时保留自定义配置：\n```bash\nnpx aiox-core@latest install\n```\n\n**安装特性：**\n- 自动检测现有安装并仅更新变更文件。\n- 支持 npm、yarn 或 pnpm 包管理器选择。\n- 自动生成必要的配置文件和智能体元系统。\n\n## 3. 基本使用\n\nAIOX 遵循 **CLI First → 可观测性第二 → UI 第三** 的优先级原则。核心操作均通过命令行完成。\n\n### 配置 IDE\n根据您使用的编辑器，进行相应的规则配置以启用智能体功能：\n\n- **Cursor**: 打开设置，进入 **User Rules**，将 `.cursor\u002Fglobal-rules.md` 内容粘贴至规则区域并保存。\n- **Claude Code**: 已预配置，自动加载 `.claude\u002FCLAUDE.md`。\n- **Codex CLI**: 自动加载根目录下的 `AGENTS.md`。\n\n### 激活智能体\n1. 选择一种 IDE\u002FCLI 路径激活智能体（例如）：\n   - Claude Code: `\u002Fagent-name`\n   - Gemini CLI: `\u002Faiox-menu` → `\u002Faiox-\u003Cagent>`\n   - Codex CLI: `\u002Fskills` → `aiox-\u003Cagent-id>`\n2. 激活后，确认收到有效的欢迎问候（Greeting）。\n3. 运行初始命令（如 `*help`）验证基础功能是否正常工作。\n\n### 核心工作流\nAIOX 的核心价值在于两阶段开发模式：\n1. **规划阶段**: 由规划类智能体（Analyst, PM, Architect）协作生成详细的 PRD 和架构文档。\n2. **开发阶段**: Scrum Master (SM) 智能体将计划转化为包含完整上下文的历史记录文件，供 Dev 智能体执行。\n\n更多详细的工作流说明，请参阅 [用户指南](docs\u002Fguides\u002Fuser-guide.md)。","某全栈开发团队正在紧急重构一个遗留的电商订单系统，面临多模块协作与高质量交付的双重压力。\n\n### 没有 aiox-core 时\n- 开发者需要在不同编辑器、终端和文档间频繁切换，手动传递上下文导致沟通成本高昂且易出错\n- 代码风格和质量完全依赖个人习惯，缺乏统一的自动化规范约束，导致后期维护困难\n- 遇到构建失败时，排查原因耗时较长，无法实时追踪 AI 辅助生成的中间状态与逻辑链条\n- 团队协作时，新人上手慢，难以复现复杂的开发工作流，重复造轮子现象严重\n\n### 使用 aiox-core 后\n- 通过 CLI 直接调用 @dev 或 @qa 智能体，自动完成代码生成与测试脚本编写，减少人工干预\n- 内置的 Hooks 机制在 IDE 中自动执行预检规则，确保每次输出都符合项目统一标准\n- 实时观察 CLI 执行日志，快速定位 AI 决策过程中的异常环节，大幅缩短调试周期\n- 标准化的 Workflow 模板让团队成员能一键复用成熟的开发路径，实现经验资产化\n\naiox-core 将分散的开发环节整合为自动化流水线，显著提升了全栈交付效率与代码一致性。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSynkraAI_aiox-core_e9d859b9.png","SynkraAI","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FSynkraAI_eee52644.png",null,"https:\u002F\u002Fgithub.com\u002FSynkraAI",[80,84,88,92,96,100,104,108,112,115],{"name":81,"color":82,"percentage":83},"JavaScript","#f1e05a",96,{"name":85,"color":86,"percentage":87},"Python","#3572A5",1.2,{"name":89,"color":90,"percentage":91},"Shell","#89e051",1.1,{"name":93,"color":94,"percentage":95},"Handlebars","#f7931e",0.6,{"name":97,"color":98,"percentage":99},"PLpgSQL","#336790",0.4,{"name":101,"color":102,"percentage":103},"CSS","#663399",0.3,{"name":105,"color":106,"percentage":107},"PowerShell","#012456",0.2,{"name":109,"color":110,"percentage":111},"HTML","#e34c26",0.1,{"name":113,"color":114,"percentage":111},"Batchfile","#C1F12E",{"name":116,"color":117,"percentage":118},"Go Template","#00ADD8",0,2591,855,"2026-04-05T11:02:29","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":126,"python":124,"dependencies":127},"该工具为基于 Node.js 的 AI 编排框架（Orchestration），而非本地大模型推理工具。核心功能依赖于外部 AI 服务（如 Claude、Gemini 等）或 IDE 集成。安装过程支持交互式向导，需确保网络通畅以连接相关服务。无本地 GPU 需求，内存消耗取决于并发任务及所调用的 API 服务。推荐使用 v20+ 的 Node.js 版本以获得最佳体验。",[128,129,130,131],"Node.js >=18.0.0","npm >=9.0.0","GitHub CLI (可选)","@clack\u002Fprompts",[15,53,14,13],[134,135,136,137,138,139,140,141,142,143,144,145],"agents","ai","cli","development","fullstack","orchestration","typescript","ai-agents","automation","claude","framework","nodejs","2026-03-27T02:49:30.150509","2026-04-06T06:45:24.302400",[149,154,158,162,167,171],{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},3029,"为什么使用 `@synkra\u002Faios-core` 会提示包未找到？","官方发布的 npm 包是无作用域名称 `aios-core`，而非 `@synkra\u002Faios-core`。请使用 `npx aios-core install` 或 `npx aios-core init my-project`。代码库中约 120 个文件已修正此引用。","https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues\u002F159",{"id":155,"question_zh":156,"answer_zh":157,"source_url":153},3030,"npm 上有哪些可用的版本标签（dist-tags）？","目前仅有 `latest` (4.0.4) 和 `preview` (4.0.2)。文档中提到的 `rc` 标签不存在，请勿尝试安装 `@rc` 版本。",{"id":159,"question_zh":160,"answer_zh":161,"source_url":153},3031,"运行 `aios-core update` 时报错或无法检查版本怎么办？","这是由于旧版代码中硬编码了错误的包名引用导致的。该问题已在 PR #186 中修复，更新了注册表 URL 并增加了空值保护（null guard）。请确保更新到最新版本的 CLI。",{"id":163,"question_zh":164,"answer_zh":165,"source_url":166},3032,"当前系统是否支持多智能体并行执行？","是的，运行时并行执行已完全实现（见 PR #40）。核心组件包括 `WorkflowOrchestrator`、`ParallelExecutor` 和 `WaveExecutor`，默认最大并行数为 4。","https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues\u002F42",{"id":168,"question_zh":169,"answer_zh":170,"source_url":166},3033,"如何在史诗（Epic）规划阶段优化并行容量？","原定的“依赖分析器”功能已暂时搁置，现由史诗编排系统（`*execute-epic`）替代。新的工作流通过基于波浪（wave-based）的执行计划来管理并行容量，无需手动在故事模板中添加元数据。",{"id":172,"question_zh":173,"answer_zh":174,"source_url":166},3034,"如何获取关于并行规划集成的故事模板（WIS-5a）？","故事 WIS-5a（Parallel Planning Integration）已准备好开发。文件位于 `docs\u002Fstories\u002Fv2.1\u002Fsprint-9\u002Fstory-wis-5a-parallel-planning-integration.md`。",[176,181,186,191,196,201,206,211,216,221,226,231,236,241,246,251,256,261,266,271],{"id":177,"version":178,"summary_zh":179,"released_at":180},102559,"v4.4.2","## 📋 What's New in v4.4.2\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-24T16:50:41",{"id":182,"version":183,"summary_zh":184,"released_at":185},102560,"v4.4.1","## 📋 What's New in v4.4.1\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-24T15:36:31",{"id":187,"version":188,"summary_zh":189,"released_at":190},102561,"v4.4.0","## 📋 What's New in v4.4.0\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-24T15:10:30",{"id":192,"version":193,"summary_zh":194,"released_at":195},102562,"v4.3.0","# Release v4.3.0\n\n**Date:** 2026-02-24\n**Commits:** 90 (52 feat, 7 fix, 16 docs, 12 chore, 1 refactor, 1 test)\n**Breaking Changes:** None\n\n---\n\n## Highlights\n\nv4.3.0 delivers **5 completed epics** spanning code intelligence, token optimization, installation health, boundary mapping, and CLI visualization. This is the largest feature release since v4.0.0.\n\n---\n\n## Epic: NOGIC — Code Intelligence (25 stories)\n\nThe NOGIC epic brings native code intelligence to every AIOS agent, enabling codebase-aware decisions without external tools.\n\n### Key Features\n- **RegistryProvider** — Native T1 code intelligence provider for entity resolution\n- **SYNAPSE native-first migration** — UAP streamlined, layers L3-L7 disabled for performance\n- **Agent-specific enhancements:**\n  - QA gate with blast radius analysis and coverage tracking (NOG-4)\n  - Planning helper for brownfield and PRD workflows (NOG-5)\n  - Story creation awareness with duplicate detection (NOG-6)\n  - DevOps pre-push impact analysis and PR enrichment (NOG-7)\n  - Squad creator codebase awareness (NOG-8)\n- **Pipeline infrastructure:**\n  - Session wiring, token estimation, git detection (NOG-10)\n  - Token usage source discovery research (NOG-11)\n  - SYNAPSE atomic writes and session cleanup (NOG-12)\n  - Git fsmonitor detection with opt-in suggestion (NOG-13)\n  - ADR: memory self-editing security model (NOG-14)\n  - Dependency classification and entity lifecycle (NOG-16B)\n  - Graph filtering, focus mode, lifecycle styling (NOG-16C)\n  - E2E pipeline audit with QA pass (NOG-17)\n  - Native-first migration: UAP streamlined, agent memory (NOG-18)\n  - Agent frontmatter validation: hooks, skills, memory sync (NOG-20)\n  - Native greeting migration: replace UAP\u002FGreetingBuilder (NOG-21)\n  - Checklist-runner expansion to all 8 agents (NOG-22)\n  - Post-migration validation and benchmark: QA PASS 100\u002F100 (NOG-23)\n\n---\n\n## Epic: TOK — Token Optimization (7 stories)\n\nSystematic reduction of token consumption across all agent sessions.\n\n### Key Features\n- **Unified tool registry** — 34 tools, 10 profiles, 5 bindings with 3-tier mesh (TOK-1)\n- **Baseline metrics** — Quantified token usage per agent and session type (TOK-1.5)\n- **Capability-aware deferred loading** — 3-level fallback for tool resolution (TOK-2)\n- **PTC batch templates** — execution_mode schema, 21-task inventory (TOK-3)\n- **Agent handoff context compaction** — 65% reduction in SDC transitions (TOK-4A)\n- **Input examples registry** — Client-layer injection for top-10 tools, +18pp accuracy (TOK-4B)\n- **Tool usage analytics** — Promote\u002Fdemote engine with usage tracking (TOK-5)\n- **Dynamic filtering engine** — 3 filter types with SYNAPSE rule integration (TOK-6)\n\n---\n\n## Epic: INS-4 — Installation Health (9 stories, 33 points)\n\nComplete diagnostic and configuration system for AIOS installations.\n\n### Key Features\n- **`aios doctor`** — 15 modular checks with `--fix`, `--json`, `--dry-run` flags (INS-4.1)\n- **Settings.json generator** — Deterministic generation from core-config boundary rules (INS-4.2)\n- **Artifact copy pipeline** — Skills, commands, hooks, generator wiring (INS-4.3)\n- **CLAUDE.md template v5** — 4 new AIOS-managed sections (INS-4.4)\n- **IDE sync integration** — Adapter pattern after artifact copy (INS-4.5)\n- **Entity registry bootstrap** — Auto-population on install (INS-4.6)\n- **YAML merger strategy** — Config smart merge Phase 1 (INS-4.7)\n- **Health-check task** — 3 new checks (skills, commands, hooks) + `*health-check` command (INS-4.8)\n- **Publish safety gate** — Submodule + file count validation (INS-4.10)\n\n---\n\n## Epic: BM — Boundary Mapping (6 stories)\n\nFramework vs project boundary enforcement with deterministic rules.\n\n### Key Features\n- **Permission deny rules** — Toggleable framework protection L1-L4 (BM-1)\n- **CLAUDE.md boundary section** — Framework vs project ownership annotations (BM-2)\n- **Pre-commit framework guard** — Dynamic config-driven protection (BM-3)\n- **Config schema enrichment** — Template customization surface (BM-4)\n- **Entity registry layer classification** — L1-L4 layer assignment (BM-5)\n- **Agent memory lifecycle** — CLAUDE.md ownership annotations (BM-6)\n\n---\n\n## Epic: GD — CLI Graph Dashboard (15 stories)\n\nInteractive ASCII and HTML visualization of the AIOS entity graph.\n\n### Key Features\n- **CLI Graph Dashboard MVP** — Entity stats and cache metrics ASCII view (GD-1, GD-2)\n- **Provider status** — Output formats for graph data (GD-3)\n- **Live DOT watch mode** — Real-time graph updates (GD-4)\n- **HTML web viewer** — vis-network interactive visualization (GD-5)\n- **Tooltip redesign** — Physics control panel (GD-10, GD-11)\n- **Multi-level depth expansion** — BFS neighborhood exploration (GD-12)\n- **Node sizing** — Degree centrality and layout switching (GD-13)\n- **Export** — PNG\u002FJSON export and minimap navigation (GD-14)\n- **Category clustering** — Statistics panel (GD-15)\n\n---\n\n## Other Notable Changes\n\n### Features\n- **GitHub Issues management** — Triage and resolve ta","2026-02-24T01:28:22",{"id":197,"version":198,"summary_zh":199,"released_at":200},102563,"v4.2.2","## 📋 What's New in v4.2.2\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-16T00:23:39",{"id":202,"version":203,"summary_zh":204,"released_at":205},102564,"v4.2.1","## 📋 What's New in v4.2.1\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-16T00:12:42",{"id":207,"version":208,"summary_zh":209,"released_at":210},102565,"v4.2.0","## 📋 What's New in v4.2.0\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-16T00:04:18",{"id":212,"version":213,"summary_zh":214,"released_at":215},102566,"v4.1.0","## 📋 What's New in v4.1.0\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-15T20:39:53",{"id":217,"version":218,"summary_zh":219,"released_at":220},102567,"v4.0.4","## 📋 What's New in v4.0.4\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-13T02:41:37",{"id":222,"version":223,"summary_zh":224,"released_at":225},102568,"v4.0.2","## 📋 What's New in v4.0.2\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-13T01:39:24",{"id":227,"version":228,"summary_zh":229,"released_at":230},102569,"v4.0.1","## What's Fixed\n\nThis release resolves **8 critical bugs** in the v4.0.0 installer that affected ALL users (open-source + pro).\n\n### Phase 1 — Agent Activation (Critical Path)\n- **BUG-1:** Graceful degradation for `pro-detector` import — agents now activate without pro installed\n- **BUG-2:** Added missing runtime dependencies (`execa`) + `npm install` step in installer\n- **BUG-3:** `.claude\u002Fhooks\u002F` directory now copied during install (SYNAPSE hook functional)\n- **BUG-4:** `.claude\u002Fsettings.local.json` created with correct nested hook format\n\n### Phase 2 — Installer Robustness\n- **BUG-5:** Fixed \"Source and destination must not be the same\" error for tech presets in framework-dev mode\n\n### Phase 3 — Pro Integration\n- **BUG-6:** Dynamic `resolveLicensePath()` with 3-tier fallback (framework → npm → cwd)\n- **BUG-7:** Bare module pattern matching — `\"pro\"` now matches `\"pro.squads.premium\"` etc.\n- **BUG-8:** `feature-registry.yaml` added to npm distribution files\n\n### Quality\n- All CI checks passing (ESLint, TypeScript, Jest Node 18\u002F20, CodeQL, SYNAPSE benchmarks)\n- CodeRabbit review: **Approved**\n- QA gate: **PASS**\n- 5722 tests passing, 0 regressions\n\n### Version Bumps\n| Package | From | To |\n|---------|------|----|\n| `aios-core` | 4.0.0 | **4.0.1** |\n| `@aios\u002Finstaller` | 3.2.0 | **3.2.1** |\n| `@aios-fullstack\u002Fcore` | 4.31.0 | **4.31.1** |\n| `@aios-fullstack\u002Fpro` | 0.1.0 | **0.1.1** |\n\n### Upgrade\n```bash\nnpx aios-core@4.0.1 install\n```\n\n**Full Changelog:** https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcompare\u002Fv4.0.0...v4.0.1","2026-02-13T01:15:42",{"id":232,"version":233,"summary_zh":234,"released_at":235},102570,"v4.0.0","## [4.0.0](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcompare\u002Fv3.11.0...v4.0.0) (2026-02-11)\n\n### ⚠ BREAKING CHANGES\n\n* **agents:** Trae IDE is no longer supported.\n\n- Remove .trae\u002F directory and all agent files\n- Remove trae transformer from IDE sync\n- Remove trae from core-config.yaml targets\n- Remove trae documentation files (platforms\u002Ftrae.md)\n- Remove trae-rules template\n- Update package.json scripts\n- Update .gitignore\n- Fix markdown table formatting in command-authority-matrix.md\n\nCo-Authored-By: Claude (claude-opus-4-5-alan) \u003Cnoreply@anthropic.com>\n\n### Features\n\n* add update-aios command for framework synchronization ([#77](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F77)) ([8d06d20](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F8d06d20b6c50983a7e082b36d548154760f73b82))\n* add workflow runtime engine — real subagent spawning via Task tool ([672e1eb](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F672e1eb02e12648cbecb27fe564928478002a3f4))\n* add workflow runtime engine — real subagent spawning via Task tool ([#67](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F67)) ([d9cf8fd](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fd9cf8fd8462be40b69df0a872e0287fcd2d114d0))\n* **ade:** AIOS Dashboard & ADE Core Implementation ([#51](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F51)) ([30cec6b](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F30cec6b89f582416c2e2a06dd196ebf28c2e7aad))\n* **agents:** Agent Foundation Refactor - Epics 1-3 Implementation ([#69](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F69)) ([af6eceb](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Faf6eceb474d6485952767fd6ee617f1230dfc0d5))\n* **aios-dashboard:** AIOS Dashboard & ADE Implementation ([#53](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F53)) ([b0a3b79](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fb0a3b7917223473d7f23107209c781f85e79aa71)), closes [#51](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F51) [#1](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F1) [#3](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F3)\n* **architect:** add validate-tech-preset command ([e03f507](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fe03f507e7aba01d0ef5e4d746424db464f2e0da9)), closes [#64](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F64)\n* **cli:** add detailed version info with --detailed flag [Story 7.2] ([e95093b](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fe95093b50db024f854bd732fb5e6e725142c409f))\n* **cli:** add options support to runWizard function ([be1ce32](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fbe1ce3231c3ee79ad8b1145aa6e7c1ee183d7fe1))\n* **cli:** add update command for intelligent AIOS updates ([5141931](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F5141931882fd9dcda703da2a10c7d6da434366a8))\n* **cli:** Epic 8 - CLI Completeness with flag support ([#74](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F74)) ([16187c9](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F16187c9699c95755fb2010eff9e0c09d6fd54fd6))\n* **config:** implement layered config hierarchy [Story PRO-4] ([d38cc45](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fd38cc451d41f062f04f5ced9b77fe440606ad08e))\n* **dashboard:** AIOS Dashboard - Final Integration ([#68](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F68)) ([eb3ba26](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Feb3ba2611d2cea96d55e85ccae81394d4766a8d6)), closes [#51](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F51)\n* **dashboard:** enhance story metadata parsing and default settings ([#72](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F72)) ([9b9f574](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F9b9f5740e7085bf73de2f3068f719200422c8099))\n* enforce operational completeness in agent creation pipeline ([#92](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F92)) ([fbdb4bc](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Ffbdb4bc500881810e281adbe1d7eb86396835903))\n* Epic 12 - Bob Orchestrator and CI\u002FCD Pipeline ([75a0cf2](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F75a0cf25eba6afa8219d669842b745176d685b96))\n* EPIC-ACT Unified Activation Pipeline - 8 stories, 386+ tests ([#95](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F95)) ([95a581c](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F95a581cbe04854940eb7b4322aa94140f6308678)), closes [#3](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F3) [#6](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F6) [#4](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F4) [#7](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F7)\n* **gemini:** complete Gemini CLI integration epic (GEMINI-INT) ([5ab9804](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F5ab9804353f892f2b93543387a2903c2385c3396))\n* **ids:** Entity Registry Foundation [Story IDS-1] ([#97](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F97)) ([7ce0a1a](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002F7ce0a1abba5541aac8d758938bf6aa4daf000d04))\n* **ids:** IDS Wave 1 — RegistryHealer, VerificationGates, FrameworkGovernor [Stories IDS-4a, IDS-5a, IDS-7] ([#110](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues\u002F110)) ([abda13e](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcommit\u002Fabda13e4f649d75a62923bf12169b2404602971c))\n* **id","2026-02-11T18:08:25",{"id":237,"version":238,"summary_zh":239,"released_at":240},102554,"v5.0.0","# AIOX-Core v5.0.0\n\n## 📦 NPM Packages\n\n| Package | NPM Link | Description |\n|---------|----------|-------------|\n| aiox-core | [npmjs.com](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faiox-core) | AI-Orchestrated System for Full Stack Development |\n| @synkra\u002Faiox-install | [npmjs.com](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faiox-install) | NPX Installer for AIOX |\n\n## 🚀 Installation\n\n```bash\n# Quick install via NPX (recommended for new users)\nnpx @synkra\u002Faiox-install\n\n# Or global installation\nnpm install -g aiox-core\n\n# Or as project dependency\nnpm install aiox-core\n```\n\n## 📋 What's New\n\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 🔗 Links\n\n* [GitHub Repository](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core)\n* [Documentation](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core#readme)\n* [Issues](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues)\n","2026-03-05T18:30:20",{"id":242,"version":243,"summary_zh":244,"released_at":245},102555,"v4.4.6","## 📋 What's New in v4.4.6\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-25T02:17:47",{"id":247,"version":248,"summary_zh":249,"released_at":250},102556,"v4.4.5","# AIOS-Core v4.4.5\n\n## 📦 NPM Packages\n\n| Package | NPM Link | Description |\n|---------|----------|-------------|\n| aios-core | [npmjs.com](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development |\n| @synkra\u002Faios-install | [npmjs.com](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-install) | NPX Installer for AIOS |\n\n## 🚀 Installation\n\n```bash\n# Quick install via NPX (recommended for new users)\nnpx @synkra\u002Faios-install\n\n# Or global installation\nnpm install -g aios-core\n\n# Or as project dependency\nnpm install aios-core\n```\n\n## 📋 What's New\n\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 🔗 Links\n\n* [GitHub Repository](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core)\n* [Documentation](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core#readme)\n* [Issues](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fissues)\n","2026-02-25T01:52:50",{"id":252,"version":253,"summary_zh":254,"released_at":255},102557,"v4.4.4","## 📋 What's New in v4.4.4\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-25T01:35:49",{"id":257,"version":258,"summary_zh":259,"released_at":260},102558,"v4.4.3","## 📋 What's New in v4.4.3\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 Installation\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [aios-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Faios-core) | AI-Orchestrated System for Full Stack Development | `npm install -g aios-core` |\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g aios-core\n\n# Initialize in your project\naios init\n```\n","2026-02-25T00:56:24",{"id":262,"version":263,"summary_zh":264,"released_at":265},102571,"v3.11.0","## What's Changed\n\n### ✨ New Features\n\n* **feat(core):** Add workflow orchestration module v3.1 with intelligent phase execution (#40)\n* **feat(health-check):** Implement complete Health Check System [HCS-2] (#33)\n* **feat(i18n):** Add translations for completion message\n* **feat(wizard):** Simplify installer with i18n and fewer IDEs\n* **feat(installer):** Remove Gemini CLI from supported IDEs\n* **feat(infrastructure):** Add IDE sync configuration template\n* **feat(devops):** Add documentation link checker tool\n\n### 🐛 Bug Fixes\n\n* **fix:** Add Node.js 18-24 compatibility for installer (#48)\n  - Remove unused `isolated-vm` dependency (required Node.js 22+)\n  - Downgrade `commander` v14 → v12 (supports Node.js 18+)\n  - Downgrade `glob` v11 → v10.4.4 (supports Node.js 18+)\n  - 43 fewer packages, 6 fewer vulnerabilities\n* **fix(tests):** Resolve flaky integration tests (#49)\n* **fix(orchestration):** Address CodeRabbit review issues (#44)\n* **fix(health-check):** Resolve Jest worker process leak [TD-6] (#35)\n* **fix(deps):** Update dependencies to address security vulnerabilities\n* **fix(wizard):** Complete i18n integration for installer\n* **fix(installer):** Improve completion message UX\n* **fix(release):** Prevent version regression with pre-flight tag validation\n\n### 📚 Documentation\n\n* **docs(i18n):** Add trilingual documentation (EN, PT-BR, ES)\n* **docs(mcp):** Add Docker Gateway tutorial and Desktop Commander guide\n* **docs(platforms):** Add comprehensive bilingual platform guides\n* **docs:** Complete 100% documentation coverage\n* **docs:** Fix 177 broken links and resolve all coming soon markers\n\n### 🧪 Tests\n\n* **test(coverage):** Add core module tests and optimize coverage scope [TD-6] (#36)\n* **test(health-check):** Add engine, healers, reporters tests [TD-6]\n\n### 🔧 CI\u002FCD\n\n* Update CI matrix to test Node.js 18, 20, 22, and 24\n* 100% CI matrix coverage (12 combinations: 3 OS × 4 Node versions)\n\n## Platform Compatibility\n\n| OS | Node 18 | Node 20 | Node 22 | Node 24 |\n|----|---------|---------|---------|---------|\n| Ubuntu | ✅ | ✅ | ✅ | ✅ |\n| Windows | ✅ | ✅ | ✅ | ✅ |\n| macOS | ✅ | ✅ | ✅ | ✅ |\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faios-core\u002Fcompare\u002Fv3.10.0...v3.11.0\n","2026-01-28T23:41:50",{"id":267,"version":268,"summary_zh":269,"released_at":270},102572,"v3.10.0","## 📋 What's New in v3.10.0\n\n### 🎉 Initial Release Features:\n* ✅ Complete Meta-Agent MVP and Framework Distribution\n* 🔒 Security hardening with penetration testing\n* ⚡ Performance optimization framework\n* 📊 Privacy-conscious telemetry system\n* 📦 Modular NPM package distribution\n\n## 📦 NPM Packages\n\n| Package | Description | Installation |\n|---------|-------------|--------------|\n| [@synkra\u002Faios-core\u002Fworkspace](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-core\u002Fworkspace) | Complete workspace with all components | `npm install @synkra\u002Faios-core\u002Fworkspace` |\n| [@synkra\u002Faios-core\u002Fcore](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-core\u002Fcore) | Meta-agent orchestration and task management | `npm install @synkra\u002Faios-core\u002Fcore` |\n| [@synkra\u002Faios-core\u002Fmemory](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-core\u002Fmemory) | Vector storage and semantic search | `npm install @synkra\u002Faios-core\u002Fmemory` |\n| [@synkra\u002Faios-core\u002Fsecurity](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-core\u002Fsecurity) | Input sanitization and vulnerability scanning | `npm install @synkra\u002Faios-core\u002Fsecurity` |\n| [@synkra\u002Faios-core\u002Fperformance](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-core\u002Fperformance) | Monitoring, profiling, and optimization | `npm install @synkra\u002Faios-core\u002Fperformance` |\n| [@synkra\u002Faios-core\u002Ftelemetry](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@synkra\u002Faios-core\u002Ftelemetry) | Analytics, error reporting, and metrics | `npm install @synkra\u002Faios-core\u002Ftelemetry` |\n\n## 🚀 Quick Start\n\n```javascript\nconst { AIOS } = require('@synkra\u002Faios-core\u002Fworkspace');\n\nconst aios = new AIOS({\n  \u002F\u002F Optional configuration\n  security: { sanitizeInputs: true },\n  performance: { enableProfiling: true },\n  telemetry: { enabled: false } \u002F\u002F Privacy by default\n});\n\nawait aios.initialize();\nconst agent = await aios.createAgent({ name: 'MyAgent' });\n```\n","2025-12-29T22:47:49",{"id":272,"version":273,"summary_zh":274,"released_at":275},102573,"v3.9.0","## 🎯 Highlights\n\nThis release introduces **Squad Continuous Improvement** capabilities with analyze and extend commands, plus a massive codebase cleanup removing 116K+ lines of deprecated content.\n\n## ✨ New Features\n\n### Story SQS-11: Squad Analyze & Extend\n\n- **`*analyze-squad` command** - Analyze squad structure, coverage, and get improvement suggestions\n- **`*extend-squad` command** - Add new components (agents, tasks, workflows, etc.) incrementally\n\n#### New Scripts\n- `squad-analyzer.js` - Inventory and coverage analysis\n- `squad-extender.js` - Component creation with templates\n\n#### 8 Component Templates\n- `agent-template.md`, `task-template.md`, `workflow-template.yaml`\n- `checklist-template.md`, `template-template.md`\n- `tool-template.js`, `script-template.js`, `data-template.yaml`\n\n## 🧹 Tech Debt Cleanup (Story TD-1)\n\n- Fixed ESLint warnings in 5 core files\n- **Removed 284 deprecated files (~116,978 lines deleted)**\n- Cleaned `.github\u002Fdeprecated-docs\u002F` directory\n- Removed obsolete backup files\n\n## 📦 Installation\n\n\\`\\`\\`bash\nnpm install aios-core@3.9.0\n\\`\\`\\`\n\n## 📋 Stories Included\n- SQS-11: Squad Analyze & Extend\n- TD-1: Tech Debt Cleanup\n\n---\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code)","2025-12-26T23:15:36"]