À propos du projet

# Fondation d'ingénierie Agent Teams Ce dépôt fournit une politique d'ingénierie versionnée, des outils et une conformité pour les dépôts Agent Teams. Il contient uniquement des outils de développement réutilisables ; le code d'exécution du produit ne doit pas l'importer. Chaque consommateur reste autoritaire pour son propre modèle de domaine, son catalogue de paquets, ses permissions de dépendances, ses classifications de sécurité et ses ADR. ## Portée - Configuration stricte réservée aux données et schémas versionnés - Déclaration d'espace de travail exécutable et politiques de dépendances source - Suppressions en ligne gouvernées et compatibilité API publique publiée - Connectivité statique de spécification exécutable et de passerelle consommateur - Politique de sécurité des flux de travail de dépôt, SBOM, provenance et contenu des paquets - Instructions d'agent portables et routage de pré-vol des fichiers modifiés - Composition déterministe optionnelle des contrôles qualité de scripts de paquets existants - Préréglages de base partagés Oxlint et TypeScript 7 - Modes explicites de registre et de lien local - Assertions déterministes d'attachement, de statut, de détachement et de registre - Échafaudage fermé et déterministe `Intent -> Plan -> Apply -> Receipt` - Catalogue de documents gouverné, planification déterministe non réservante, publication en création seule et commandes de récupération de version exacte - Vérification isolée du contenu des paquets et des consommateurs - Automatisation de publication pour les versions npm publiques immuables Les capacités sont extraites progressivement de dépôts éprouvés. Une capacité ne déménage ici qu'avec des fixtures de parité et un test de conformité consommateur. `workspace.dependency-declarations` et `architecture.source-dependencies` sont actifs et dogfoodés. Le dépôt utilise le schéma v2 avec la racine de paquets explicite `packages`, tandis que le contrat v1 publié reste chargeable pour les consommateurs existants. ## Commandes ```bash pnpm install pnpm check:changed pnpm check:fast pnpm check pnpm verify pnpm package:check pnpm quality:gate:fast pnpm foundation:qualification ``` Les consommateurs utilisent : ```bash pnpm foundation:check pnpm foundation:attach -- /absolute/path/to/engineering-foundation pnpm foundation:status pnpm foundation:detach pnpm foundation:assert-dev-only pnpm foundation:assert-registry ``` Tout dépôt peut prévisualiser une configuration de documentation portable sans mutation : ```bash docs-protocol init --project-id example/widgets \ --owner documentation/team --dry-run --json ``` Après application du digest examiné, `docs.config.yaml` est découvert automatiquement. La recherche et le contexte borné restent des projections jetables : ```bash docs-protocol find "tenant isolation" --fuzzy docs-protocol context "tenant isolation" --fuzzy --max-documents 12 docs-protocol check ``` La rédaction de documents gouvernée utilise le CLI Docs Protocol installé. `owner` et `summary` sont une autorité d'Intent explicite et ne reçoivent jamais de valeurs par défaut de la Fondation : ```bash agent-teams-docs find "tenant isolation" agent-teams-docs new --type adr --id ADR-0083 \ --title "Tenant isolation" --owner architecture/tooling \ --summary "Defines the tenant-isolation boundary and its verification evidence." \ --dry-run agent-teams-docs doctor agent-teams-docs recover agent-teams-docs-managed upgrade --to docs-YYYY-MM-DD-N --target-generation 2 --json ``` Après examen d'un essai à sec, répétez `agent-teams-docs new` avec `--apply`, suivez son instruction de joignabilité exacte et exécutez la vérification de dépôt standard du consommateur. `foundation:check` émet un rapport agrégé déterministe et applique chaque capacité déclarée. La capacité optionnelle `repository.agent-workflow` maintient `AGENTS.md` canonique entre les agents de codage et route `check:changed` via l'implémentation partagée de la Fondation ; le CI requis exécute toujours la preuve `verify` complète comme voies indépendantes fermées en cas d'échec. `foundation:assert-dev-only` rejette le placement de dépendances d'exécution. `foundation:assert-registry` prouve en outre que la version déclarée exacte a un importateur de verrouillage pnpm correspondant, une entrée de paquet npm, une intégrité sha512 et un instantané sans liens, URLs sources, remplacements ou correctifs. Le noyau d'échafaudage expose des schémas stricts et un adaptateur de système de fichiers journalisé. Il inclut une fixture de conformité réservée aux tests et une recette générique de limite de bibliothèque Node TypeScript privée. Cette dernière crée uniquement l'enveloppe du paquet ; les paquets métier du consommateur, les rôles, les documents propriétaires et les tranches de fonctionnalités restent la propriété du consommateur. Voir [ownership](docs/architecture/ownership.md), [consistency evidence gate](docs/architecture/consistency-evidence-gate.md), [governance capability acceptance review](docs/research/governance-capability-acceptance-review.md), [local development](docs/development/local-mode.md) et [release procedure](docs/release.md). L'index complet de la documentation est [docs/README.md](docs/README.md).