Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aios-fullstack) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AIOS-FULLSTACK: Framework Universal de Agentes IA 🚀

Framework de Desenvolvimento Auto-Modificável Alimentado por IA. Fundado em Desenvolvimento Ágil Dirigido por Agentes, oferecendo capacidades revolucionárias para desenvolvimento dirigido por IA e muito mais. Transforme qualquer domínio com expertise especializada de IA: desenvolvimento de software, entretenimento, escrita criativa, estratégia de negócios, bem-estar pessoal e muito mais.

Visão Geral

As Duas Inovações Chave do AIOS-FULLSTACK:

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.

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.

Esta 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ê.

📖 Veja o fluxo de trabalho completo no Guia do Usuário - Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes

Pré-requisitos

Node.js >=20.0.0
npm
GitHub CLI (necessário para colaboração em equipe)

Guias específicos por plataforma:

📖 Guia de Instalação para macOS
📖 Guia de Instalação para Windows (suporte integrado)
📖 Guia de Instalação para Linux (suporte integrado)

Navegação Rápida

Entendendo o Fluxo de Trabalho AIOS

Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o AIOS funciona:

Fluxo de Planejamento (Interface Web) - Como criar documentos de PRD e Arquitetura
Ciclo Principal de Desenvolvimento (IDE) - Como os agentes sm, dev e qa colaboram através de arquivos de histórias

⚠️ Estes diagramas explicam 90% da confusão sobre o fluxo AIOS-FULLSTACK Agentic Agile - Entender a criação de PRD+Arquitetura e o fluxo de trabalho sm/dev/qa 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!

O que você gostaria de fazer?

Instalar e Construir software com Equipe Ágil Full Stack de IA → Instruções de Início Rápido
Aprender como usar o AIOS → Guia completo do usuário e passo a passo
Ver agentes IA disponíveis → Papéis especializados para sua equipe
Explorar usos não técnicos → Escrita criativa, negócios, bem-estar, educação
Criar meus próprios agentes IA → Construir agentes para seu domínio
Navegar expansion packs prontos → Game dev, DevOps, infraestrutura e inspire-se com ideias e exemplos
Hybrid-Ops 2.0 Migration Guide → Upgrade para PV Mode com cognitive architecture executável
Entender a arquitetura → Mergulho técnico profundo
Juntar-se à comunidade → Obter ajuda e compartilhar ideias

Importante: Mantenha Sua Instalação AIOS Atualizada

Mantenha-se atualizado sem esforço! Para atualizar sua instalação AIOS existente:

npx github:Pedrovaleriolopez/aios-fullstack install

Isto vai:

✅ Detectar automaticamente sua instalação existente
✅ Atualizar apenas os arquivos que mudaram
✅ Criar arquivos de backup .bak para quaisquer modificações customizadas
✅ Preservar suas configurações específicas do projeto

Isto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!

Início Rápido

🚀 Instalação via NPX (Recomendado)

Instale o AIOS-FULLSTACK com um único comando:

# Criar um novo projeto com assistente interativo moderno
npx aios-fullstack init meu-projeto

# Ou instalar em projeto existente
cd seu-projeto
npx aios-fullstack install

# Ou usar uma versão específica
npx aios-fullstack@latest init meu-projeto

✨ Assistente de Instalação Moderno

O AIOS-FULLSTACK agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:

Recursos do Instalador Interativo:

🎨 Interface Moderna: Prompts coloridos e visuais com @clack/prompts
✅ Validação em Tempo Real: Feedback instantâneo sobre entradas inválidas
🔄 Indicadores de Progresso: Spinners para operações longas (cópia de arquivos, instalação de deps)
📦 Seleção Multi-Componente: Escolha quais componentes instalar com interface intuitiva
⚙️ Escolha de Gerenciador de Pacotes: Selecione entre npm, yarn ou pnpm
⌨️ Suporte a Cancelamento: Ctrl+C ou ESC para sair graciosamente a qualquer momento
📊 Resumo de Instalação: Visualize todas as configurações antes de prosseguir
⏱️ Rastreamento de Duração: Veja quanto tempo levou a instalação

O instalador oferece:

✅ Download da versão mais recente do NPM
✅ Assistente de instalação interativo moderno
✅ Configuração automática do IDE (Windsurf, Cursor ou Claude Code)
✅ Configuração de todos os agentes e fluxos de trabalho AIOS
✅ Criação dos arquivos de configuração necessários
✅ Inicialização do sistema de meta-agentes
✅ Verificações de saúde do sistema
✅ Suporte Cross-Platform: Testado em Windows, macOS e Linux

É 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.

Pré-requisitos: Node.js v18+ necessário (v20+ recomendado)

Atualizando uma Instalação Existente

Se você já tem o AIOS instalado:

npx github:Pedrovaleriolopez/aios-fullstack install
# O instalador detectará sua instalação existente e a atualizará

Configure Seu IDE para Desenvolvimento AIOS

O AIOS-FULLSTACK inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:

Para Windsurf ou Cursor:

Abra as configurações do seu IDE
Navegue até Global Rules (Windsurf) ou User Rules (Cursor)
Copie o conteúdo de .windsurf/global-rules.md ou .cursor/global-rules.md
Cole na seção de regras e salve

Para Claude Code:

✅ Já configurado! O arquivo .claude/CLAUDE.md é carregado automaticamente

Estas regras fornecem:

🤖 Reconhecimento e integração de comandos de agentes
📋 Fluxo de trabalho de desenvolvimento dirigido por histórias
✅ Rastreamento automático de checkboxes
🧪 Padrões de teste e validação
📝 Padrões de código específicos do AIOS

Início Mais Rápido: Equipe Full Stack via Interface Web à sua disposição (2 minutos)

Obtenha o pacote: Salve ou clone o arquivo da equipe full stack ou escolha outra equipe
Crie agente IA: Crie um novo Gemini Gem ou CustomGPT
Faça upload e configure: Faça upload do arquivo e defina as instruções: "Suas instruções operacionais críticas estão anexadas, não quebre o personagem conforme orientado"
Comece a Idealizar e Planejar: Comece a conversar! Digite *help para ver comandos disponíveis ou escolha um agente como *analyst para começar a criar um briefing.
CRÍTICO: Fale com o AIOS Orchestrator na web a QUALQUER MOMENTO (comando #aios-orchestrator) e faça perguntas sobre como tudo funciona!
Quando mudar para o IDE: Uma vez que você tenha seu PRD, Arquitetura, UX opcional e Briefings - é hora de mudar para o IDE para fragmentar seus documentos e começar a implementar o código real! Veja o Guia do usuário para mais detalhes

Referência de Comandos CLI

O AIOS-FULLSTACK oferece uma CLI moderna e cross-platform com comandos intuitivos:

# Gerenciamento de Projeto (com assistente interativo)
npx aios-fullstack init <nome-projeto> [opções]
  --force              Forçar criação em diretório não vazio
  --skip-install       Pular instalação de dependências npm
  --template <nome>    Usar template específico (default, minimal, enterprise)

# Instalação e Configuração (com prompts modernos)
npx aios-fullstack install [opções]
  --force              Sobrescrever configuração existente
  --quiet              Saída mínima durante instalação
  --dry-run            Simular instalação sem modificar arquivos

# Comandos do Sistema
npx aios-fullstack --version   Exibir versão instalada
npx aios-fullstack --help      Exibir ajuda detalhada
npx aios-fullstack info        Exibir informações do sistema
npx aios-fullstack doctor      Executar diagnósticos do sistema
npx aios-fullstack doctor --fix Corrigir problemas detectados automaticamente

# Manutenção
npx aios-fullstack update      Atualizar para versão mais recente
npx aios-fullstack uninstall   Remover AIOS-FULLSTACK

Recursos da CLI:

✅ Help System Abrangente: --help em qualquer comando mostra documentação detalhada
✅ Validação de Entrada: Feedback imediato sobre parâmetros inválidos
✅ Mensagens Coloridas: Erros em vermelho, sucessos em verde, avisos em amarelo
✅ Cross-Platform: Funciona perfeitamente em Windows, macOS e Linux
✅ Suporte a Dry-Run: Teste instalações sem modificar arquivos

💡 Exemplos de Uso

Instalação Interativa Completa

$ npx aios-fullstack install

🚀 AIOS-FULLSTACK Installation

◆ What is your project name?
│  my-awesome-project
│
◇ Which directory should we use?
│  ./my-awesome-project
│
◆ Choose components to install:
│  ● Core Framework (Required)
│  ● Agent System (Required)
│  ● Expansion Packs (optional)
│  ○ Example Projects (optional)
│
◇ Select package manager:
│  ● npm
│  ○ yarn
│  ○ pnpm
│
◆ Initialize Git repository?
│  Yes
│
◆ Install dependencies?
│  Yes
│
▸ Creating project directory...
▸ Copying framework files...
▸ Initializing Git repository...
▸ Installing dependencies (this may take a minute)...
▸ Configuring environment...
▸ Running post-installation setup...

✔ Installation completed successfully! (34.2s)

Next steps:
  cd my-awesome-project
  aios-fullstack doctor     # Verify installation
  aios-fullstack --help     # See available commands

Instalação Silenciosa (CI/CD)

# Instalação automatizada sem prompts
$ npx aios-fullstack install --quiet --force
✔ AIOS-FULLSTACK installed successfully

Simulação de Instalação (Dry-Run)

# Testar instalação sem modificar arquivos
$ npx aios-fullstack install --dry-run

[DRY RUN] Would create: ./my-project/
[DRY RUN] Would copy: .aios-core/ (45 files)
[DRY RUN] Would initialize: Git repository
[DRY RUN] Would install: npm dependencies
✔ Dry run completed - no files were modified

Diagnóstico do Sistema

$ npx aios-fullstack doctor

🏥 AIOS System Diagnostics

✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)
✔ npm version: 10.2.3
✔ Git installed: version 2.43.0
✔ GitHub CLI: gh 2.40.1
✔ AIOS-FULLSTACK: v1.0.0

Configuration:
✔ .aios-core/ directory exists
✔ Agent files: 11 found
✔ Workflow files: 8 found
✔ Templates: 15 found

Dependencies:
✔ @clack/prompts: ^0.7.0
✔ commander: ^12.0.0
✔ execa: ^9.0.0
✔ fs-extra: ^11.0.0
✔ picocolors: ^1.0.0

✅ All checks passed! Your installation is healthy.

Obter Ajuda

$ npx aios-fullstack --help

Usage: aios-fullstack [options] [command]

AIOS-FULLSTACK: AI-Orchestrated System for Full Stack Development

Options:
  -V, --version                output the version number
  -h, --help                   display help for command

Commands:
  init <project-name>          Create new AIOS project with interactive wizard
  install [options]            Install AIOS in current directory
  info                         Display system information
  doctor [options]             Run system diagnostics and health checks
  help [command]               display help for command

Run 'aios-fullstack <command> --help' for detailed information about each command.

Alternativa: Clonar e Construir

Para contribuidores ou usuários avançados que queiram modificar o código fonte:

# Clonar o repositório
git clone https://github.com/Pedrovaleriolopez/aios-fullstack.git
cd aios-fullstack

# Instalar dependências
npm install

# Executar o instalador
npm run install:aios

Configuração Rápida para Equipe

Para membros da equipe ingressando no projeto:

# Instalar AIOS com configuração GitHub
npx github:Pedrovaleriolopez/aios-fullstack setup

# Isto vai:
# 1. Verificar/instalar GitHub CLI
# 2. Autenticar com GitHub
# 3. Executar o instalador AIOS

🌟 Além do Desenvolvimento de Software - Expansion Packs

O framework de linguagem natural do AIOS funciona em QUALQUER domínio. Os expansion packs 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 expansion packs podem expandir o núcleo do AIOS-FULLSTACK com funcionalidade específica que não é genérica para todos os casos. Veja o Guia de Expansion Packs e aprenda a criar os seus próprios!

Agentes Disponíveis

O AIOS-FULLSTACK vem com 11 agentes especializados:

Agentes Meta

aios-master - Agente mestre de orquestração
aios-orchestrator - Orquestrador de fluxo de trabalho e coordenação de equipe
aios-developer - Meta-agente para criar e modificar componentes do framework

Agentes de Planejamento (Interface Web)

analyst - Especialista em análise de negócios e criação de PRD
pm (Product Manager) - Gerente de produto e priorização
architect - Arquiteto de sistema e design técnico
ux-expert - Design de experiência do usuário e usabilidade

Agentes de Desenvolvimento (IDE)

sm (Scrum Master) - Gerenciamento de sprint e criação de histórias
dev - Desenvolvedor e implementação
qa - Garantia de qualidade e testes
po (Product Owner) - Gerenciamento de backlog e histórias

Documentação e Recursos

Guias Essenciais

📖 Guia do Usuário - Passo a passo completo desde a concepção até a conclusão do projeto
🏗️ Arquitetura Principal - Mergulho técnico profundo e design do sistema
🚀 Guia de Expansion Packs - Estenda o AIOS para qualquer domínio além do desenvolvimento de software

Documentação Adicional

📋 Primeiros Passos - Tutorial passo a passo para iniciantes
🔧 Solução de Problemas - Soluções para problemas comuns
🎯 Princípios Orientadores - Filosofia e melhores práticas do AIOS
🏛️ Visão Geral da Arquitetura - Visão detalhada da arquitetura do sistema
⚙️ Guia de Ajuste de Performance - Otimize seu fluxo de trabalho AIOS
🔒 Melhores Práticas de Segurança - Segurança e proteção de dados
🔄 Guia de Migração v4.31→v1.0 - Migração para versão cross-platform moderna
🔄 Guia de Migração (Legacy) - Migração de versões anteriores
📦 Versionamento e Releases - Política de versões
🌳 Trabalhando no Brownfield - Integrar AIOS em projetos existentes

📊 Architecture Mapping & Visualization System

O AIOS-FULLSTACK v1.0.0 inclui um sistema completo de mapeamento e visualização de arquitetura construído nos Epics 2 & 3. Este sistema oferece visibilidade total da sua arquitetura através de múltiplos formatos e detecção automática de gaps.

🎯 O Que é o Sistema de Mapeamento?

Um grafo de relacionamentos completo de todos os componentes do framework:

📦 199 entidades mapeadas (22 agents, 67 tasks, 27 templates, 9 checklists, 12 tools, 6 workflows, 54 utils, 2 data)
🔗 50 relacionamentos rastreados (executes, uses_template, depends_on, imports, etc.)
🔍 7 categorias de gaps detectadas automaticamente
📈 Auditoria trimestral automatizada para prevenir regressões

🗂️ Formatos Disponíveis

O sistema exporta a arquitetura em 3 formatos complementares:

1. 🔵 Neo4j Graph Database

Explore a arquitetura interativamente com Neo4j:

# Localização: outputs/architecture-map/neo4j/
cd outputs/architecture-map/neo4j/

# Siga o guia de setup (Neo4j Desktop ou Docker)
cat SETUP-GUIDE.md

# Import rápido (após instalar Neo4j)
neo4j-admin database import full \
  --nodes=nodes.csv \
  --relationships=relationships.csv \
  --delimiter=',' \
  architecture-db

Queries Prontos:

🔍 Encontrar dependências de um componente
🧩 Analisar cadeias de relacionamentos
📊 Estatísticas de conectividade
⚠️ Identificar componentes isolados

Veja sample-queries-annotated.cypher para 13 queries prontos!

2. 📐 Mermaid Diagrams

8 diagramas Mermaid prontos para documentação:

# Localização: outputs/architecture-map/mermaid/

synthesis-full-architecture.mmd       # Arquitetura completa
synthesis-layered-view.mmd           # Visão em camadas (agents → tasks → utils)
synthesis-critical-paths.mmd         # Caminhos críticos
synthesis-gap-visualization.mmd      # Gaps visualizados
synthesis-module-view.mmd            # Visão modular
gap-focus.mmd                        # Foco em gaps
dependency-chains.mmd                # Cadeias de dependência
ide-coverage.mmd                     # Cobertura IDE

Renderize no GitHub, VSCode ou use Mermaid Live Editor!

3. 🌐 HTML Interactive Dashboard

Dashboard interativo (Vis.js) - funciona offline:

# Localização: outputs/architecture-map/visualization/
open outputs/architecture-map/visualization/index.html

Recursos do Dashboard:

🔍 Busca e filtros por tipo de entidade
🎨 Visualização interativa do grafo (zoom, pan, drag)
📊 Painel de detalhes de entidades
🔗 Navegação por relacionamentos
📈 Estatísticas em tempo real

🛡️ Gap Detection System

Sistema automatizado de detecção de gaps em 7 categorias:

Categoria	Descrição	Status
Broken References	Referências a entidades inexistentes	17 gaps
Orphaned Active	Entidades ativas sem uso	0 gaps ✅
Ambiguous Relations	Relacionamentos ambíguos	5 gaps
Missing Docs	Documentação faltante	150 gaps
Deprecated Active	Componentes deprecated ainda em uso	0 gaps ✅
Incomplete Workflows	Workflows incompletos	8 gaps
Tool Validation	Ferramentas referenciadas mas não registradas	12 gaps

Total: 338 gaps rastreados (88 Orphaned Active resolvidos no Epic 3.1!)

🔄 Automated Validation

Validação contínua em múltiplos pontos:

Pre-Commit Hook (Story 3.22)
- Valida relacionamentos antes de cada commit
- Detecta referências quebradas
- Previne regressões

Gap Detection Script

node outputs/architecture-map/schemas/detect-gaps.js

Quarterly Audit (Story 3.25)
- Auditoria trimestral automatizada
- Report de tendências (gap-trend.json)
- Alertas para novos gaps
Tool Reference Validation (Story 3.21)
```
node outputs/architecture-map/schemas/validate-tool-references.js
```
- Valida ferramentas MCP/CLI/Local
- Suporta dual-mode (Legacy/1MCP)

📈 Epic 2 & 3 Achievements

Epic 2 - Architecture Mapping (100% Complete):

✅ 297 entidades catalogadas
✅ 174 relacionamentos sintetizados
✅ Neo4j/Mermaid/HTML exports prontos
✅ Gap detection implementado
✅ Visualização interativa funcional

Epic 3 - Gap Remediation (62% Complete):

✅ 88 Orphaned Active gaps resolvidos (Stories 3.1.1-3.1.4)
✅ 54 utilities ativas documentadas em core-config.yaml
✅ 19 utilities arquivadas com rationale
✅ 85% token reduction via 1MCP integration (280k → 40k tokens)
✅ Dual-mode validation (Legacy/1MCP)
✅ Pre-commit hooks + Quarterly audit

🚀 Quick Start

1. Explore o Sistema:

# Ver entidades e relacionamentos
cat outputs/architecture-map/MASTER-RELATIONSHIP-MAP.json | jq '.metadata'

# Detectar gaps
node outputs/architecture-map/schemas/detect-gaps.js

# Abrir dashboard
open outputs/architecture-map/visualization/index.html

2. Importe no Neo4j (opcional):

cd outputs/architecture-map/neo4j/
cat SETUP-GUIDE.md  # Siga as instruções

3. Use Diagramas Mermaid:

# Copie qualquer .mmd para sua documentação
cp outputs/architecture-map/mermaid/synthesis-layered-view.mmd docs/

📚 Documentação Adicional

📖 Neo4j Setup Guide - Importação completa
📖 Visualization Guide - Como usar o dashboard
📖 Gap Detection Guide - Validação automatizada
📖 Story 2.11 - Synthesis implementation
📖 Story 2.12 - Visualization implementation

🎯 Roadmap v1.1

Story 3.31 - 1MCP preset relationship synthesis
Interactive Miro board export
Real-time Neo4j updates on code changes
VSCode extension for inline visualization

Criando Seu Próprio Expansion Pack

Expansion packs permitem estender o AIOS para qualquer domínio. Estrutura básica:

expansion-packs/seu-pack/
├── config.yaml           # Configuração do pack
├── agents/              # Agentes especializados
├── tasks/               # Fluxos de trabalho de tarefas
├── templates/           # Templates de documentos
├── checklists/          # Checklists de validação
├── data/                # Base de conhecimento
├── README.md            # Documentação do pack
└── user-guide.md        # Guia do usuário

Veja o Guia de Expansion Packs para instruções detalhadas.

Expansion Packs Disponíveis

aios-infrastructure-devops - Infraestrutura e DevOps
expansion-creator - Criador de expansion packs
hybrid-ops - Operações híbridas humano-agente
meeting-notes - Notas e atas de reuniões

Explore o diretório expansion-packs/ para mais inspiração!

Suporte

Git Workflow e Validação

O AIOS-FULLSTACK implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência:

🛡️ Defense in Depth - 3 Camadas de Validação

Camada 1: Pre-commit (Local - Rápida)

✅ ESLint - Qualidade de código
✅ TypeScript - Verificação de tipos
⚡ Performance: <5s
💾 Cache habilitado

Camada 2: Pre-push (Local - Validação de Stories)

✅ Validação de checkboxes de histórias
✅ Consistência de status
✅ Seções obrigatórias

Camada 3: CI/CD (Cloud - Obrigatório para merge)

✅ Todos os testes
✅ Cobertura de testes (80% mínimo)
✅ Validações completas
✅ GitHub Actions

📖 Documentação Detalhada

📋 Guia Completo de Git Workflow - Guia detalhado do fluxo de trabalho
📋 CONTRIBUTING.md - Guia de contribuição

Comandos Disponíveis

# Validações locais
npm run lint           # ESLint
npm run typecheck      # TypeScript
npm test              # Testes
npm run test:coverage # Testes com cobertura

# Validador AIOS
node .aios-core/utils/aios-validator.js pre-commit   # Validação pre-commit
node .aios-core/utils/aios-validator.js pre-push     # Validação pre-push
node .aios-core/utils/aios-validator.js stories      # Validar todas stories

Branch Protection

Configure proteção da branch master com:

node scripts/setup-branch-protection.js

Requer:

GitHub CLI (gh) instalado e autenticado
Acesso de admin ao repositório

Contribuindo

Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e expansion packs! 🎉

Para contribuir:

Fork o repositório
Crie uma branch para sua feature (git checkout -b feature/MinhaNovaFeature)
Commit suas mudanças (git commit -m 'feat: Adicionar nova feature')
Push para a branch (git push origin feature/MinhaNovaFeature)
Abra um Pull Request

Veja também:

Licença

Licença MIT - veja o arquivo LICENSE para detalhes.

Reconhecimentos

_{Construído com ❤️ para a comunidade de desenvolvimento assistido por IA}

⬆ Voltar ao topo