GLC_RFM-0010
Sessao 01concluidaFri Apr 17 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Sessão 1 — Preparação

Sessão 1 — Preparação

Minhas palavras

#arquitetura [já fiz, pode virar aula se quiser]

Colei o prompt das 17 [orientações da IA, arquitetura, segurança, sustentabilidade]

#preparar o ambiente de trabalho [já fiz, pode virar aula se quiser]

Processo de preparar a infra:

  • Contratar servidor, instalar painéis gestores de containers, docker, traefik, cloudflare, apontamento de dns, URL/domínios, subdomínios etc...

#desenhar_scopo

##Rascunhos

abri o terminal, abri o claude e colei o scopo (gravação da IA, anotações, insights)

### PROMPTS:

Recebi essas demandas, com base na minha forma de trabalho, estude esse escopo, aponte e documente tudo, vai ser um projeto/ Processo de estudo

##aplicar regras

Processo de criação de pastas, escrever arquivos base, estruturas de pastas, git, Gerar o arquivo no repositorio

###aprimorar scopo

Ler ADR, gerar novas ADR, ADR significa Architecture Decision Record

[colar link da session claude] [colar link do repositorio git] encerrar um commit de scopo-inicio-

Aplique um prompt para incorporar esse proprio protocolo de form

fiz várias adaptações quanto a GIT, defini algumas regras que apareceram, na incorporação desse próprio material houve dúvidas quanto a como isso se desenrolaria. Estou definindo.

PROXIMA AULA: #subir um interface: URL/scopo-visual

Detalhamento (IA)

Contexto inicial

Email do parceiro Ale Pinzon com escopo de "Gestão de Licenças" (4 frentes: Mapeamento, Workplan, Produção, Promoção). Modelo de negócio proposto: R$ 10/licença/mês, 50/50 entre sócios. Primeiro projeto da parceria. Rafa decidiu criar como _RFM-0010.

O que foi construído

Estrutura do projeto (Regra 2):

  • CLAUDE.md, TASKS.md, STATUS.md, .gitignore
  • docs/requisitos.md — email integral do Ale + análise crítica com 10 riscos (R1-R10) + escopo v1/v2/v3/v4 + 6 perguntas abertas (P1-P6) pro parceiro
  • docs/arquitetura.md — diagrama C4, modelo de domínio v1, mapeamento bloco → regra
  • docs/playbook/regra-01-blocos.md — ensaio conceitual da Regra 1
  • docs/playbook/sessoes/sessao-01-preparacao.md — este arquivo

Decisões registradas (ADRs):

  • 0001 — escopo v1: só Mapeamento + 1 vertical + 1 município
  • 0002 — stack: FastAPI + PocketBase + Next.js + shadcn
  • 0003 — respostas propostas P1-P6 (status: proposta, não validada). Desdobra em ADRs 0004-0008 quando validadas com Ale.

Repositório

Repo dedicado privado criado via gh repo create:

Regras que nasceram nesta sessão (salvas em memória persistente)

  • Commit atômico por unidade lógica — nem por Edit, nem por sessão. Teste: mensagem em 1 linha sem "e".
  • ADR em status "proposta" vs "aceito" — separa opinião da IA de decisão humana.
  • Playbook como regra formal — docs/playbook/ obrigatório em todo projeto _RFM-* (Regra 2 atualizada).
  • Contrato de autenticidade — sessões são escritas pelo humano; IA só faz o bloco de detalhamento.
  • Sessão substitui etapa — 1 arquivo por sessão, com 2 blocos (Minhas palavras + Detalhamento IA). COORDINATION.md extinto, absorvido.
  • YAML frontmatter obrigatório — permite agregação futura por IA (planejado CRM dentro de _RFM-0001-HDP).

Commits da sessão

Repo _RFM-0010-GLC_Gestao_Licencas:

  • 5283775 — commit inicial (escopo + arquitetura + ADRs 0001/0002)
  • d57d278 — ADR 0003 respostas propostas (pós-escopo)
  • bd79879 — rename formacao/ → playbook/ + (versão antiga da) Aula 1
  • d2c9e55 — refactor playbook com etapas escritas pelo humano
  • 311eb22 — CLAUDE.md sem alarde sobre playbook
  • (próximos desta sessão) — migração sessões + mata COORDINATION

Repo _RFM-0000-Regras:

  • 2c04ce6 — Regra 2 inclui docs/playbook/
  • 7cfface — Regra 2 define divisão de autoria
  • (próximos) — sessões substituem etapas + template + COORDINATION removido

Links

Próximo passo

  1. Rafa revisar ADR 0003 (pode discordar de qualquer posição proposta)
  2. Agendar call com Ale usando ADR 0003 como base
  3. Após call: criar ADRs 0004-0008 com decisões finais (cliente-alvo, domínio, RT, cobrança, operacional)
  4. Só depois: Sprint 1 técnica (fundação do código)