implementation-plan.md

Implementation Plan

Por que este arquivo existe

Este documento organiza a sequencia de implementacao. Ele deve transformar visao e arquitetura em fases executaveis.

Use para planejar sprints, marcos, dependencias e criterios globais de aceite.

Este documento deve refletir o estado real da implementacao. A IA deve atualiza-lo sempre que concluir uma tarefa que avance fase, checklist ou dependencia critica.

Natureza de Template

Este arquivo e um template. No primeiro chat de escopo, revise e ajuste objetivo, escopo da primeira entrega, fases, dependencias, criterios globais de aceite e regras de avanco ao projeto real.

Objetivo

Implementar [NOME_DO_PROJETO] para [resultado esperado].

Escopo da Primeira Entrega

• [item]

Sequencia de Implementacao

Fase 0 - Fundacao documental

Status: Concluida

• Criar ou revisar AGENTS.md.
• Criar docs canonicos.
• Registrar decisoes iniciais.
• Definir sincronia obrigatoria entre plano, issues e log tecnico.
• Criar docs/deployment-log.md.
• Documentar travamento de escopo em docs/implementation-governance.md.
• Documentar o fluxo Spec-First de adaptar docs ao projeto antes de gerar codigo.
• Documentar adaptadores de ferramenta e criar CLAUDE.md.
• Criar diretrizes de design para UI e frontend.
• Documentar adaptacao inicial completa do framework ao escopo do projeto.
• Reequilibrar autonomia da IA para o modelo humano navegador/IA piloto.
• Explicitar natureza de template em todos os documentos do framework.
• Evoluir diretrizes de design com baseline de tokens, layout e componentes.
• Exigir kickoff visual quando houver UI sem preferencias humanas definidas.

Fase 1 - Scaffold tecnico

Status: Planejada | Em andamento | Concluida | Bloqueada

• [tarefa]

Fase 2 - Modelo ou dominio principal

Status: Planejada | Em andamento | Concluida | Bloqueada

• [tarefa]

Fase 3 - Interface, API ou integracao publica

Status: Planejada | Em andamento | Concluida | Bloqueada

• [tarefa]

Fase 4 - Hardening e deploy

Status: Planejada | Em andamento | Concluida | Bloqueada

• [tarefa]

Regras de Avanco

• Nao marcar fase como Concluida se houver checklist obrigatorio aberto.
• Nao iniciar fase posterior quando a fase atual tiver bloqueios sem decisao registrada.
• Ao concluir item de fase, atualizar a issue relacionada em docs/issues.md.
• Ao entregar mudanca tecnica, registrar entrada em docs/deployment-log.md.
• Ao mudar a ordem das fases ou criterio de aceite, registrar decisao em docs/decision-log.md.

Dependencias Criticas

1. [dependencia]
2. [dependencia]

Criterios Globais de Aceite

• [criterio]