@luanpdd/kit-mcp 1.20.0 → 1.21.0

package/kit/framework/workflows/plant-seed.md

@@ -1,169 +1,169 @@
-<purpose>
-Captura uma ideia prospectiva como um arquivo de semente estruturado com condições de ativação.
-As sementes se apresentam automaticamente durante /novo-marco quando as condições de ativação
-correspondem ao escopo do novo marco.
-
-Sementes superam itens adiados porque:
-- Preservam POR QUE a ideia é importante (não apenas O QUE)
-- Definem QUANDO apresentar (condições de ativação, não varredura manual)
-- Rastreiam trilhas de evidências (referências de código, decisões relacionadas)
-- Se apresentam automaticamente no momento certo via varredura de novo-marco
-</purpose>
-
-<process>
-
-<step name="parse_idea">
-Analise `$ARGUMENTS` para o resumo da ideia.
-
-Se vazio, pergunte:
-```
-Qual é a ideia? (uma frase)
-```
-
-Armazene como `$IDEA`.
-</step>
-
-<step name="create_seed_dir">
-```bash
-mkdir -p .planning/seeds
-```
-</step>
-
-<step name="gather_context">
-Faça perguntas focadas para construir uma semente completa:
-
-```
-AskUserQuestion(
-  header: "Gatilho",
-  question: "Quando esta ideia deve se apresentar? (ex.: 'quando adicionarmos contas de usuário', 'na próxima versão principal', 'quando desempenho se tornar prioridade')",
-  options: []  // texto livre
-)
-```
-
-Armazene como `$TRIGGER`.
-
-```
-AskUserQuestion(
-  header: "Por quê",
-  question: "Por que isso é importante? Que problema resolve ou que oportunidade cria?",
-  options: []
-)
-```
-
-Armazene como `$WHY`.
-
-```
-AskUserQuestion(
-  header: "Escopo",
-  question: "Qual o tamanho disso? (estimativa aproximada)",
-  options: [
-    { label: "Pequeno", description: "Algumas horas — pode ser uma tarefa rápida" },
-    { label: "Médio", description: "Uma fase ou duas — precisa de planejamento" },
-    { label: "Grande", description: "Um marco completo — esforço significativo" }
-  ]
-)
-```
-
-Armazene como `$SCOPE`.
-</step>
-
-<step name="collect_breadcrumbs">
-Pesquise no codebase referências relevantes:
-
-```bash
-# Encontrar arquivos relacionados às palavras-chave da ideia
-grep -rl "$KEYWORD" --include="*.ts" --include="*.js" --include="*.md" . 2>/dev/null | head -10
-```
-
-Verifique também:
-- STATE.md atual para decisões relacionadas
-- ROADMAP.md para fases relacionadas
-- todos/ para ideias capturadas relacionadas
-
-Armazene os caminhos de arquivo relevantes como `$BREADCRUMBS`.
-</step>
-
-<step name="generate_seed_id">
-```bash
-# Encontrar o próximo número de semente
-EXISTING=$( (ls .planning/seeds/SEED-*.md 2>/dev/null || true) | wc -l )
-NEXT=$((EXISTING + 1))
-PADDED=$(printf "%03d" $NEXT)
-```
-
-Gere um slug a partir do resumo da ideia.
-</step>
-
-<step name="write_seed">
-Escreva `.planning/seeds/SEED-{PADDED}-{slug}.md`:
-
-```markdown
----
-id: SEED-{PADDED}
-status: dormant
-planted: {data ISO}
-planted_during: {marco/fase atual do STATE.md}
-trigger_when: {$TRIGGER}
-scope: {$SCOPE}
----
-
-# SEED-{PADDED}: {$IDEA}
-
-## Por Que Isso Importa
-
-{$WHY}
-
-## Quando Apresentar
-
-**Gatilho:** {$TRIGGER}
-
-Esta semente deve ser apresentada durante `/novo-marco` quando o escopo
-do marco corresponder a qualquer uma destas condições:
-- {condição de ativação 1}
-- {condição de ativação 2}
-
-## Estimativa de Escopo
-
-**{$SCOPE}** — {elaboração baseada na escolha de escopo}
-
-## Trilhas de Evidências
-
-Código e decisões relacionados encontrados no codebase atual:
-
-{lista de $BREADCRUMBS com caminhos de arquivo}
-
-## Notas
-
-{qualquer contexto adicional da sessão atual}
-```
-</step>
-
-<step name="commit_seed">
-```bash
-node "./.claude/framework/bin/tools.cjs" commit "docs: plantar semente — {$IDEA}" --files .planning/seeds/SEED-{PADDED}-{slug}.md
-```
-</step>
-
-<step name="confirm">
-```
-✅ Semente plantada: SEED-{PADDED}
-
-"{$IDEA}"
-Gatilho: {$TRIGGER}
-Escopo: {$SCOPE}
-Arquivo: .planning/seeds/SEED-{PADDED}-{slug}.md
-
-Esta semente se apresentará automaticamente quando você executar /novo-marco
-e o escopo do marco corresponder à condição de ativação.
-```
-</step>
-
-</process>
-
-<success_criteria>
-- [ ] Arquivo de semente criado em .planning/seeds/
-- [ ] Frontmatter inclui status, gatilho, escopo
-- [ ] Trilhas de evidências coletadas do codebase
-- [ ] Commitado no git
-- [ ] Usuário visualiza confirmação com informações do gatilho
-</success_criteria>
+<purpose>
+Captura uma ideia prospectiva como um arquivo de semente estruturado com condições de ativação.
+As sementes se apresentam automaticamente durante /novo-marco quando as condições de ativação
+correspondem ao escopo do novo marco.
+
+Sementes superam itens adiados porque:
+- Preservam POR QUE a ideia é importante (não apenas O QUE)
+- Definem QUANDO apresentar (condições de ativação, não varredura manual)
+- Rastreiam trilhas de evidências (referências de código, decisões relacionadas)
+- Se apresentam automaticamente no momento certo via varredura de novo-marco
+</purpose>
+
+<process>
+
+<step name="parse_idea">
+Analise `$ARGUMENTS` para o resumo da ideia.
+
+Se vazio, pergunte:
+```
+Qual é a ideia? (uma frase)
+```
+
+Armazene como `$IDEA`.
+</step>
+
+<step name="create_seed_dir">
+```bash
+mkdir -p .planning/seeds
+```
+</step>
+
+<step name="gather_context">
+Faça perguntas focadas para construir uma semente completa:
+
+```
+AskUserQuestion(
+  header: "Gatilho",
+  question: "Quando esta ideia deve se apresentar? (ex.: 'quando adicionarmos contas de usuário', 'na próxima versão principal', 'quando desempenho se tornar prioridade')",
+  options: []  // texto livre
+)
+```
+
+Armazene como `$TRIGGER`.
+
+```
+AskUserQuestion(
+  header: "Por quê",
+  question: "Por que isso é importante? Que problema resolve ou que oportunidade cria?",
+  options: []
+)
+```
+
+Armazene como `$WHY`.
+
+```
+AskUserQuestion(
+  header: "Escopo",
+  question: "Qual o tamanho disso? (estimativa aproximada)",
+  options: [
+    { label: "Pequeno", description: "Algumas horas — pode ser uma tarefa rápida" },
+    { label: "Médio", description: "Uma fase ou duas — precisa de planejamento" },
+    { label: "Grande", description: "Um marco completo — esforço significativo" }
+  ]
+)
+```
+
+Armazene como `$SCOPE`.
+</step>
+
+<step name="collect_breadcrumbs">
+Pesquise no codebase referências relevantes:
+
+```bash
+# Encontrar arquivos relacionados às palavras-chave da ideia
+grep -rl "$KEYWORD" --include="*.ts" --include="*.js" --include="*.md" . 2>/dev/null | head -10
+```
+
+Verifique também:
+- STATE.md atual para decisões relacionadas
+- ROADMAP.md para fases relacionadas
+- todos/ para ideias capturadas relacionadas
+
+Armazene os caminhos de arquivo relevantes como `$BREADCRUMBS`.
+</step>
+
+<step name="generate_seed_id">
+```bash
+# Encontrar o próximo número de semente
+EXISTING=$( (ls .planning/seeds/SEED-*.md 2>/dev/null || true) | wc -l )
+NEXT=$((EXISTING + 1))
+PADDED=$(printf "%03d" $NEXT)
+```
+
+Gere um slug a partir do resumo da ideia.
+</step>
+
+<step name="write_seed">
+Escreva `.planning/seeds/SEED-{PADDED}-{slug}.md`:
+
+```markdown
+---
+id: SEED-{PADDED}
+status: dormant
+planted: {data ISO}
+planted_during: {marco/fase atual do STATE.md}
+trigger_when: {$TRIGGER}
+scope: {$SCOPE}
+---
+
+# SEED-{PADDED}: {$IDEA}
+
+## Por Que Isso Importa
+
+{$WHY}
+
+## Quando Apresentar
+
+**Gatilho:** {$TRIGGER}
+
+Esta semente deve ser apresentada durante `/novo-marco` quando o escopo
+do marco corresponder a qualquer uma destas condições:
+- {condição de ativação 1}
+- {condição de ativação 2}
+
+## Estimativa de Escopo
+
+**{$SCOPE}** — {elaboração baseada na escolha de escopo}
+
+## Trilhas de Evidências
+
+Código e decisões relacionados encontrados no codebase atual:
+
+{lista de $BREADCRUMBS com caminhos de arquivo}
+
+## Notas
+
+{qualquer contexto adicional da sessão atual}
+```
+</step>
+
+<step name="commit_seed">
+```bash
+node "./.claude/framework/bin/tools.cjs" commit "docs: plantar semente — {$IDEA}" --files .planning/seeds/SEED-{PADDED}-{slug}.md
+```
+</step>
+
+<step name="confirm">
+```
+✅ Semente plantada: SEED-{PADDED}
+
+"{$IDEA}"
+Gatilho: {$TRIGGER}
+Escopo: {$SCOPE}
+Arquivo: .planning/seeds/SEED-{PADDED}-{slug}.md
+
+Esta semente se apresentará automaticamente quando você executar /novo-marco
+e o escopo do marco corresponder à condição de ativação.
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Arquivo de semente criado em .planning/seeds/
+- [ ] Frontmatter inclui status, gatilho, escopo
+- [ ] Trilhas de evidências coletadas do codebase
+- [ ] Commitado no git
+- [ ] Usuário visualiza confirmação com informações do gatilho
+</success_criteria>

package/kit/framework/workflows/pr-branch.md

@@ -1,129 +1,129 @@
-<purpose>
-Cria uma branch limpa para pull requests, filtrando commits do diretório .planning/.
-A branch de PR contém apenas mudanças de código — revisores não veem artefatos framework
-(PLAN.md, SUMMARY.md, STATE.md, CONTEXT.md, etc.).
-
-Usa git cherry-pick com filtragem de caminho para reconstruir um histórico limpo.
-</purpose>
-
-<process>
-
-<step name="detect_state">
-Analise `$ARGUMENTS` para branch alvo (padrão: `main`).
-
-```bash
-CURRENT_BRANCH=$(git branch --show-current)
-TARGET=${1:-main}
-```
-
-Verifique pré-condições:
-- Deve estar em uma branch de feature (não main/master)
-- Deve ter commits à frente do alvo
-
-```bash
-AHEAD=$(git rev-list --count "$TARGET".."$CURRENT_BRANCH" 2>/dev/null)
-if [ "$AHEAD" = "0" ]; then
-  echo "Nenhum commit à frente de $TARGET — nada para filtrar."
-  exit 0
-fi
-```
-
-Exiba:
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- framework ► BRANCH DE PR
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Branch: {CURRENT_BRANCH}
-Alvo: {TARGET}
-Commits: {AHEAD} à frente
-```
-</step>
-
-<step name="analyze_commits">
-Classifique os commits:
-
-```bash
-# Obter todos os commits à frente do alvo
-git log --oneline "$TARGET".."$CURRENT_BRANCH" --no-merges
-```
-
-Para cada commit, verifique se ele toca APENAS arquivos em .planning/:
-
-```bash
-# Para cada hash de commit
-FILES=$(git diff-tree --no-commit-id --name-only -r $HASH)
-ALL_PLANNING=$(echo "$FILES" | grep -v "^\.planning/" | wc -l)
-```
-
-Classifique:
-- **Commits de código**: Tocam ao menos um arquivo fora de .planning/ → INCLUIR
-- **Commits apenas de planejamento**: Tocam apenas arquivos em .planning/ → EXCLUIR
-- **Commits mistos**: Tocam ambos → INCLUIR (mudanças de planejamento vêm junto)
-
-Exiba a análise:
-```
-Commits a incluir: {N} (mudanças de código)
-Commits a excluir: {N} (apenas planejamento)
-Commits mistos: {N} (código + planejamento — incluídos)
-```
-</step>
-
-<step name="create_pr_branch">
-```bash
-PR_BRANCH="${CURRENT_BRANCH}-pr"
-
-# Criar branch de PR a partir do alvo
-git checkout -b "$PR_BRANCH" "$TARGET"
-```
-
-Cherry-pick apenas commits de código (em ordem):
-
-```bash
-for HASH in $CODE_COMMITS; do
-  git cherry-pick "$HASH" --no-commit
-  # Remover qualquer arquivo .planning/ que veio em commits mistos
-  git rm -r --cached .planning/ 2>/dev/null || true
-  git commit -C "$HASH"
-done
-```
-
-Retorne à branch original:
-```bash
-git checkout "$CURRENT_BRANCH"
-```
-</step>
-
-<step name="verify">
-```bash
-# Verificar se há arquivos .planning/ na branch de PR
-PLANNING_FILES=$(git diff --name-only "$TARGET".."$PR_BRANCH" | grep "^\.planning/" | wc -l)
-TOTAL_FILES=$(git diff --name-only "$TARGET".."$PR_BRANCH" | wc -l)
-PR_COMMITS=$(git rev-list --count "$TARGET".."$PR_BRANCH")
-```
-
-Exiba os resultados:
-```
-✅ Branch de PR criada: {PR_BRANCH}
-
-Original: {AHEAD} commits, {ORIGINAL_FILES} arquivos
-Branch de PR: {PR_COMMITS} commits, {TOTAL_FILES} arquivos
-Arquivos de planejamento: {PLANNING_FILES} (deve ser 0)
-
-Próximos passos:
-  git push origin {PR_BRANCH}
-  gh pr create --base {TARGET} --head {PR_BRANCH}
-
-Ou use /publicar para criar o PR automaticamente.
-```
-</step>
-
-</process>
-
-<success_criteria>
-- [ ] Branch de PR criada a partir do alvo
-- [ ] Commits somente de planejamento excluídos
-- [ ] Sem arquivos .planning/ no diff da branch de PR
-- [ ] Mensagens de commit preservadas do original
-- [ ] Usuário visualiza os próximos passos
-</success_criteria>
+<purpose>
+Cria uma branch limpa para pull requests, filtrando commits do diretório .planning/.
+A branch de PR contém apenas mudanças de código — revisores não veem artefatos framework
+(PLAN.md, SUMMARY.md, STATE.md, CONTEXT.md, etc.).
+
+Usa git cherry-pick com filtragem de caminho para reconstruir um histórico limpo.
+</purpose>
+
+<process>
+
+<step name="detect_state">
+Analise `$ARGUMENTS` para branch alvo (padrão: `main`).
+
+```bash
+CURRENT_BRANCH=$(git branch --show-current)
+TARGET=${1:-main}
+```
+
+Verifique pré-condições:
+- Deve estar em uma branch de feature (não main/master)
+- Deve ter commits à frente do alvo
+
+```bash
+AHEAD=$(git rev-list --count "$TARGET".."$CURRENT_BRANCH" 2>/dev/null)
+if [ "$AHEAD" = "0" ]; then
+  echo "Nenhum commit à frente de $TARGET — nada para filtrar."
+  exit 0
+fi
+```
+
+Exiba:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ framework ► BRANCH DE PR
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Branch: {CURRENT_BRANCH}
+Alvo: {TARGET}
+Commits: {AHEAD} à frente
+```
+</step>
+
+<step name="analyze_commits">
+Classifique os commits:
+
+```bash
+# Obter todos os commits à frente do alvo
+git log --oneline "$TARGET".."$CURRENT_BRANCH" --no-merges
+```
+
+Para cada commit, verifique se ele toca APENAS arquivos em .planning/:
+
+```bash
+# Para cada hash de commit
+FILES=$(git diff-tree --no-commit-id --name-only -r $HASH)
+ALL_PLANNING=$(echo "$FILES" | grep -v "^\.planning/" | wc -l)
+```
+
+Classifique:
+- **Commits de código**: Tocam ao menos um arquivo fora de .planning/ → INCLUIR
+- **Commits apenas de planejamento**: Tocam apenas arquivos em .planning/ → EXCLUIR
+- **Commits mistos**: Tocam ambos → INCLUIR (mudanças de planejamento vêm junto)
+
+Exiba a análise:
+```
+Commits a incluir: {N} (mudanças de código)
+Commits a excluir: {N} (apenas planejamento)
+Commits mistos: {N} (código + planejamento — incluídos)
+```
+</step>
+
+<step name="create_pr_branch">
+```bash
+PR_BRANCH="${CURRENT_BRANCH}-pr"
+
+# Criar branch de PR a partir do alvo
+git checkout -b "$PR_BRANCH" "$TARGET"
+```
+
+Cherry-pick apenas commits de código (em ordem):
+
+```bash
+for HASH in $CODE_COMMITS; do
+  git cherry-pick "$HASH" --no-commit
+  # Remover qualquer arquivo .planning/ que veio em commits mistos
+  git rm -r --cached .planning/ 2>/dev/null || true
+  git commit -C "$HASH"
+done
+```
+
+Retorne à branch original:
+```bash
+git checkout "$CURRENT_BRANCH"
+```
+</step>
+
+<step name="verify">
+```bash
+# Verificar se há arquivos .planning/ na branch de PR
+PLANNING_FILES=$(git diff --name-only "$TARGET".."$PR_BRANCH" | grep "^\.planning/" | wc -l)
+TOTAL_FILES=$(git diff --name-only "$TARGET".."$PR_BRANCH" | wc -l)
+PR_COMMITS=$(git rev-list --count "$TARGET".."$PR_BRANCH")
+```
+
+Exiba os resultados:
+```
+✅ Branch de PR criada: {PR_BRANCH}
+
+Original: {AHEAD} commits, {ORIGINAL_FILES} arquivos
+Branch de PR: {PR_COMMITS} commits, {TOTAL_FILES} arquivos
+Arquivos de planejamento: {PLANNING_FILES} (deve ser 0)
+
+Próximos passos:
+  git push origin {PR_BRANCH}
+  gh pr create --base {TARGET} --head {PR_BRANCH}
+
+Ou use /publicar para criar o PR automaticamente.
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Branch de PR criada a partir do alvo
+- [ ] Commits somente de planejamento excluídos
+- [ ] Sem arquivos .planning/ no diff da branch de PR
+- [ ] Mensagens de commit preservadas do original
+- [ ] Usuário visualiza os próximos passos
+</success_criteria>