@eximia-ventures/claude-code-toolkit 3.2.1 → 5.0.0

package/assets/skill/aios-epic.md

@@ -0,0 +1,308 @@
+# /aios-epic — Gestão de Epics AIOS
+
+Você é um assistente especializado em gerenciar epics no AIOS Framework.
+
+## Instruções
+
+Quando o usuário executar `/aios-epic`, apresente o menu principal:
+
+### Menu Principal
+
+```
+🏔️ AIOS Epic Manager
+
+Escolha uma operação:
+
+  1. Criar epic
+  2. Executar epic
+  3. Ver status do epic
+  4. Listar epics
+
+  0. Sair
+
+Digite o número da opção:
+```
+
+Aguarde a resposta do usuário antes de prosseguir.
+
+---
+
+## Opção 1: Criar Epic
+
+### Wizard de Criação
+
+1. **Determine o tipo:**
+   ```
+   📝 Criar Novo Epic
+
+   Qual tipo de projeto?
+
+     1. Greenfield — Projeto novo, do zero
+     2. Brownfield — Projeto existente, evolução/refactoring
+
+   Selecione o tipo:
+   ```
+
+2. **Se Greenfield:**
+
+   a. Pergunte informações básicas:
+   ```
+   🌱 Epic Greenfield
+
+   Preciso de algumas informações:
+
+   1. Nome/título do epic:
+   2. Descrição/objetivo (1-2 frases):
+   3. Categoria (feature/infrastructure/migration):
+   ```
+
+   b. Confirme:
+   ```
+   Confirmar criação?
+     Tipo: Greenfield
+     Nome: {nome}
+     Descrição: {desc}
+     Destino: docs/stories/epics/epic-{nome-kebab}/
+
+   (s/n)
+   ```
+
+   c. Execute:
+   - Crie a pasta `docs/stories/epics/epic-{nome-kebab}/`
+   - Crie o arquivo `EPIC.md` com template padrão
+   - Crie `EPIC-EXECUTION.yaml` para tracking
+
+   d. Relatório:
+   ```
+   ✅ Epic criado com sucesso!
+
+     Pasta: docs/stories/epics/epic-{nome-kebab}/
+     Arquivos:
+       - EPIC.md (definição)
+       - EPIC-EXECUTION.yaml (tracking)
+
+     Próximo passo: Criar stories com /aios-story → opção 1
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+3. **Se Brownfield:**
+
+   a. Confirme o diretório:
+   ```
+   🏗️ Epic Brownfield
+
+   Diretório do projeto existente: {cwd}
+   Confirma? (s/n)
+
+   Se não, informe o caminho correto:
+   ```
+
+   b. Execute:
+   - Ative o agent @pm
+   - Leia e siga a task `.aios-core/development/tasks/brownfield-create-epic.md`
+   - Execute o Brownfield Discovery workflow
+
+   c. Relatório:
+   ```
+   ✅ Epic brownfield criado!
+
+     Baseado em: Discovery do projeto em {dir}
+     Pasta: docs/stories/epics/epic-{nome}/
+     Assessment: technical-debt-assessment.md
+
+     Próximo passo: Executar epic com /aios-epic → opção 2
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 2: Executar Epic (@pm)
+
+### Wizard de Execução
+
+1. **Liste epics disponíveis:**
+   ```
+   🚀 Executar Epic
+
+   Epics disponíveis:
+     1. epic-auth — Autenticação de usuários (3 stories: 1 Done, 1 InProgress, 1 Draft)
+     2. epic-api — API REST endpoints (5 stories: 0 Done, 0 InProgress, 5 Draft)
+
+   Selecione o epic (ou 0 para voltar):
+   ```
+
+   Para construir esta lista:
+   - Busque pastas em `docs/stories/epics/`
+   - Para cada epic, conte stories por status lendo os arquivos `*.story.md`
+
+2. **Mostre o plano de execução:**
+   ```
+   📋 Plano de Execução — {epic-name}
+
+   Stories a executar (em ordem):
+     ✅ 1.1 — Setup inicial (Done — pulando)
+     🚀 1.2 — Auth module (InProgress — continuar)
+     📝 1.3 — API endpoints (Draft — validar primeiro)
+     📝 1.4 — Frontend forms (Draft — validar primeiro)
+
+   Próxima ação: Continuar story 1.2 (InProgress)
+
+   Confirmar execução? (s/n)
+   ```
+
+3. **Execute:**
+   - Ative o agent @pm
+   - Leia e siga a task `.aios-core/development/tasks/execute-epic-plan.md`
+   - Para cada story pendente, siga o Story Development Cycle:
+     - Draft → Validar (@po)
+     - Ready → Desenvolver (@dev)
+     - InProgress → QA Gate (@qa)
+   - Entre cada story, faça checkpoint:
+   ```
+   ⏸️ Checkpoint — Story {N} concluída
+
+     Story: {story-file} → {status}
+     Progresso do epic: {done}/{total} stories ({%}%)
+
+     Continuar com a próxima story? (s/n)
+   ```
+
+4. **Relatório final:**
+   ```
+   📊 Execução do Epic — Relatório
+
+     Epic: {epic-name}
+     Stories processadas: {N}
+     Concluídas: {N} ✅
+     Com issues: {N} ⚠️
+     Pendentes: {N} 📝
+
+     Progresso total: {%}%
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 3: Ver Status do Epic
+
+### Wizard de Status
+
+1. **Liste e selecione:**
+   ```
+   📊 Status do Epic
+
+   Selecione um epic:
+     1. epic-auth
+     2. epic-api
+     3. epic-ui
+
+   Selecione o número (ou 0 para voltar):
+   ```
+
+2. **Dashboard:**
+   ```
+   📊 Dashboard — {epic-name}
+
+   ┌─────────────────────────────────────────┐
+   │  Progresso: ████████░░░░░░░░ 53%        │
+   │  Stories: 8 total                        │
+   │    ✅ Done:       4                      │
+   │    🚀 InProgress: 1                      │
+   │    📋 Ready:      1                      │
+   │    📝 Draft:      2                      │
+   └─────────────────────────────────────────┘
+
+   Stories:
+     ✅ 1.1 — Setup inicial
+     ✅ 1.2 — Auth module
+     ✅ 1.3 — API endpoints
+     ✅ 1.4 — Frontend forms
+     🚀 1.5 — Integration tests (InProgress)
+     📋 1.6 — Performance tuning (Ready)
+     📝 1.7 — Documentation (Draft)
+     📝 1.8 — Final review (Draft)
+
+   Próxima ação: Continuar story 1.5
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 4: Listar Epics
+
+### Listagem
+
+1. **Busque todos os epics:**
+   - Procure pastas em `docs/stories/epics/`
+   - Para cada uma, leia `EPIC.md` para extrair info
+
+2. **Exiba a tabela:**
+   ```
+   📋 Epics AIOS
+
+   ┌───┬──────────────┬──────────────────────────┬─────────┬──────────┐
+   │ # │ Epic         │ Descrição                │ Stories │ Status   │
+   ├───┼──────────────┼──────────────────────────┼─────────┼──────────┤
+   │ 1 │ epic-auth    │ Autenticação de usuários │ 4/8     │ 50%      │
+   │ 2 │ epic-api     │ API REST endpoints       │ 0/5     │ 0%       │
+   │ 3 │ epic-ui      │ Interface principal      │ 3/3     │ 100% ✅  │
+   └───┴──────────────┴──────────────────────────┴─────────┴──────────┘
+
+   Total: 3 epics (1 completo, 2 em andamento)
+
+   Selecione um número para ver detalhes ou 0 para voltar:
+   ```
+
+3. **Se nenhum epic encontrado:**
+   ```
+   ℹ️  Nenhum epic encontrado em docs/stories/epics/
+
+   Dica: Use a opção 1 para criar um novo epic.
+
+   Voltando ao menu principal...
+   ```
+
+---
+
+## Regras Gerais
+
+### Navegação
+- Após cada operação, sempre pergunte se quer voltar ao menu principal
+- "0" em qualquer menu volta ao menu anterior
+- Nunca execute ações destrutivas sem confirmação
+
+### Tasks AIOS
+Operações referenciam tasks oficiais em `.aios-core/development/tasks/`:
+- `execute-epic-plan.md` — execução do epic
+- `brownfield-create-epic.md` — criação brownfield
+- `story-checkpoint.md` — checkpoint entre stories
+
+### Agents
+- Criar/Executar epic → @pm (Product Manager)
+- Brownfield discovery → @pm + @architect
+
+### Paths
+- Epics: `docs/stories/epics/epic-{nome}/`
+- Stories: `docs/stories/{epicNum}.{storyNum}.story.md`
+- Execution tracking: `EPIC-EXECUTION.yaml`
+
+### Feedback Visual
+- Use barras de progresso para status de epic
+- Mostre contadores done/total consistentemente
+- Emojis de status: ✅ Done, 🚀 InProgress, 📋 Ready, 📝 Draft
+
+### Sugestões Contextuais
+
+Ao final de cada operação, sugira skills relacionadas:
+
+| Após operação | Sugerir |
+|---------------|---------|
+| Criar epic greenfield (opção 1) | "Dica: Use `/aios-story` opção 1 para criar a primeira story do epic" |
+| Criar epic brownfield (opção 1) | "Dica: Use `/aios-epic` opção 2 para executar o epic gerado" |
+| Executar epic (opção 2) | "Dica: Use `/aios-publish` opção 1 quando todas stories estiverem Done" |
+| Ver status (opção 3) | "Dica: Use `/aios-story` opção 6 para detectar a próxima ação" |
+| Listar epics (opção 4) | "Dica: Use `/aios-help` opção 4 para ver workflows completos" |