Start Here - agents-lab
Use este mapa para entrar no repositório sem precisar ler todos os guias.
Para a navegação pública mínima do site, use Home e Site map.
Perfis de leitura
| Perfil | Comece por | Depois leia |
|---|---|---|
| Usuário da pi-stack | Recommended pi-stack | Stack sovereignty user guide, Quota visibility |
| Mantenedor do monorepo | Contributing | CI governance, Publishing |
| Operador do control plane | Control-plane operating doctrine | Project canonical pipeline, Control-plane glossary |
| Curadoria e arquitetura | Architecture | Primitives, Engine map |
| Roadmap e release | Roadmap | 0.8 readiness map, Agents-lab editorial pipeline |
| Docs e release notes | Doc drift MDT | GitHub repo presence, Agents-lab editorial pipeline |
Caminho recomendado
- Valide o ambiente local com o menor gate relevante.
- Leia a doc canônica do domínio antes de criar uma nova.
- Quando uma mudança vira contrato reutilizável, registre primitive, guide ou teste.
- Promova runtime first-party só com contrato e smoke focal.
- Use research para evidência e decisão, não para promessa pública.
Fronteiras
docs/guides/: operação e uso recorrente.docs/primitives/: contratos reutilizáveis e invariantes.docs/architecture/: decisões, ownership, diagramas e surfaces de sistema.docs/research/: investigação datada, evidência, scorecards e material ainda não promovido.docs/archive/: histórico preservado, não fonte operacional atual.
Gates úteis
pnpm run docs:package:check
pnpm run repo:discourse:audit
pnpm run repo:bloat:audit
pnpm run test:pi-stack:user-surface
pnpm run ci:local:parity
Use ci:local:parity quando a fatia tocar runtime compartilhado, empacotamento, CI ou contratos publicados.