O que é o modo Project¶
O modo Project é como o N45 trabalha dentro de um único repositório — uma app, um microserviço ou um monorepo (um monorepo ainda é um repositório). É o modo padrão: você roda o /n45 na raiz do repo, e toda feature, bug e roadmap vive ali.
Se o seu produto está espalhado por vários repositórios e uma feature precisa atravessar mais de um, veja o modo Workspace.
Project vs Workspace¶
| Project (single-repo) | Workspace (polyrepo) | |
|---|---|---|
Onde você roda o /n45 |
dentro do repositório | na pasta do workspace |
| Alcance de uma feature | um repositório | um ou mais membros |
| O que coordena | — | o CONTRACT entre os serviços |
| Onde ficam os roadmaps | no próprio repo | em cada membro (um sub-roadmap por membro) |
O modelo mental¶
- Tudo mora no
.n45/do repositório. Discovery, spec, roadmap, tasks e os documentos de contexto ficam versionados no próprio repo. Veja A pasta .n45/. - O N45 aprende o seu projeto uma vez. Na primeira execução ele inspeciona o código e gera os quatro documentos de contexto (STACK, PATTERNS, PROJECT, RUNBOOK); depois só relê.
- Trabalho grande roda isolado. Um roadmap estruturado executa numa git worktree isolada e só volta pro seu branch na validação e no merge.
Quando usar¶
- Use o modo Project quando o trabalho vive num repositório só.
- Use o modo Workspace quando um produto vive em vários repositórios e a feature atravessa eles.