up-cc 0.2.1 → 0.2.3

package/agents/up-roteirista.md

@@ -272,6 +272,17 @@ Se research/SUMMARY.md fornecido:
 - Note flags de pesquisa
 - Use como input, nao mandato
 
+## Passo 3.5: Identificar Funcionalidades Existentes (Brownfield)
+Se codebase docs existem (.plano/codebase/ARCHITECTURE.md, STACK.md):
+1. Ler ARCHITECTURE.md e extrair funcionalidades ja implementadas
+2. Agrupar funcionalidades em fases macro por dominio (3-6 max)
+3. Criar fases existentes com:
+   - Status: checkbox marcado `[x]`
+   - Sufixo: `- Existente`
+   - Sem criterios de sucesso (nao foram planejados/executados via UP)
+   - Sem requisitos mapeados (sao requisitos validados, nao ativos)
+4. Numerar fases novas APOS as existentes
+
 ## Passo 4: Identificar Fases
 Aplique metodologia de identificacao de fases:
 1. Agrupe requisitos por fronteiras naturais de entrega
@@ -355,6 +366,74 @@ Se feedback de revisao fornecido:
 ```
 </structured_returns>
 
+<brownfield_phases>
+
+## Fases Existentes (Brownfield)
+
+Quando o projeto e brownfield (codebase existente), o roteiro deve comecar com fases que representam o que JA EXISTE. Estas fases nao foram planejadas/executadas via UP — elas representam funcionalidades ja implementadas.
+
+### Regras
+
+1. **Agrupar por dominio, nao por feature individual** — Max 3-6 fases existentes
+2. **Status "Existente"** — Diferente de "Complete" (nunca foi planejado/executado via UP)
+3. **Checkbox marcado** `[x]` — Visualmente indica que ja esta pronto
+4. **Sem criterios de sucesso** — Nao foram derivados via goal-backward
+5. **Sem planos** — Nao foram planejados
+6. **Fases novas vem APOS** — Numeracao continua das existentes
+
+### Exemplo
+
+```markdown
+## Fases
+
+- [x] **Fase 1: Autenticacao e usuarios** - Existente
+- [x] **Fase 2: Chat e atendimento** - Existente
+- [x] **Fase 3: Dashboard e metricas** - Existente
+- [ ] **Fase 4: Filtro de usuarios no chat** - Nova feature
+- [ ] **Fase 5: Relatorios avancados** - Nova feature
+
+## Detalhes das Fases
+
+### Fase 1: Autenticacao e usuarios
+**Status**: Existente
+**Funcionalidades**: Login, cadastro, perfis, permissoes
+**Planos**: N/A (pre-existente)
+
+### Fase 2: Chat e atendimento
+**Status**: Existente
+**Funcionalidades**: Chat em tempo real, filas de atendimento, historico
+**Planos**: N/A (pre-existente)
+
+### Fase 3: Dashboard e metricas
+**Status**: Existente
+**Funcionalidades**: Dashboard principal, metricas de atendimento
+**Planos**: N/A (pre-existente)
+
+### Fase 4: Filtro de usuarios no chat
+**Objetivo**: Permitir filtrar usuarios por criterios no chat
+**Depende de**: Fase 2
+**Requisitos**: CHAT-01, CHAT-02
+**Criterios de Sucesso** (o que deve ser VERDADE):
+  1. Atendente pode filtrar usuarios por nome, email ou status
+  2. Filtros persistem entre sessoes
+**Planos**: TBD
+```
+
+### Na Tabela de Progresso
+
+Fases existentes aparecem como completas sem planos:
+
+```markdown
+| Fase | Planos Completos | Status | Completado |
+|------|-----------------|--------|------------|
+| 1. Autenticacao e usuarios | N/A | Existente | Pre-existente |
+| 2. Chat e atendimento | N/A | Existente | Pre-existente |
+| 3. Dashboard e metricas | N/A | Existente | Pre-existente |
+| 4. Filtro de usuarios no chat | 0/2 | Nao iniciado | - |
+```
+
+</brownfield_phases>
+
 <anti_patterns>
 
 **Nao imponha estrutura arbitraria:**

package/commands/ajuda.md

@@ -48,6 +48,7 @@ Sistema de desenvolvimento orientado a fases para projetos de software.
 | `/up:pausar` | Criar handoff .continue-aqui.md | `/up:pausar` |
 | `/up:adicionar-fase` | Adicionar fase ao roadmap | `/up:adicionar-fase "Deploy em producao"` |
 | `/up:remover-fase` | Remover fase futura e renumerar | `/up:remover-fase 5` |
+| `/up:resetar` | Resetar projeto (limpar .plano/) | `/up:resetar` |
 
 ### Utilitarios
 

package/commands/resetar.md

@@ -0,0 +1,27 @@
+---
+name: up:resetar
+description: Resetar projeto UP (limpar .plano/ parcial ou totalmente)
+argument-hint: [--total | --parcial]
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - AskUserQuestion
+---
+
+<objective>
+Resetar o diretorio `.plano/` para comecar novamente. Oferece reset total (apaga tudo) ou parcial (mantém PROJECT.md e config.json).
+
+**Default flow:** Diagnosticar -> Mostrar o que sera apagado -> Confirmar -> Executar -> Sugerir proximo passo
+</objective>
+
+<execution_context>
+@$HOME/.claude/up/workflows/resetar.md
+@$HOME/.claude/up/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute o workflow resetar de @$HOME/.claude/up/workflows/resetar.md end-to-end.
+Preserve todos os gates (diagnostico, confirmacao, execucao).
+NUNCA apague sem confirmacao explicita do usuario.
+</process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "up-cc",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
   "bin": {
     "up-cc": "bin/install.js"

package/templates/roadmap.md

@@ -127,5 +127,45 @@ Phases execute in numeric order: 2 -> 2.1 -> 2.2 -> 3 -> 3.1 -> 4
 - `Not started` - Haven't begun
 - `In progress` - Currently working
 - `Complete` - Done (add completion date)
+- `Existing` - Pre-existing functionality (brownfield only, never planned/executed via UP)
 - `Deferred` - Pushed to later (with reason)
 </status_values>
+
+<brownfield_example>
+For brownfield projects, existing functionality is grouped into completed phases before new work:
+
+```markdown
+## Phases
+
+- [x] **Phase 1: Authentication and users** - Existing
+- [x] **Phase 2: Core content** - Existing
+- [ ] **Phase 3: New feature** - [One-line description]
+
+## Phase Details
+
+### Phase 1: Authentication and users
+**Status**: Existing
+**Features**: Login, registration, profiles, permissions
+**Plans**: N/A (pre-existing)
+
+### Phase 2: Core content
+**Status**: Existing
+**Features**: CRUD operations, search, categories
+**Plans**: N/A (pre-existing)
+
+### Phase 3: New feature
+**Goal**: [What this phase delivers]
+**Depends on**: Phase 2
+**Requirements**: [REQ-01, REQ-02]
+**Success Criteria** (what must be TRUE):
+  1. [Observable behavior from user perspective]
+**Plans**: TBD
+```
+
+Guidelines for existing phases:
+- Group by domain, not individual features (max 3-6 existing phases)
+- No success criteria (not derived via goal-backward)
+- No plans (not planned/executed via UP)
+- New phases numbered after existing ones
+- Progress table shows "Existing" status and "N/A" for plans
+</brownfield_example>

package/workflows/novo-projeto.md

@@ -612,7 +612,11 @@ Criar roteiro:
 6. Retornar ROADMAP CREATED com resumo
 
 **Se projeto brownfield:**
-- Considerar divida tecnica de CONCERNS.md ao priorizar fases
+- Ler .plano/codebase/ARCHITECTURE.md e .plano/codebase/STACK.md para entender o que ja existe
+- Agrupar funcionalidades existentes em fases macro concluidas (max 3-6 fases, por dominio)
+- Fases existentes usam checkbox marcado [x], status "Existente", sem criterios de sucesso, sem planos
+- Numerar fases NOVAS apos as existentes (ex: se 3 fases existentes, nova fase comeca em 4)
+- Considerar divida tecnica de CONCERNS.md ao priorizar fases novas
 - Respeitar convencoes existentes de CONVENTIONS.md
 - Fases de refatoracao/correcao devem vir antes de features que dependem delas
 

package/workflows/resetar.md

@@ -0,0 +1,186 @@
+<trigger>
+Use este workflow quando:
+- Usuario quer recomecar o projeto do zero
+- Usuario quer limpar .plano/ e reinicializar
+- Usuario diz "resetar", "limpar", "recomecar", "apagar plano"
+</trigger>
+
+<purpose>
+Limpar o diretorio .plano/ de forma segura, com confirmacao explicita, para permitir reinicializacao do projeto.
+</purpose>
+
+<process>
+
+<step name="diagnosticar">
+Verificar o que existe em .plano/:
+
+```bash
+# Verificar se .plano/ existe
+ls -la .plano/ 2>/dev/null
+
+# Contar arquivos por tipo
+echo "---"
+find .plano/ -name "*.md" 2>/dev/null | wc -l
+find .plano/ -name "*.json" 2>/dev/null | wc -l
+ls -d .plano/fases/*/ 2>/dev/null | wc -l
+
+# Listar fases
+ls -d .plano/fases/*/ 2>/dev/null
+
+# Verificar artefatos principais
+ls .plano/PROJECT.md .plano/ROADMAP.md .plano/STATE.md .plano/config.json .plano/REQUIREMENTS.md 2>/dev/null
+
+# Verificar subdiretorios
+ls -d .plano/pesquisa/ .plano/codebase/ .plano/fases/ .plano/rapido/ 2>/dev/null
+```
+
+**Se .plano/ nao existe:**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > RESETAR
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Nenhum diretorio .plano/ encontrado. Nada para resetar.
+
+-> /up:novo-projeto para inicializar
+```
+
+Sair.
+</step>
+
+<step name="mostrar_estado">
+Apresentar o que existe:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > RESETAR
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Conteudo de .plano/:
+
+| Artefato | Status |
+|----------|--------|
+| PROJECT.md | ✓ / ✗ |
+| ROADMAP.md | ✓ / ✗ |
+| STATE.md | ✓ / ✗ |
+| REQUIREMENTS.md | ✓ / ✗ |
+| config.json | ✓ / ✗ |
+| Fases | N diretorios |
+| Pesquisa | ✓ / ✗ |
+| Codebase map | ✓ / ✗ |
+| Tarefas rapidas | N tarefas |
+```
+</step>
+
+<step name="escolher_modo">
+
+Verificar se argumento --total ou --parcial foi passado. Se sim, pular para confirmacao com o modo correspondente.
+
+Se nenhum argumento, perguntar:
+
+Use AskUserQuestion:
+- header: "Tipo de reset"
+- question: "Como voce quer resetar?"
+- options:
+  - "Reset total" -- Apagar .plano/ inteiro. Comecar do zero absoluto.
+  - "Reset parcial" -- Manter PROJECT.md e config.json. Apagar fases, roadmap, state, pesquisa.
+  - "Cancelar" -- Nao apagar nada.
+
+**Se "Cancelar":** Sair.
+
+**Se "Reset parcial":**
+Sera apagado:
+- .plano/ROADMAP.md
+- .plano/STATE.md
+- .plano/REQUIREMENTS.md
+- .plano/fases/ (todos os diretorios de fase)
+- .plano/pesquisa/ (toda a pesquisa)
+- .plano/rapido/ (tarefas rapidas)
+
+Sera mantido:
+- .plano/PROJECT.md (contexto do projeto)
+- .plano/config.json (preferencias de workflow)
+- .plano/codebase/ (mapeamento do codebase, se existir)
+
+**Se "Reset total":**
+Sera apagado:
+- .plano/ inteiro (tudo)
+</step>
+
+<step name="confirmar">
+
+╔══════════════════════════════════════════════════════════════╗
+║  CHECKPOINT: Confirmacao Obrigatoria                         ║
+╚══════════════════════════════════════════════════════════════╝
+
+Use AskUserQuestion:
+- header: "Confirmar reset"
+- question: "[Reset total/parcial] -- Esta acao e IRREVERSIVEL. [N] arquivos serao apagados. Confirmar?"
+- options:
+  - "Confirmar reset" -- Apagar agora
+  - "Cancelar" -- Nao apagar nada
+
+**Se "Cancelar":** Sair.
+</step>
+
+<step name="executar">
+
+**Reset total:**
+```bash
+rm -rf .plano/
+```
+
+**Reset parcial:**
+```bash
+rm -f .plano/ROADMAP.md .plano/STATE.md .plano/REQUIREMENTS.md
+rm -rf .plano/fases/ .plano/pesquisa/ .plano/rapido/
+```
+
+Verificar que a limpeza foi feita:
+```bash
+ls -la .plano/ 2>/dev/null || echo "REMOVIDO"
+```
+</step>
+
+<step name="resultado">
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > RESET CONCLUIDO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[Se total:]
+Diretorio .plano/ removido completamente.
+
+[Se parcial:]
+Fases, roadmap e pesquisa removidos.
+Mantidos: PROJECT.md, config.json[, codebase/]
+```
+
+---
+
+## Proximo
+
+**Se reset total:**
+
+`/up:novo-projeto` -- inicializar projeto do zero
+
+**Se reset parcial:**
+
+`/up:novo-projeto` -- vai detectar PROJECT.md existente e oferecer "Revisar e atualizar"
+
+<sub>`/clear` primeiro -> janela de contexto limpa</sub>
+
+---
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Estado atual de .plano/ diagnosticado
+- [ ] Usuario informado do que sera apagado
+- [ ] Confirmacao explicita obtida antes de qualquer delecao
+- [ ] Reset executado conforme modo escolhido
+- [ ] Proximo passo sugerido
+</success_criteria>