atypical-squad

Multi-agent squad para construir jogos educativos para criancas neurodivergentes (TDAH / Autismo), mobile-first, em TypeScript, com 46 agentes especializados e 28 workflows DAG. Pronto para rodar dentro do Claude Code da Anthropic.

npx atypical-squad install

O que e

atypical-squad empacota a squad webgame-design-squad (v3.3.0) como um pacote npm instalavel. Dentro de qualquer projeto, um unico comando copia os agentes, workflows, templates, schemas e checklists para .claude/, deixando o Claude Code pronto para rodar pipelines completos de design + engenharia de webgames.

A squad foi desenhada com foco em criancas neurodivergentes (TDAH e Autismo): cada artefato passa por um modulo Guardian Atypical com 10 dimensoes auditadas (estimulos, feedback, imersao, perfeccionismo, competitividade, telemetria, acessibilidade, pedagogia, monetizacao etica e compliance legal COPPA/GDPR-K/FTC/ESRB).

A geracao de assets e nativa do pipeline: prompts de audio (Lyria 3 + fallbacks) e arte (Nanobanana / Sora + fallbacks) sao tratados como adapters vendor-agnostic, com prompts neutros versionados.

Features

• 46 agentes especializados (12 originais + 18 PRD/Epic/Story + 6 brownfield + 10 guardian Atypical).
• 28 workflows DAG com self-verify, escalation e iteracoes versionadas.
• 56 schemas JSON validados em runtime via ajv (npm run validate).
• 53 templates prontos para todos os artefatos.
• 27 checklists para gates de qualidade humanos.
• 10 dimensoes Atypical auditadas em todo build de feature.
• Mobile-first em TypeScript com Phaser como engine de referencia.
• Vendor adapter pattern para audio e visual (sem lock-in).
• Vision-gate em brownfield (expansion, migration, discovery).
• Modo offline validado no DoD.

Quick start

Cenario 1: jogo novo (greenfield)

cd meu-jogo-novo
npx atypical-squad install
# dentro do Claude Code:
# *run-workflow webgame-design-squad start-here

Cenario 2: jogo existente (brownfield)

cd meu-jogo-existente
npx atypical-squad install
# dentro do Claude Code:
# *run-workflow webgame-design-squad brownfield-discovery

Cenario 3: so auditar (Guardian-only)

cd meu-jogo
npx atypical-squad install
# dentro do Claude Code:
# *run-workflow webgame-design-squad guardian-review

Os 46 agentes

| Agente | Papel | |--------|-------| | wgs-creative-director | Visao criativa, autoridade de visao | | wgs-discovery-interviewer | Entrevistas de discovery | | wgs-game-designer | Mecanicas, regras, sistemas | | wgs-narrative-designer | Narrativa e tom | | wgs-level-designer | Niveis e progressao | | wgs-balance-designer | Balanceamento e curvas | | wgs-framework-architect | Arquitetura tecnica do jogo | | wgs-tech-lead | Lideranca tecnica e tradeoffs | | wgs-audio-prompt-specialist | Prompts de audio (Lyria 3 + fallbacks) | | wgs-visual-prompt-specialist | Prompts visuais (Nanobanana/Sora + fallbacks) | | wgs-mobile-qa | QA mobile-first | | wgs-business-strategist | Modelo de negocio etico |

| Agente | Papel | |--------|-------| | wgs-prd-architect | PRD greenfield | | wgs-epic-decomposer | Decomposicao em epics | | wgs-story-writer | Stories implementaveis | | wgs-scrum-master | Cadencia e refinamento |

| Agente | Papel | |--------|-------| | wgs-brownfield-pm | PM de expansao | | wgs-brownfield-discovery | Discovery de codebase existente | | wgs-migration-planner | Plano de migracao | | wgs-tech-debt-auditor | Auditoria de debito tecnico | | wgs-expansion-validator | Validador de expansao |

| Agente | Dimensao | |--------|---------| | wgs-atyp-neurodivergence-specialist | Estimulos TDAH/Autismo | | wgs-atyp-feedback-loop-auditor | Feedback imediato | | wgs-atyp-immersion-auditor | Imersao adaptada | | wgs-atyp-perfectionism-competitiveness-auditor | Perfeccionismo e competitividade | | wgs-atyp-telemetry-integration-auditor | Telemetria backend | | wgs-atyp-accessibility-auditor | Acessibilidade neurodivergente | | wgs-atyp-educational-design-specialist | Pedagogia | | wgs-atyp-monetization-ethics-auditor | Etica de monetizacao | | wgs-atyp-compliance-auditor | Compliance legal | | wgs-atyp-guardian | Orquestrador dos 9 acima |

| Agente | Papel | |--------|-------| | wgs-atyp-backend-compatibility-checker | Compat de telemetria | | wgs-loca | Localizacao i18n | | wgs-play | Playtest com criancas reais | | wgs-pick | Selecao de workflow | | wgs-liveops | Live ops, eventos, patch notes | | wgs-vendor-adapter | Adapter audio/visual |

Lista completa: npx atypical-squad list.

Os 28 workflows

| Workflow | Quando usar | |----------|-------------| | start-here | Selector inicial para qualquer projeto | | discovery-interview | Entrevista inicial | | concept-validation | Validar conceito | | gdd-creation | Criar GDD | | prd-creation | Criar PRD | | gdd-to-epics | GDD -> epics | | epics-to-stories | Epics -> stories | | feature-development | Pipeline de feature | | pre-release-gate | Gate de release | | playtest-protocol | Playtest etico com criancas | | guardian-review | Auditoria Atypical | | hotfix-pipeline | Hotfix de producao | | rollback-pipeline | Rollback seguro | | ab-testing-setup | A/B test setup | | content-update-pipeline | Update de conteudo | | live-ops-event | Evento live ops | | brownfield-discovery | Discovery de codebase legado | | brownfield-expansion | Expansao com vision-gate | | brownfield-migration | Migracao com vision-gate | | tech-debt-assessment | Debito tecnico | | ...e mais | npx atypical-squad list |

Os 7 principios Atypical

1. Visao acima de feature — features servem a visao, nao o oposto.
2. Crianca neurodivergente no centro — TDAH e Autismo como design constraints, nao acessorios.
3. Estimulo certo, na hora certa — feedback imediato sem overload sensorial.
4. Sem perfeccionismo toxico — perda nao e fracasso; competicao saudavel.
5. Etica antes de monetizacao — 5 modelos aprovados, veto a dark patterns.
6. Compliance e default — COPPA, GDPR-K, FTC, ESRB, DPIA.
7. Pais e responsaveis sao parceiros — telemetria transparente, controle parental real.

Requirements

• Claude Code instalado.
• Node.js >= 18.
• (Opcional) GitHub CLI para os workflows que tocam git.

Comandos do CLI

npx atypical-squad install [target-dir] [--force]   # Instala no projeto
npx atypical-squad validate                         # Valida schemas com ajv
npx atypical-squad doctor                           # Diagnostico
npx atypical-squad list                             # Lista agentes/workflows
npx atypical-squad info                             # Metadata da squad
npx atypical-squad --help                           # Ajuda
npx atypical-squad --version                        # Versao

Estrutura do pacote

atypical-squad/
├── bin/
│   ├── cli.js          # entrypoint
│   ├── install.js      # copia para .claude/
│   ├── validate.js     # ajv em todos schemas
│   └── doctor.js       # diagnostico
└── squads/
    └── webgame-design-squad/
        ├── squad.yaml
        ├── agents/         # 46
        ├── workflows/      # 28
        ├── schemas/        # 56 (+ _shared)
        ├── templates/      # 53
        ├── checklists/     # 27
        ├── tasks/
        ├── tools/
        ├── data/
        ├── references/
        ├── config/
        └── decision-tree.md

Contribuindo

Veja CONTRIBUTING.md.

License

MIT (c) 2026 Italo Franca / Atypical. Veja LICENSE.

Sobre a Atypical

A Atypical projeta produtos digitais para criancas neurodivergentes, comecando por jogos educativos que respeitam o ritmo, os limites sensoriais e a curiosidade de cada crianca. Esta squad e a forma como construimos. Mais em https://github.com/ItaloDeFranca.