Sobre o projeto

# Base de Engenharia Agent Teams Este repositório fornece política de engenharia versionada, ferramentas e conformidade para repositórios Agent Teams. Contém apenas ferramentas de desenvolvimento reutilizáveis; código de runtime de produto não deve importá-lo. Cada consumidor permanece autoritativo para seu próprio modelo de domínio, catálogo de pacotes, permissões de dependência, classificações de segurança e ADRs. ## Escopo - Configuração estrita somente de dados do consumidor e esquemas versionados - Declaração executável de workspace e políticas de dependências de origem - Supressões inline governadas e compatibilidade de API pública lançada - Conectividade estática de especificação executável e portão do consumidor - Fluxo de trabalho do repositório, SBOM, proveniência e política de segurança de conteúdo de pacotes - Instruções portáteis de agente e roteamento de pré-verificação de arquivos alterados - Composição determinística opcional de portões de qualidade de scripts de pacotes existentes - Predefinições compartilhadas de baseline Oxlint e TypeScript 7 - Modos explícitos de registro e link local - Asserções determinísticas de anexar, status, desanexar e registro - Estrutura fechada e determinística `Intenção -> Plano -> Aplicar -> Recibo` - Catálogo de documentos governado, planejamento determinístico sem reserva, publicação somente de criação e comandos de recuperação de versão exata - Verificação isolada de conteúdo de pacote e consumidor - Automação de lançamento para versões públicas imutáveis do npm As capacidades são extraídas incrementalmente de repositórios comprovados. Uma capacidade se move para cá apenas com fixtures de paridade e um teste de conformidade do consumidor. `workspace.dependency-declarations` e `architecture.source-dependencies` estão ativos e em uso interno. O repositório usa o esquema v2 com a raiz de pacotes explícita `packages`, enquanto o contrato v1 publicado permanece carregável para consumidores existentes. ## Comandos ```bash pnpm install pnpm check:changed pnpm check:fast pnpm check pnpm verify pnpm package:check pnpm quality:gate:fast pnpm foundation:qualification ``` Os consumidores usam: ```bash pnpm foundation:check pnpm foundation:attach -- /caminho/absoluto/para/engineering-foundation pnpm foundation:status pnpm foundation:detach pnpm foundation:assert-dev-only pnpm foundation:assert-registry ``` Qualquer repositório pode pré-visualizar uma configuração de documentação portátil sem mutação: ```bash docs-protocol init --project-id exemplo/widgets \ --owner documentacao/time --dry-run --json ``` Após aplicar o resumo revisado, `docs.config.yaml` é descoberto automaticamente. Busca e contexto limitado permanecem projeções descartáveis: ```bash docs-protocol find "isolamento de tenant" --fuzzy docs-protocol context "isolamento de tenant" --fuzzy --max-documents 12 docs-protocol check ``` A autoria de documentos governados usa a CLI do Docs Protocol instalada. `owner` e `summary` são autoridade explícita de Intenção e nunca recebem padrões da Fundação: ```bash agent-teams-docs find "isolamento de tenant" agent-teams-docs new --type adr --id ADR-0083 \ --title "Isolamento de tenant" --owner arquitetura/ferramentas \ --summary "Define o limite de isolamento de tenant e suas evidências de verificação." \ --dry-run agent-teams-docs doctor agent-teams-docs recover agent-teams-docs-managed upgrade --to docs-AAAA-MM-DD-N --target-generation 2 --json ``` Após revisar uma execução simulada, repita `agent-teams-docs new` com `--apply`, siga sua instrução exata de alcançabilidade e execute a verificação padrão do repositório do consumidor. `foundation:check` emite um relatório agregado determinístico e aplica cada capacidade declarada. A capacidade opcional `repository.agent-workflow` mantém `AGENTS.md` canônico entre agentes de codificação e roteia `check:changed` através da implementação compartilhada da Fundação; a CI obrigatória ainda executa a evidência completa de `verify` como faixas independentes de falha fechada. `foundation:assert-dev-only` rejeita colocação de dependência em runtime. `foundation:assert-registry` adicionalmente prova que a versão declarada exata tem um importador correspondente no lockfile do pnpm, entrada de pacote npm, integridade sha512 e snapshot sem links, URLs de origem, overrides ou patches. O kernel de andaimes expõe esquemas estritos e um adaptador de sistema de arquivos registrado. Inclui um fixture de conformidade somente para testes e uma receita genérica de limite de biblioteca Node TypeScript privada. Esta última cria apenas o envelope do pacote; pacotes de negócios do consumidor, papéis, documentos do proprietário e fatias de recursos permanecem de propriedade do consumidor. Veja [propriedade](docs/architecture/ownership.md), [portão de evidência de consistência](docs/architecture/consistency-evidence-gate.md), [revisão de aceitação de capacidade de governança](docs/research/governance-capability-acceptance-review.md), [desenvolvimento local](docs/development/local-mode.md) e [procedimento de lançamento](docs/release.md). O índice completo da documentação está em [docs/README.md](docs/README.md).