---
name: asdlc_dashboard
description: Skill para gerar e interpretar o dashboard visual interativo do projeto A-SDLC diretamente do modo agentic.
---

# 📊 Skill: A-SDLC Dashboard

Esta skill capacita o agente a gerar e interpretar o dashboard visual interativo do projeto A-SDLC diretamente do modo agentic — sem qualquer instalação ou servidor.

## 🧭 Quando Usar

- Quando o usuário pedir uma **visão geral do projeto** ("como estão as stories?", "qual o progresso?").
- Quando for necessário **apresentar o status do projeto** para stakeholders ou reviews gerenciais.
- Quando o usuário quiser **inspecionar visualmente** o backlog, o burndown ou a conformidade A-SDLC.
- Ao início de uma sessão para **reorientar o contexto** antes de executar stories.

## 🛠️ Procedimento Interno (Mental Model)

### 1. Detectar Modo de Execução (OBRIGATÓRIO)

Antes de qualquer ação, o agente DEVE verificar se o `main.py` existe na raiz do projeto:

```
SE main.py existir na raiz E pasta asdlc/ existir:
    → Usar MODO PYTHON (HTML interativo)
SENÃO:
    → Usar MODO TEXTO (resumo no chat)
```

### 2a. MODO PYTHON — HTML Interativo

Execute:
```bash
python main.py dashboard --no-open
```

O arquivo é gerado em `.asdlc/dashboard/dashboard.html`.

Após a geração, reporte ao usuário conforme o **Formato de Resposta** abaixo.

### 2b. MODO TEXTO — Resumo no Chat (sem Python)

Quando `main.py` não estiver disponível, o agente DEVE:

1. Usar ferramentas de leitura de arquivos para listar `stories/` recursivamente (excluindo `MEMORY.md` e arquivos de template).
2. Para cada story, ler o frontmatter YAML e extrair: `title`, `status`, `depends_on`.
3. Contar tasks `- [x]` e `- [ ]` no conteúdo.
4. Calcular as métricas manualmente e reportar no formato abaixo.

### 3. Reportar ao Usuário

Após a geração bem-sucedida, o agente DEVE:

1. **Confirmar o caminho** do arquivo gerado.
2. **Resumir as métricas** lidas da saída do comando:
   - Total de stories / concluídas / pendentes
   - Progresso geral (% de tasks marcadas)
   - Conformidade A-SDLC (% de stories com critérios de aceitação)
3. **Instruir como abrir**: informar ao usuário que pode abrir o arquivo `.html` diretamente no browser.
4. **Sugerir próximos passos** com base nos dados (ex: stories bloqueadas, histórias sem critérios de aceitação).

### 4. Análise Proativa (Opcional mas Recomendada)

Se o agente tiver acesso de leitura às stories, DEVE analisar e reportar:

- **Stories bloqueadas**: têm `depends_on` cujas dependências ainda não estão `CONCLUÍDO`.
- **Stories sem conformidade**: não têm seção de "Critérios de Aceitação".
- **Velocity trend**: stories concluídas recentemente vs. semanas anteriores.

## 📋 Formato de Resposta Esperado

```
✅ Dashboard gerado: .asdlc/dashboard/dashboard.html

📊 Resumo do Projeto — [Nome do Projeto]
─────────────────────────────────────────
  Stories:        N total · X concluídas · Y pendentes
  Progresso:      Z% (tasks marcadas)
  Conformidade:   W% (stories com critérios de aceitação)

⚠️  Atenção:
  - Story "XXX" está bloqueada por: [dependência]
  - Story "YYY" não tem critérios de aceitação

💡 Abra o dashboard no browser:
   .asdlc/dashboard/dashboard.html
```

## 🚫 Anti-Patterns

- **Não invente métricas**: sempre leia os dados das stories reais.
- **Não abra o browser automaticamente** no modo agentic (use `--no-open`).
- **Não gere o dashboard sem stories**: informe o usuário e sugira `/asdlc-create-story`.

## 💡 Comandos Relacionados

- `/asdlc-dashboard` → Gera e resume o dashboard (este workflow).
- `/asdlc-create-story` → Cria novas stories para alimentar o dashboard.
- `/asdlc-execute` → Implementa stories pendentes para melhorar o progresso.

---
*A-SDLC Native Agentic Mode — Dashboard Skill v1.0*