up-cc 0.1.0

package/commands/adicionar-fase.md

@@ -0,0 +1,33 @@
+---
+name: up:adicionar-fase
+description: Adicionar fase ao final do roadmap
+argument-hint: "<descricao>"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+---
+<objective>
+Add a new phase to the end of the project roadmap.
+
+**Flow:** Parse description -> Call `up-tools.cjs phase add` -> Update STATE.md -> Present result
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/adicionar-fase.md
+</execution_context>
+
+<context>
+Phase description: $ARGUMENTS
+
+Adds a new phase to ROADMAP.md at the end of the existing phase list.
+</context>
+
+<process>
+1. Parse the phase description from arguments.
+2. Call `up-tools.cjs phase add` with the description.
+3. Update STATE.md to reflect the new phase.
+4. Present the result showing the new roadmap state.
+</process>

package/commands/ajuda.md

@@ -0,0 +1,131 @@
+---
+name: up:ajuda
+description: Referencia de comandos UP
+argument-hint: ""
+allowed-tools: []
+---
+<objective>
+Exibir a referencia completa de comandos UP.
+</objective>
+
+<context>
+Referencia inline -- nenhum arquivo externo necessario.
+</context>
+
+<process>
+Exiba a referencia abaixo EXATAMENTE como esta, formatada em markdown:
+
+---
+
+# UP -- Referencia de Comandos
+
+Sistema de desenvolvimento orientado a fases para projetos de software.
+
+## Comandos Disponiveis
+
+### Inicializacao
+
+| Comando | Descricao | Uso |
+|---------|-----------|-----|
+| `/up:novo-projeto` | Inicializar novo projeto com coleta de contexto | `/up:novo-projeto` |
+| `/up:retomar` | Restaurar contexto da sessao anterior | `/up:retomar` |
+
+### Ciclo de Fase
+
+| Comando | Descricao | Uso |
+|---------|-----------|-----|
+| `/up:discutir-fase` | Coletar contexto por questionamento | `/up:discutir-fase 1` |
+| `/up:planejar-fase` | Planejar fase com research e self-check | `/up:planejar-fase 1` |
+| `/up:executar-fase` | Executar planos com paralelizacao por ondas | `/up:executar-fase 1` |
+| `/up:verificar-trabalho` | Validar features via UAT conversacional | `/up:verificar-trabalho 1` |
+
+### Gerenciamento
+
+| Comando | Descricao | Uso |
+|---------|-----------|-----|
+| `/up:progresso` | Status do projeto e proxima acao | `/up:progresso` |
+| `/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` |
+
+### Utilitarios
+
+| Comando | Descricao | Uso |
+|---------|-----------|-----|
+| `/up:rapido` | Tarefa rapida com garantias UP | `/up:rapido "Corrigir bug no login"` |
+| `/up:ajuda` | Esta referencia | `/up:ajuda` |
+
+## Flags Comuns
+
+### planejar-fase
+- `--pesquisar` -- Forcar re-pesquisa mesmo se RESEARCH.md existir
+- `--sem-pesquisa` -- Pular pesquisa, ir direto ao planejamento
+- `--auto` -- Auto-detectar proxima fase nao planejada
+- `--gaps` -- Modo fechamento de gaps (le VERIFICATION.md)
+
+### executar-fase
+- `--gaps-only` -- Executar apenas planos de fechamento de gaps
+
+## Estrutura do Diretorio .plano/
+
+```
+.plano/
+  STATE.md              # Estado atual do projeto
+  ROADMAP.md            # Roadmap com todas as fases
+  fase-01-nome/
+    CONTEXT.md          # Contexto coletado na discussao
+    RESEARCH.md         # Pesquisa de dominio/tecnologia
+    PLAN-001.md         # Plano executavel
+    PLAN-002.md         # Outro plano da fase
+    VERIFICATION.md     # Resultado da verificacao
+  fase-02-nome/
+    ...
+  rapido/
+    TASK-001.md         # Tarefa rapida executada
+    ...
+```
+
+## Fluxos de Trabalho Comuns
+
+### Novo Projeto (do zero)
+```
+/up:novo-projeto
+/up:discutir-fase 1
+/up:planejar-fase 1
+/up:executar-fase 1
+/up:verificar-trabalho 1
+```
+
+### Continuar Projeto Existente
+```
+/up:retomar
+/up:progresso
+```
+
+### Correcao Rapida
+```
+/up:rapido "Descricao da tarefa"
+```
+
+### Pausar e Retomar
+```
+/up:pausar          # Ao pausar
+/up:retomar         # Na proxima sessao
+```
+
+### Adicionar/Remover Fases
+```
+/up:adicionar-fase "Descricao da nova fase"
+/up:remover-fase 5
+```
+
+### Ciclo de Fechamento de Gaps
+```
+/up:verificar-trabalho 1     # Identifica gaps
+/up:planejar-fase 1 --gaps   # Planeja correcoes
+/up:executar-fase 1 --gaps-only  # Executa correcoes
+/up:verificar-trabalho 1     # Re-verifica
+```
+
+---
+</process>

package/commands/discutir-fase.md

@@ -0,0 +1,35 @@
+---
+name: up:discutir-fase
+description: Coletar contexto da fase por questionamento antes do planejamento
+argument-hint: "<fase>"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+<objective>
+Collect phase context through structured questioning before planning begins.
+
+**Default flow:** Load phase info -> Ask targeted questions -> Capture decisions -> Write CONTEXT.md
+
+**Orchestrator role:** Read roadmap phase description, ask clarifying questions about scope/approach/constraints, capture all decisions and assumptions in CONTEXT.md for the planner to consume.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/discutir-fase.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS
+
+Discussion surfaces assumptions, clarifies gray areas, and captures decisions before planning.
+</context>
+
+<process>
+Execute the discutir-fase workflow from @~/.claude/up/workflows/discutir-fase.md end-to-end.
+Preserve all workflow gates (phase validation, questioning, decision capture, CONTEXT.md creation).
+</process>

package/commands/executar-fase.md

@@ -0,0 +1,40 @@
+---
+name: up:executar-fase
+description: Executar todos os planos de uma fase com paralelizacao por ondas
+argument-hint: "<fase> [--gaps-only]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Execute all plans in a phase using wave-based parallel execution.
+
+Orchestrator stays lean: discover plans, analyze dependencies, group into waves, spawn subagents, collect results. Each subagent loads the full execute-plan context and handles its own plan.
+
+Context budget: ~15% orchestrator, 100% fresh per subagent.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/executar-fase.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS
+
+**Flags:**
+- `--gaps-only` -- Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verificar-trabalho creates fix plans.
+
+Context files are resolved inside the workflow and per-subagent `<files_to_read>` blocks.
+</context>
+
+<process>
+Execute the executar-fase workflow from @~/.claude/up/workflows/executar-fase.md end-to-end.
+Preserve all workflow gates (wave execution, checkpoint handling, verification, state updates, routing).
+</process>

package/commands/novo-projeto.md

@@ -0,0 +1,39 @@
+---
+name: up:novo-projeto
+description: Inicializar novo projeto com coleta de contexto e PROJECT.md
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - WebFetch
+  - WebSearch
+  - AskUserQuestion
+  - mcp__context7__*
+---
+<objective>
+Initialize a new project through structured context gathering and documentation.
+
+**Default flow:** Questioning -> Research -> Requirements -> Roadmap -> PROJECT.md
+
+**Orchestrator role:** Guide user through project discovery questions, research domain and technologies, synthesize requirements, generate phased roadmap, create PROJECT.md with all gathered context.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/novo-projeto.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+Project initialization collects context through interactive questioning before any planning or coding begins.
+</context>
+
+<process>
+Execute the novo-projeto workflow from @~/.claude/up/workflows/novo-projeto.md end-to-end.
+Preserve all workflow gates (questioning, research, requirements, roadmap generation, PROJECT.md creation).
+</process>

package/commands/pausar.md

@@ -0,0 +1,33 @@
+---
+name: up:pausar
+description: Criar handoff .continue-aqui.md ao pausar trabalho
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - AskUserQuestion
+---
+<objective>
+Create a handoff document when pausing work so the next session can resume seamlessly.
+
+**Default flow:** Capture current state -> Document in-progress work -> Write .continue-aqui.md -> Confirm
+
+**Orchestrator role:** Gather current task state, uncommitted changes, pending decisions, and next steps into a structured .continue-aqui.md handoff file.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/pausar.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+Creates .continue-aqui.md in the project root with all context needed to resume work.
+</context>
+
+<process>
+Execute the pausar workflow from @~/.claude/up/workflows/pausar.md end-to-end.
+Preserve all workflow gates (state capture, change detection, handoff creation, confirmation).
+</process>

package/commands/planejar-fase.md

@@ -0,0 +1,43 @@
+---
+name: up:planejar-fase
+description: Planejar fase com research inline e self-check
+argument-hint: "[fase] [--pesquisar] [--sem-pesquisa] [--auto] [--gaps]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - WebFetch
+  - mcp__context7__*
+---
+<objective>
+Create executable phase plans (PLAN.md files) for a roadmap phase with integrated research and self-check verification.
+
+**Default flow:** Research (if needed) -> Plan -> Verify -> Done
+
+**Orchestrator role:** Parse arguments, validate phase, research domain (unless skipped), generate plans, verify with self-check, iterate until pass or max iterations, present results.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/planejar-fase.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+Phase number: $ARGUMENTS (optional -- auto-detects next unplanned phase if omitted)
+
+**Flags:**
+- `--pesquisar` -- Force re-research even if RESEARCH.md exists
+- `--sem-pesquisa` -- Skip research, go straight to planning
+- `--auto` -- Auto-detect and plan next unplanned phase
+- `--gaps` -- Gap closure mode (reads VERIFICATION.md, skips research)
+
+Normalize phase input before any directory lookups.
+</context>
+
+<process>
+Execute the planejar-fase workflow from @~/.claude/up/workflows/planejar-fase.md end-to-end.
+Preserve all workflow gates (validation, research, planning, verification loop, routing).
+</process>

package/commands/progresso.md

@@ -0,0 +1,33 @@
+---
+name: up:progresso
+description: Status do projeto e roteamento para proxima acao
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+---
+<objective>
+Display current project status and route to the next recommended action.
+
+**Default flow:** Read STATE.md -> Analyze progress -> Show status dashboard -> Recommend next action
+
+**Orchestrator role:** Read project state, calculate completion percentages, identify current phase and blockers, present formatted status, suggest next UP command to run.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/progresso.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+Reads project state to provide a clear picture of where things stand and what to do next.
+</context>
+
+<process>
+Execute the progresso workflow from @~/.claude/up/workflows/progresso.md end-to-end.
+Preserve all workflow gates (state reading, progress calculation, status display, action routing).
+</process>

package/commands/rapido.md

@@ -0,0 +1,40 @@
+---
+name: up:rapido
+description: Tarefa rapida com garantias UP (commits atomicos, rastreamento)
+argument-hint: "[descricao]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Execute small, ad-hoc tasks with UP guarantees (atomic commits, STATE.md tracking).
+
+Quick mode is the same system with a shorter path:
+- Plans and executes in a streamlined flow
+- Quick tasks live in `.plano/rapido/` separate from planned phases
+- Updates STATE.md "Tarefas Rapidas" table (NOT ROADMAP.md)
+
+**Default:** Skips research, discussion, plan-checker, verifier. Use when you know exactly what to do.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/rapido.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+Quick tasks get UP guarantees without full phase ceremony.
+</context>
+
+<process>
+Execute the rapido workflow from @~/.claude/up/workflows/rapido.md end-to-end.
+Preserve all workflow gates (validation, task description, planning, execution, state updates, commits).
+</process>

package/commands/remover-fase.md

@@ -0,0 +1,34 @@
+---
+name: up:remover-fase
+description: Remover fase futura e renumerar subsequentes
+argument-hint: "<numero>"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - AskUserQuestion
+---
+<objective>
+Remove a future phase from the roadmap and renumber all subsequent phases.
+
+**Flow:** Validate future phase -> Confirm with user -> Call `up-tools.cjs phase remove` -> Present result
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/remover-fase.md
+</execution_context>
+
+<context>
+Phase number: $ARGUMENTS
+
+Only future (not started) phases can be removed. Active or completed phases are protected.
+</context>
+
+<process>
+1. Validate that the specified phase number exists and is a future phase (not active or completed).
+2. Confirm removal with the user via AskUserQuestion.
+3. Call `up-tools.cjs phase remove` with the phase number.
+4. Present the updated roadmap showing renumbered phases.
+</process>

package/commands/retomar.md

@@ -0,0 +1,35 @@
+---
+name: up:retomar
+description: Restaurar contexto da sessao anterior
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+<objective>
+Restore context from the previous session and resume work where it left off.
+
+**Default flow:** Find .continue-aqui.md -> Load context -> Validate state -> Present summary -> Resume
+
+**Orchestrator role:** Locate and read .continue-aqui.md handoff file, validate that project state matches expectations, present summary of where things stand, and route to the appropriate next action.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/retomar.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+Reads .continue-aqui.md from the project root to restore previous session context.
+</context>
+
+<process>
+Execute the retomar workflow from @~/.claude/up/workflows/retomar.md end-to-end.
+Preserve all workflow gates (handoff detection, context loading, state validation, summary, routing).
+</process>

package/commands/verificar-trabalho.md

@@ -0,0 +1,35 @@
+---
+name: up:verificar-trabalho
+description: Validar features atraves de UAT conversacional
+argument-hint: "[fase]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+<objective>
+Validate implemented features through conversational UAT (User Acceptance Testing).
+
+**Default flow:** Load phase plans -> Test each feature -> Collect feedback -> Generate VERIFICATION.md -> Route to fix or approve
+
+**Orchestrator role:** Read completed plans, run tests and checks, engage user in conversational validation, document results in VERIFICATION.md, create gap closure plans if needed.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/verificar-trabalho.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS (optional -- defaults to current active phase)
+
+Verification validates that implemented features match the planned requirements.
+</context>
+
+<process>
+Execute the verificar-trabalho workflow from @~/.claude/up/workflows/verificar-trabalho.md end-to-end.
+Preserve all workflow gates (plan loading, testing, user validation, VERIFICATION.md creation, routing).
+</process>

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "up-cc",
+  "version": "0.1.0",
+  "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
+  "bin": {
+    "up-cc": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "agents",
+    "commands",
+    "workflows",
+    "templates",
+    "references"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "gemini",
+    "gemini-cli",
+    "opencode",
+    "ai",
+    "spec-driven-development",
+    "meta-prompting",
+    "context-engineering"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.7.0"
+  }
+}