Start New Project

Iniciar um projeto no Nébula Spec Kit não é abrir a IDE e clonar um repositório vazio. É a jornada controlada de transmutar uma ideia superficial em um mapa de documentação técnico, arquitetural e logístico, e só então gerar código.

Objetivo: Sair de uma intenção para o estado de "Executável" via Quality Gates e Tasks Rastreáveis.
Fontes da Verdade: GUIDE.md do Repositório Raiz e Workflows/initial-setup.md.
Selo de Execução: Nenhuma linha de implementação começa sem as Fases de 0 a 5 terminadas.

Estrutura — O Rito de Fundação

Abaixo encontra-se o escopo inflexível das Fases base de inicialização. É proibido pular uma Fase sob o risco de romper toda a rastreabilidade do projeto.

1. Fase 0 — Descoberta

O Big Bang do projeto. Antes dessa camada, o projeto sequer existe formalmente no Framework. Trata da captura do contexto.

Entrada: Entendimento verbal e anotações base.
Modelo de Trabalho: Templates/Full/brief.md
Saída Canônica Oficial: Docs/brief.md

2. Fase 1 — Definição do Projeto

Valida o Produto, as restrições contratuais e a Stack tecnológica imutável inicial. Sem essa fase o Agente não saberá em que código programar.

Modelos de Trabalho: 
- Templates/Full/project.md
- Templates/Full/stack.md
 
Saídas Canônicas Oficiais: 
- Docs/project.md
- Docs/stack.md

3. Fase 2 — Requisitos Funcionais

A camada humana. Não se discute banco de dados aqui e sim comportamento de usuários validáveis. O "produto" ganha os trilhos.

Modelo de Trabalho: Templates/Full/user-stories.md
Saída Canônica Oficial: Docs/user-stories.md

4. Fase 3 — Design de Produto

A identidade e a experiência isoladas do peso da lógica complexa de código. O produto real não avança nas tarefas técnicas sem ter definido interface e fluxos visuais/navegáveis.

Modelos de Trabalho: 
- Templates/Full/pages.md
- Templates/Full/flow.md
- Templates/Full/design-system.md
- Templates/Full/tokens.json
 
Saídas Canônicas Oficiais: 
- Docs/pages.md
- Docs/flow.md
- Docs/design-system.md
- Docs/tokens.json
 
Extra de UI: Deve gerar a documentação Prototype/00README.md (quando houver tela explícita).

5. Fase 4 — Design de Sistema

A blindagem e a infraestrutura do software. É a tradução de todas as Fases anteriores no rigor técnico da Topologia, Pastas e Banco de dados.

Modelos de Trabalho: 
- Templates/Full/entities.md
- Templates/Full/architecture.md
- Templates/Full/contract.yaml
- Templates/Full/structure.md
- Templates/Full/deploy.md
 
Saídas Canônicas Oficiais: 
- Docs/entities.md (banco/dados)
- Docs/architecture.md (topologia/containers)
- Docs/contract.yaml (api estrita)
- Docs/structure.md (pastas)
- Docs/deploy.md (CI/rollback)

6. Fase 5 — Planejamento de Implementação

O funil de inteligência entra em regime operacional. A arquitetura vira fases de entrega e o plano vira controle diário de commit por commit.

Modelos de Trabalho: 
- Templates/Full/plan.md
- Templates/Full/tasks.md
- Templates/Full/control.md
 
Saídas Canônicas Oficiais: 
- Docs/plan.md (Estrutura Milestones Macro)
- Docs/tasks.md (Escopo Micro atômico rastreável)
- Docs/control.md (O painel executivo atual do ciclo)

7. A Regra Maior da Injeção de Código

Concluídas as Fases 0 a 5, instaura-se OBRIGATORIAMENTE o marco único de injeção física. A partir do fechamento desses documentos, abre-se a TASK-001.

Regimento da TASK-001:
- A sua política documentada deve ser exclusivamente: "bootstrap_estrutural".
- A task 001 CLONA todo o Framework. 
- A task 001 GERA e materializa nos arquivos o "structure.md" recém criado.
- A partir da Task 002, toda a equipe humana e AIs operam em modo de política "edição" restrita, proibidos de improvisar pastas sob pena de quebra severa do Quality Gate.

Prompt para gerar com agente (Jornada Secionada)

Como "Início de Projeto" não é um artefato fixo, você não gera o projeto com um único prompt. O procedimento correto é seguir a esteira do Initial Setup Workflow.

Atue como ScopeAgent.
Objetivo: Executar FASE 0 e FASE 1 do início da jornada.
Workflow associado: initial-setup
 
Use o contexto do que discutimos, consulte os Templates/Full adequados para brief, project e stack.
Entregue as Fases perfeitamente consolidadas dentro da respectiva pasta Docs/. Acione meu aval explícito antes de tentar migrar aos Requisitos da Fase 2.

Definição de pronto da Jornada

Considera-se que você Inicializou um projeto com sucesso no Nébula quando:

1. A pasta mãe do projeto reflete idênticamente toda a listagem Docs/ repleta das versões Oficiais, sem lacunas de fases.
2. Nenhuma implementação de código (script solto ou POC em src/) existiu antes da validação arquitetural e liberação da FASE 5 (Control/Tasks rodando).
3. O bootstrap_estrutural logrou êxito de fundir a governaça e os novos testes de base do structure.md.

Relação com outros artefatos

Workflows/initial-setup.md  — O maestro prático que aciona sua AI a seguir pelas fases
Docs/*                      — O celeiro passivo que vai recebendo a carga das 6 Fases da esteira