O que prd-sdd-studio-skill faz?
Skill para Claude Code / Codex: consulta de PRD → arquitetura SDD → geração automática de diagramas → planejamento de TASK.md → desenvolvimento passo a passo, com detecção de retomada, CHANGELOG, sincronização git e ponte de sincronização de documentos.
Visão Geral
Este skill é um estúdio de desenvolvimento de software orientado a documentação, executado diretamente no terminal via Claude Code ou Codex. Ele organiza todo o ciclo de vida de um projeto, desde a concepção dos requisitos até a implementação, garantindo que a documentação esteja sempre atualizada e sincronizada com o código.
Fluxo de Trabalho
- PRD (Product Requirements Document): O agente ajuda a consultar e refinar os requisitos do produto, gerando um PRD detalhado.
- SDD (Software Design Document): Com base no PRD, é elaborado um SDD com a arquitetura do sistema, componentes e decisões técnicas.
- Diagramas de Arquitetura: Automaticamente, são gerados diagramas (ASCII ou Mermaid) para visualizar a estrutura do sistema.
- TASK.md: Um plano de desenvolvimento é criado, dividido em tarefas menores e organizado em um arquivo TASK.md.
- Desenvolvimento Passo a Passo: O agente executa cada tarefa sequencialmente, com suporte a detecção de retomada (se interrompido, retoma de onde parou).
- CHANGELOG: Cada alteração relevante é registrada automaticamente.
- Sincronização Git: O repositório é sincronizado com o Git (add, commit, push) após cada etapa.
- Ponte de Sincronização de Documentos: Mantém a documentação (PRD, SDD, TASK.md, CHANGELOG) sincronizada com o estado atual do código.
Como Usar
- Ative o skill no Claude Code ou Codex.
- Execute o comando de inicialização (ex:
/iniciar-projetoou conforme definido no skill). - Siga as instruções do agente para definir o PRD.
- O agente guiará você por todo o fluxo, gerando SDD, diagramas, TASK.md e desenvolvendo o código.
- Utilize
statuspara verificar o progresso econtinuarpara retomar caso interrompido.
Comandos
iniciar: Inicia um novo projeto.continuar: Retoma o desenvolvimento de onde parou.status: Exibe o progresso atual.sincronizar: Força a sincronização com Git e documentos.changelog: Mostra o histórico de alterações.
Requisitos
- Claude Code ou Codex configurado.
- Git instalado e configurado para o repositório do projeto.
- Conexão com a internet para sincronização remota (opcional).
Personalização
Você pode personalizar o fluxo editando os arquivos gerados (PRD.md, SDD.md, TASK.md) conforme necessário. O skill respeitará as alterações durante a retomada.