Using the SOT¶

1. Objetivo¶

Este documento ensina como usar o SOT no dia a dia.

Ele serve tanto para onboarding humano quanto para orientar o uso combinado com agentes.

Area	Funcao principal
`docs/`	documentacao para humanos e navegacao renderizada
`method/`	processo de trabalho, SDLC e uso do SOT
`product-definition/`	problema, inception e handoff
`plan/`	backlog, sprints, ADRs, rastreabilidade e acompanhamento
`agents/`	guardrails, contexto e skills operacionais para agentes

Quando surgir uma duvida, pergunte:

docs/ e o site renderizado existem para:

agents/ existe para:

O que um agente faz deve ser coerente com o que a documentacao humana declara.

Se houver conflito:

Usar principalmente:

Usar principalmente:

Usar principalmente:

Usar principalmente:

Tipo de conteudo	Lugar principal
problema, dor, contexto	`product-definition/discovery/`
proposta de recorte e macro-solucao	`product-definition/inception/`
direcao arquitetural relevante	`plan/adr/`
backlog e sprints	`plan/dev/` e `plan/ops/`
regras de uso de agentes	`agents/`
metodo e onboarding	`method/`
execucao de tasks e fluxo do board	`method/task-execution-and-project-flow.md`

usar plan/ para registrar discovery
usar agents/ como se fosse documentacao de negocio
colocar decisoes arquiteturais relevantes apenas em conversa, issue ou PR
colocar detalhes de implementacao no discovery como se fossem dominio do problema
deixar backlog sem rastreabilidade para inception ou ADR

A documentacao renderizada no MkDocs deve ser tratada como forma principal de leitura.

O markdown bruto continua sendo a fonte versionada, mas a navegacao renderizada ajuda a:

Quando houver publicacao web do SOT, a preferencia e expor essa leitura por um endpoint protegido, em vez de manter a consulta apenas local.

Referencia operacional:

Para um novo colaborador, a sequencia minima de onboarding no SOT deve ser: