npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

aios-fullstack

v1.2.3

Published

AIOS-FULLSTACK: AI-Orchestrated System for Full Stack Development - Modern cross-platform CLI with interactive wizard

Downloads

120

Readme

AIOS-FULLSTACK: Framework Universal de Agentes IA 🚀

Versão NPM Licença: MIT Versão Node.js Documentação

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:

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:

  1. Fluxo de Planejamento (Interface Web) - Como criar documentos de PRD e Arquitetura
  2. 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?

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:

  1. Abra as configurações do seu IDE
  2. Navegue até Global Rules (Windsurf) ou User Rules (Cursor)
  3. Copie o conteúdo de .windsurf/global-rules.md ou .cursor/global-rules.md
  4. 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)

  1. Obtenha o pacote: Salve ou clone o arquivo da equipe full stack ou escolha outra equipe
  2. Crie agente IA: Crie um novo Gemini Gem ou CustomGPT
  3. 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"
  4. 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.
  5. CRÍTICO: Fale com o AIOS Orchestrator na web a QUALQUER MOMENTO (comando #aios-orchestrator) e faça perguntas sobre como tudo funciona!
  6. 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

Documentação Adicional

📊 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:

  1. Pre-Commit Hook (Story 3.22)

    • Valida relacionamentos antes de cada commit
    • Detecta referências quebradas
    • Previne regressões
  2. Gap Detection Script

    node outputs/architecture-map/schemas/detect-gaps.js
  3. Quarterly Audit (Story 3.25)

    • Auditoria trimestral automatizada
    • Report de tendências (gap-trend.json)
    • Alertas para novos gaps
  4. 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

🎯 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

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:

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

Veja também:

Licença

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

Reconhecimentos

Contributors

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


⬆ Voltar ao topo