Manual do Mantenedor

🛠️ Manual do Mantenedor (Luiz)

Princípios

1. Uma fonte só: docs/ + AGENTS.md. Nada importante fica só em conversa de IA.
2. Nada muda sem registro: Histórico do REQ + nota de sessão + Registro de Mudanças.
3. Qualquer IA, mesmas regras: sempre começar a sessão pedindo para ler o AGENTS.md.
4. Trilhos: ideia nova vira Pedido de Mudança → decisão → REQ → código. Nunca o contrário.

Fluxo de uma mudança

flowchart LR
  PM[Pedido de Mudança] --> A{Analisar}
  A -->|regra/tecnologia| DEC[Nova DEC]
  A -->|funcionalidade| REQ[Criar/alterar REQ]
  DEC --> REQ
  REQ --> AP[Sócias aprovam] --> DEV[Agente implementa] --> DOC[Agente documenta] --> PUB[Commit + portal atualiza]

Rotina

A cada sessão com um agente de IA

1. Abra a ferramenta na pasta v360-app.
2. Use prompts/02-implementar-req.md (troque o número).
3. Confira se ele cumpriu o Protocolo: Histórico do REQ, nota em 05 Registro/Sessões, linha no Registro de Mudanças, painéis gerados.
4. Revise e faça o commit.

Quando chegar um Pedido de Mudança

1. Salve em 04 Pedidos de Mudança como PM-NNN Título.md (status recebido).
2. Analise (seção Análise), decida e mude o status.
3. Aplique nas notas afetadas, adicionando linha no Histórico de cada uma com link para o PM.

Toda semana (15 min)

• Ver Visão Geral do Projeto — algo parado?
• Pedidos recebido há mais de 7 dias?
• REQs em-desenvolvimento sem sessão recente?
• npm run docs:paineis e commit (o portal atualiza sozinho após o push).

Portal das sócias

Ver Portal de Documentação: rodar local com npm run portal:dev, publicar pelo Cloudflare Pages, controlar quem acessa pelo Cloudflare Access.

Trocar de ferramenta de IA

Nada a configurar: Codex, Cursor e Copilot leem o AGENTS.md; Claude Code lê o CLAUDE.md; Gemini CLI lê o GEMINI.md (ambos apontam para o AGENTS.md). Para chats (ChatGPT, Gemini, Claude web), anexe o AGENTS.md e os REQs envolvidos.

Numeração

Sempre o maior número existente + 1: REQ-091, DEC-007, PM-001… Confira a pasta antes de criar.