Files

T

ealmeida faef9b47dc fix(project-manager): remover Dify KB das descriptions, marcar nota TODO

Dify foi removido 06-03-2026. Skills brainstorm/discover ainda referenciam-no
no corpo. Bump v1.2 + nota top-of-file. Reescrita workflow para próxima sessão.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-07 04:52:03 +01:00

2.9 KiB

Raw Blame History

name, description

name	description
scope	Validação de scope que verifica se o trabalho está dentro do spec e detecta scope creep.

/scope v1.0 - Validacao de Scope

Check rapido: "o trabalho que estou a fazer esta dentro do que combinámos?"

Comandos

Comando	Funcao
`/scope`	Check rapido (1-3 linhas)
`/scope detail`	Analise detalhada com mapeamento ficheiros-scope

Protocolos

`/scope` (check rapido)

1. Procurar SPEC.md:
   - Directorio actual, depois pais (max 5 niveis)
   - Parar em /media/ealmeida/Dados/Dev ou /media/ealmeida/Dados
2. SE nao encontrado:
   "Sem SPEC.md. A trabalhar sem contrato de scope."
   PARAR.
3. SE encontrado mas nao aprovado:
   "Spec em draft (nao aprovado). Tratando como guia."
4. Parse SPEC.md:
   - Items "Faz" (scope in)
   - Items "Nao Faz" (scope out)
5. Analisar trabalho recente:
   a. Se git repo:
      - git diff --stat (uncommitted changes)
      - git diff --stat HEAD~3..HEAD (ultimos 3 commits)
   b. Se nao git: ficheiros modificados nas ultimas 2h (via stat)
6. Classificar cada ficheiro modificado:
   - Corresponde a item do scope -> OK
   - Mencionado em "Nao Faz" -> ALERTA
   - Nao mencionado -> WARN (potencial creep)
7. Output rapido:

   SE tudo OK:
   "Dentro do spec. X/Y scope items em progresso."

   SE ha alertas:
   "SCOPE ALERT: [N] ficheiros modificados fora do spec."
   "  - [ficheiro1]: nao mencionado no spec"
   "  - [ficheiro2]: esta em 'Nao Faz'"
   "Considere /spec update ou criar novo spec."

`/scope detail`

1. Executar tudo de /scope
2. ADICIONAR mapeamento detalhado:

   ---
   ## Scope Detail: [titulo do spec]

   ### Mapeamento Scope -> Ficheiros

   | Scope Item | Ficheiros Associados | Status |
   |-----------|---------------------|--------|
   | Item 1 | a.php, b.js | Em progresso |
   | Item 2 | - | Nao iniciado |

   ### Ficheiros Fora do Scope

   | Ficheiro | Tipo Alteracao | Possivel Motivo |
   |----------|---------------|-----------------|
   | c.css | Modificado | Refactoring nao planeado? |
   | d.php | Novo | Feature nova? |

   ### Criterios de Aceitacao

   | Criterio | Verificavel? | Estado |
   |----------|-------------|--------|
   | DADO X QUANDO Y ENTAO Z | Sim | Pendente |

   ### Recomendacao
   - [O que fazer com o trabalho fora do scope]
   - [Criar novo spec? Actualizar existente? Reverter?]
   ---

Regras

/scope deve ser RAPIDO (segundos, nao minutos)
Nao modificar nenhum ficheiro - apenas leitura e analise
Ser factual - reportar o que ve, nao julgar
Scope creep nao e mau por si - e mau quando nao e detectado
Sugerir solucoes (update spec, criar novo) nao apenas reportar problemas

Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

{"date":"","issue":"","fix":"","source":"user|auto"}

Adicionar nova linha após cada erro corrigido.

2.9 KiB Raw Blame History