ComposioHQ/notion-spec-to-implementation

Especificação para Implementação

Converta uma especificação do Notion em planos de implementação vinculados, tarefas e atualizações de status contínuas.

Início rápido

1. Localize a especificação com Notion:notion-search e, em seguida, busque-a com Notion:notion-fetch.
2. Analise requisitos e ambiguidades usando reference/spec-parsing.md.
3. Crie uma página de plano com Notion:notion-create-pages (escolha um modelo: rápido ou completo).
4. Encontre o banco de dados de tarefas, confirme o esquema e, em seguida, crie tarefas com Notion:notion-create-pages.
5. Vincule especificação ↔ plano ↔ tarefas; mantenha o status atualizado com Notion:notion-update-page.

Fluxo de trabalho

0) Se qualquer chamada MCP falhar porque o MCP do Notion não está conectado, pause e configure-o:

1. Adicione o MCP do Notion:
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. Habilite o cliente MCP remoto:
   • Defina [features].rmcp_client = true em config.toml ou execute codex --enable rmcp_client
3. Faça login com OAuth:
   • codex mcp login notion

Após o login bem-sucedido, o usuário precisará reiniciar o codex. Você deve terminar sua resposta e informá-los para que, quando tentarem novamente, possam continuar com a Etapa 1.

1) Localize e leia a especificação

• Primeiro pesquise (Notion:notion-search); se houver múltiplos resultados, pergunte ao usuário qual usar.
• Busque a página (Notion:notion-fetch) e analise requisitos, critérios de aceitação, restrições e prioridades. Consulte reference/spec-parsing.md para padrões de extração.
• Capture lacunas/suposições em um bloco de esclarecimentos antes de prosseguir.

2) Escolha a profundidade do plano

• Mudança simples → use reference/quick-implementation-plan.md.
• Funcionalidade/migração com várias fases → use reference/standard-implementation-plan.md.
• Crie o plano via Notion:notion-create-pages, incluindo: visão geral, especificação vinculada, resumo de requisitos, fases, dependências/riscos e critérios de sucesso. Vincule de volta à especificação.

3) Crie tarefas

• Encontre o banco de dados de tarefas (Notion:notion-search → Notion:notion-fetch para confirmar a fonte de dados e as propriedades necessárias). Padrões em reference/task-creation.md.
• Dimensione as tarefas para 1–2 dias. Use reference/task-creation-template.md para o conteúdo (contexto, objetivo, critérios de aceitação, dependências, recursos).
• Defina propriedades: título/verbo de ação, status, prioridade, relações com a especificação + plano, data de vencimento/story points/responsável, se fornecido.
• Crie páginas com Notion:notion-create-pages usando o data_source_id do banco de dados.

4) Vincule artefatos

• O plano vincula-se à especificação; as tarefas vinculam-se tanto ao plano quanto à especificação.
• Opcionalmente, atualize a especificação com uma breve seção "Implementação" apontando para o plano e as tarefas usando Notion:notion-update-page.

5) Acompanhe o progresso

• Use a cadência em reference/progress-tracking.md.
• Publique atualizações com reference/progress-update-template.md; feche fases com reference/milestone-summary-template.md.
• Mantenha checklists e campos de status no plano/tarefas sincronizados; anote bloqueadores e decisões.

Referências e exemplos

• reference/ — padrões de análise, modelos de plano/tarefa, cadência de progresso (por exemplo, spec-parsing.md, standard-implementation-plan.md, task-creation.md, progress-tracking.md).
• examples/ — passo a passo de ponta a ponta (por exemplo, ui-component.md, api-feature.md, database-migration.md).