rbin-task-flow 1.25.0 → 1.26.0

package/.task-flow/guides/CODEX.md

@@ -13,9 +13,19 @@ Codex loads **AGENTS.md** at session start (32 KiB default cap). This file holds
 3. New tasks: generate 3–8 subtasks, `createdAt` ISO, contexts from `.task-flow/contexts/`.
 4. Write/update `tasks.json`, `status.json`, `tasks.status.md` with Summary.
 5. Preserve status on modified tasks when subtasks still align.
-6. Do not populate `tasks.flow.md`.
 
-Sync: `.cursor/rules/task-flow-sync.mdc` · Think: `.cursor/rules/task_analysis.mdc`
+Sync: `.cursor/rules/task-flow-sync.mdc`
+
+---
+
+## task-flow: from contexts
+
+1. List `.task-flow/contexts/` (or specific `file.png`, `a.md,b.png`).
+2. Read each file; skip already linked via `task-flow-screen` in `tasks.input.txt`.
+3. Append `- Description task-flow-screen filename.ext` under `## Tasks:`.
+4. Report added/skipped; suggest `task-flow: sync` — do not sync here.
+
+Rule: `.cursor/rules/task_from_contexts.mdc`
 
 ---
 
@@ -37,26 +47,6 @@ Display `.task-flow/tasks.status.md`. If missing, run sync first.
 
 ---
 
-## task-flow: think
-
-1. Read `tasks.input.txt`.
-2. Scan repo for TODOs, gaps, tests, incomplete features.
-3. Propose new `- task` lines.
-4. **Ask** before appending to `tasks.input.txt`.
-5. If confirmed, append and suggest `task-flow: sync`.
-
----
-
-## task-flow: check
-
-1. `package.json` scripts: lint fix variant, then `build`.
-2. Fix until pass.
-3. Does not edit task files.
-
-Rule: `.cursor/rules/task_check.mdc`
-
----
-
 ## task-flow: audit
 
 1. Score project vs the checklist in `.cursor/rules/coding_standards.mdc` (not the full doc unless user wants depth).
@@ -67,27 +57,6 @@ Rule: `.cursor/rules/task_audit.mdc`
 
 ---
 
-## task-flow: improve changes
-
-1. `git diff --name-only HEAD` (read-only).
-2. If empty, stop.
-3. Audit only those paths vs coding standards.
-4. Ask before edits.
-
-Rule: `.cursor/rules/task_improve_changes.mdc`
-
----
-
-## task-flow: review X
-
-1. Load done subtasks for task X from `status.json`.
-2. Verify implementation in codebase.
-3. Report false positives; ask to revert status if needed.
-
-Rule: `.cursor/rules/task_review.mdc`
-
----
-
 ## task-flow: validate
 
 1. Read `tasks.input.txt`, `tasks.json`, `status.json` — scope `all` or task ID(s).
@@ -98,21 +67,13 @@ Rule: `.cursor/rules/task_review.mdc`
 
 Rule: `.cursor/rules/task_validate.mdc`
 
-Unlike `think` (asks before add) or `review` (done only, asks before revert).
-
----
-
-## task-flow: refactor X
-
-Refactor task-related files: no behavior change, remove explanatory comments, keep section separators.
-
-Rule: `.cursor/rules/task_refactor.mdc`
-
 ---
 
 ## task-flow: estimate X
 
-Read `tasks.json`; one hour range; average developer, average pace, no AI acceleration.
+1. Parse: `estimate X` | `estimate X,Y` | `estimate all`.
+2. Read `tasks.json` for matching task ID(s).
+3. One hour range per task; average developer, average pace, no AI acceleration.
 
 Rule: `.cursor/rules/task_estimate.mdc`
 
@@ -126,14 +87,6 @@ Rule: `.cursor/rules/task_report.mdc`
 
 ---
 
-## task-flow: generate flow
-
-Populate `.task-flow/tasks.flow.md` with deps, hours, model hints (no Opus).
-
-Rule: `.cursor/rules/task_generate_flow.mdc`
-
----
-
 ## Implementing code (any subtask)
 
 Follow the checklist in `.cursor/rules/coding_standards.mdc`. For examples/Nest: read sections of `.task-flow/guides/coding-standards-full.md` only.
@@ -142,7 +95,7 @@ Follow the checklist in `.cursor/rules/coding_standards.mdc`. For examples/Nest:
 
 ## Graphify (optional)
 
-Only during `run` / `think` when `graphify-out/` exists. See `.task-flow/guides/GRAPHIFY.md`. Does not replace status updates.
+Only during `run` / `validate` when `.task-flow/guides/graphify-out/` exists. See `.task-flow/guides/GRAPHIFY.md`. Does not replace status updates.
 
 ---
 

package/.task-flow/guides/CURSOR.md

@@ -21,11 +21,10 @@ Verify: `rg 'alwaysApply: true' .cursor/rules` → only the two files above.
 
 | Say in Agent / Chat | Best invoke |
 |---------------------|-------------|
+| `task-flow: from contexts` | `@task-flow-from-contexts` |
 | `task-flow: sync` | `@task-flow-sync` |
 | `task-flow: run next 4` | `@task-flow-run` |
 | `task-flow: status` | `@task-flow-status` |
-| `task-flow: check` | `@task-flow-check` |
-| `task-flow: improve changes` | `@task-flow-improve-changes` |
 | `task-flow: validate` | `@task-flow-validate` |
 | Implement feature code | `@rbin-coding-standards` (explicit; checklist glob on `src/**`) |
 
@@ -39,7 +38,7 @@ Verify: `rg 'alwaysApply: true' .cursor/rules` → only the two files above.
 |-------|----------|-------------|
 | **Always** | `task-flow-cursor`, `rbin-git-policy` | Every chat (~0,9k tokens) |
 | **Skills** | `@task-flow-run`, `@task-flow-sync`, … | You invoke (recommended for run/sync/audit) |
-| **Intelligent** | `task_work`, `task_audit`, `task_analysis`, … | Agent matches `description` |
+| **Intelligent** | `task_work`, `task_audit`, `task_validate`, … | Agent matches `description` |
 | **Glob** | `task-flow-sync`, `task_generation` (`.task-flow/**`), `coding_standards` (`src/**`, `app/**`), `code_comments` | Matching paths in chat |
 | **Manual** | `@cursor_rules`, `@self_improve`, `@task_report`, legacy `git_control` | You `@`-mention only (no `description` auto-match) |
 
@@ -54,7 +53,7 @@ If a command fails to trigger, use **`@task-flow-*`** explicitly.
 | Surface | Best for |
 |---------|----------|
 | **Agent** (Composer) | `@task-flow-run`, multi-file implementation |
-| **Chat** | `sync`, `status`, `think`, `estimate` |
+| **Chat** | `sync`, `status`, `estimate` |
 | **@ files** | `@tasks.input.txt`, `@.task-flow/contexts/mockup.png` |
 
 ---
@@ -70,7 +69,7 @@ After each subtask:
 
 ## Graphify
 
-Only during `run` / `think` when `graphify-out/` exists. Does not replace Task Flow status. See [GRAPHIFY.md](GRAPHIFY.md).
+Only during `run` / `validate` when `.task-flow/guides/graphify-out/` exists. Does not replace Task Flow status. See [GRAPHIFY.md](GRAPHIFY.md).
 
 ---
 

package/.task-flow/guides/GRAPHIFY.md

@@ -9,7 +9,7 @@ Graphify ([graphifyy](https://pypi.org/project/graphifyyy/)) cria um **grafo de
 ## Token discipline
 
 - Use **summarized** `graphify query` output (symbols, paths, short lists) — not full graph dumps in chat.
-- **Do not paste** `graphify-out/GRAPH_REPORT.md` (or entire report files) into the model context unless the user **explicitly** `@`-mentions that file.
+- **Do not paste** `.task-flow/guides/graphify-out/GRAPH_REPORT.md` (or entire report files) into the model context unless the user **explicitly** `@`-mentions that file.
 - Prefer one targeted query per subtask over loading `graph.json` or large exports.
 - Task Flow status files (`.task-flow/`) always win over Graphify for workflow and git.
 
@@ -20,7 +20,7 @@ Graphify ([graphifyy](https://pypi.org/project/graphifyyy/)) cria um **grafo de
 | | Task Flow | Graphify |
 |---|-----------|----------|
 | **Pergunta** | O que fazer agora? | Onde está X no código? |
-| **Dados** | `.task-flow/` | `graphify-out/` |
+| **Dados** | `.task-flow/` | `.task-flow/guides/graphify-out/` |
 | **Comandos** | `task-flow: sync`, `run`, `status`, … | `graphify extract`, `query`, `affected` |
 | **Regra Cursor** | Várias `.mdc` (workflow) | `graphify-task-flow.mdc` (**sob demanda**) |
 
@@ -29,9 +29,9 @@ Graphify ([graphifyy](https://pypi.org/project/graphifyyy/)) cria um **grafo de
 ## O que o `rbin-task-flow init` já faz por você
 
 1. Copia **`.cursor/rules/graphify-task-flow.mdc`** — `alwaysApply: false` (não compete com `task_work`, etc.).
-2. Adiciona **`graphify-out/`** ao `.gitignore`.
+2. Grafo em **`.task-flow/guides/graphify-out/`** (já coberto pelo `.task-flow/` no `.gitignore`; remove entrada legada `graphify-out/` na raiz).
 3. Se existir **`.cursor/rules/graphify.mdc`** do `graphify cursor install` (upstream com `alwaysApply: true`), o instalador **desativa** `alwaysApply` para economizar contexto.
-4. Com **`--graphify`** em `init`, `update` ou **`reset`**, roda `graphify extract . --backend claude-cli` se o CLI estiver no PATH (usa assinatura Claude Code — sem API key separada).
+4. Com **`--graphify`** em `init`, `update` ou **`reset`**, roda `graphify extract . --backend claude-cli --out .task-flow/guides` se o CLI estiver no PATH (usa assinatura Claude Code — sem API key separada).
 
 **Não** rodamos `graphify claude install` / `graphify cursor install` automaticamente — o install upstream força `graphify.mdc` always-on e incham `CLAUDE.md` / `AGENTS.md`.
 
@@ -44,7 +44,6 @@ cd seu-projeto
 rbin-task-flow reset --graphify   # ou init/update --graphify; recria .task-flow + grafo
 task-flow: sync
 task-flow: run next 3             # IA usa grafo só ao implementar
-task-flow: check
 # você: git commit
 ```
 
@@ -52,16 +51,16 @@ task-flow: check
 
 | Comando Task Flow | Usar Graphify? |
 |-------------------|----------------|
-| `sync`, `status`, `estimate`, `report`, `generate flow` | Não |
-| `run next X`, `run N` | Sim, se `graphify-out/` existir |
-| `think`, `review`, `validate` | Opcional |
-| `audit`, `improve changes` | Opcional (estrutura); padrões = checklist `coding_standards.mdc` |
+| `sync`, `status`, `estimate`, `report` | Não |
+| `run next X`, `run N` | Sim, se `.task-flow/guides/graphify-out/` existir |
+| `validate` | Opcional |
+| `audit` | Opcional (estrutura); padrões = checklist `coding_standards.mdc` |
 | `check` | Não |
 
 **Prompt exemplo:**
 
 ```text
-task-flow: run next 2 — se graphify-out existir, graphify query "<módulo da subtarefa>" antes de editar arquivos.
+task-flow: run next 2 — se .task-flow/guides/graphify-out/ existir, graphify query "<módulo>" --graph .task-flow/guides/graphify-out/graph.json antes de editar.
 ```
 
 ---
@@ -87,9 +86,9 @@ task-flow: run next 2 — se graphify-out existir, graphify query "<módulo da s
 
 | Evento | Ação |
 |--------|------|
-| Primeiro setup | `rbin-task-flow init --graphify` ou `graphify extract . --backend claude-cli` |
+| Primeiro setup | `rbin-task-flow init --graphify` ou `graphify extract . --backend claude-cli --out .task-flow/guides` |
 | Reset completo (tasks + template + grafo) | `rbin-task-flow reset --graphify` |
-| Refactor grande após vários `run` | `graphify update .` ou `graphify extract . --backend claude-cli` |
+| Refactor grande após vários `run` | `graphify update .` ou `graphify extract . --backend claude-cli --out .task-flow/guides` |
 | `task-flow: update` | Reaplica `graphify-task-flow.mdc` e pode rebaixar `graphify.mdc` |
 
 ---
@@ -102,7 +101,7 @@ task-flow: run next 2 — se graphify-out existir, graphify query "<módulo da s
 | Contexto cheio no Cursor | Confirme `graphify.mdc` não está `alwaysApply: true` |
 | `graphify: command not found` | Rode `rbin-install-dev` (módulo Graphify) |
 | `no LLM API key found` ao rodar `graphify extract .` manual | Use `rbin-task-flow init --graphify` (roda `--backend claude-cli`) ou exporte uma API key / `--backend ollama` |
-| Grafo desatualizado | `graphify extract . --backend claude-cli` de novo |
+| Grafo desatualizado | `graphify extract . --backend claude-cli --out .task-flow/guides` de novo |
 
 ---
 

package/.task-flow/guides/coding-standards-full.md

@@ -8,6 +8,151 @@ These rules define how code MUST be written when implementing tasks. Always foll
 
 ---
 
+## Vercel — environment variables
+
+**When the project deploys on Vercel** (Next.js, etc.), follow this section for `.env` files.
+
+### Instruções para a IA (executar nesta ordem)
+
+1. **Antes de tudo — auditar variáveis sem uso** [§0]: para cada variável dos `.env*`, verifique se ela é realmente referenciada no código/configuração. **Liste as órfãs e confirme com o usuário antes de remover** — não apague sozinha (algumas são usadas só em runtime/CI/infra). Só depois de limpar é que se alinham os 3 arquivos.
+2. Crie `scripts/env-files-check.sh` e `scripts/vercel-env-sync.sh` com **exatamente** o conteúdo das seções [§5] e [§6]. Marque ambos como executáveis (`chmod +x`).
+3. Garanta os **3 arquivos de ambiente** seguindo a convenção [§1]: mesma sequência de chaves nos 3, **ordem alfabética**, uma variável por linha, sem comentários de seção no meio. Crie `.env.example` (commitado, valores vazios). **Nunca** coloque valores reais no `.env.example`.
+4. Ajuste o `.gitignore` conforme [§2].
+5. Ajuste a `PLAINTEXT_REGEX` do `vercel-env-sync.sh` ao stack do projeto [§3].
+6. Rode `./scripts/env-files-check.sh` e mostre a saída. Não rode o sync da Vercel sem credenciais do usuário — explique os comandos de [§4].
+7. Confirme os **critérios de aceite** [§7].
+
+### §0 — Auditoria (variáveis sem uso)
+
+Para cada chave dos `.env*`, procure referências: `process.env.NOME`, `import.meta.env.NOME`, `env("NOME")`, configs/CI (`vercel.json`, `*.yml`, `Dockerfile`).
+
+```bash
+for k in $(grep -hE '^[A-Za-z_][A-Za-z0-9_]*=' .env.example .env.local .env.production 2>/dev/null \
+            | sed -E 's/=.*//' | sort -u); do
+  n=$(grep -rIn --exclude-dir=node_modules --exclude-dir=.git --exclude='.env*' \
+        -e "$k" . 2>/dev/null | wc -l | tr -d ' ')
+  printf '%-32s %s ref(s)\n' "$k" "$n"
+done
+```
+
+**Trate `0 ref` como candidata, não certeza.** Confirme com o usuário antes de remover.
+
+### §1 — Convenção dos 3 arquivos
+
+| Arquivo | Commitado? | Papel | Valores |
+|---|---|---|---|
+| `.env.example` | ✅ sim | Lista canônica (doc) | vazios/placeholder |
+| `.env.local` | ❌ não | Desenvolvimento local | reais de dev |
+| `.env.production` | ❌ não | **Sincronizado com a Vercel** | reais de produção |
+
+Mesma sequência de chaves, **ordem alfabética**. Sem comentários de seção no meio.
+
+### §2 — `.gitignore`
+
+```gitignore
+.env
+.env.*
+!.env.example
+```
+
+### §3 — Classificação secret × plaintext (Vercel)
+
+| Classe | Exemplos | Tipo |
+|---|---|---|
+| `NEXT_PUBLIC_*` | `NEXT_PUBLIC_API_URL` | **plaintext** |
+| Flags / URLs públicas | `*_ENABLED`, `*_PUBLIC_URL`, `NODE_ENV` | **plaintext** |
+| Todo o resto | `*_API_KEY`, `*_SECRET`, `*_TOKEN` | **secret** (`--sensitive`) |
+
+### §4 — Comandos
+
+```bash
+npm i -g vercel && vercel login && vercel link
+./scripts/env-files-check.sh
+DRY_RUN=1 ./scripts/vercel-env-sync.sh
+./scripts/vercel-env-sync.sh
+vercel env pull .env.vercel.check --environment=production
+```
+
+### §5 — `scripts/env-files-check.sh`
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+if [ "$#" -gt 0 ]; then FILES=("$@"); else FILES=(".env.example" ".env.local" ".env.production"); fi
+keys_of() { grep -E '^[A-Za-z_][A-Za-z0-9_]*=' "$1" | sed -E 's/=.*//'; }
+fail=0; ref=""; ref_file=""
+for f in "${FILES[@]}"; do
+  if [ ! -f "$f" ]; then echo "❌ faltando: $f"; fail=1; continue; fi
+  keys="$(keys_of "$f")"
+  sorted="$(printf '%s\n' "$keys" | LC_ALL=C sort)"
+  if [ "$keys" != "$sorted" ]; then
+    echo "❌ $f não está em ordem alfabética."
+    diff <(printf '%s\n' "$keys") <(printf '%s\n' "$sorted") | head -6
+    fail=1
+  fi
+  count="$(printf '%s\n' "$keys" | grep -c . || true)"
+  echo "• $f — $count variáveis"
+  if [ -z "$ref" ]; then ref="$sorted"; ref_file="$f"
+  elif [ "$sorted" != "$ref" ]; then
+    echo "❌ $f difere de $ref_file:"
+    diff <(printf '%s\n' "$ref") <(printf '%s\n' "$sorted") || true
+    fail=1
+  fi
+done
+if [ "$fail" -eq 0 ]; then echo "✅ Arquivos alinhados, mesma sequência e em ordem alfabética."
+else echo "→ Corrija as divergências acima."; fi
+exit "$fail"
+```
+
+### §6 — `scripts/vercel-env-sync.sh`
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+ENV_FILE="${1:-.env.production}"
+TARGET="${2:-production}"
+DRY_RUN="${DRY_RUN:-0}"
+PLAINTEXT_REGEX="${PLAINTEXT_REGEX:-^(NEXT_PUBLIC_|NODE_ENV$|.*_ENABLED$|.*_URL_STRATEGY$|.*_PUBLIC_URL$|.*_REGION$)}"
+command -v vercel >/dev/null 2>&1 || { echo "❌ vercel CLI não encontrado. Instale: npm i -g vercel"; exit 1; }
+[ -f "$ENV_FILE" ] || { echo "❌ arquivo não encontrado: $ENV_FILE"; exit 1; }
+[ -d ".vercel" ] || echo "⚠️  projeto não vinculado — rode 'vercel link' antes (continuando…)"
+secret_count=0; plain_count=0
+while IFS= read -r line <&3 || [ -n "$line" ]; do
+  case "$line" in ''|\#*) continue ;; esac
+  case "$line" in *=*) ;; *) continue ;; esac
+  key="${line%%=*}"; val="${line#*=}"
+  key="$(printf '%s' "$key" | tr -d '[:space:]')"
+  val="${val%\"}"; val="${val#\"}"; val="${val%\'}"; val="${val#\'}"
+  [ -z "$key" ] && continue
+  if [ -z "$val" ]; then echo "⏭️  $key (valor vazio — pulado)"; continue; fi
+  if printf '%s' "$key" | grep -Eq "$PLAINTEXT_REGEX"; then
+    flag=""; kind="plaintext"; plain_count=$((plain_count+1))
+  else
+    flag="--sensitive"; kind="secret  "; secret_count=$((secret_count+1))
+  fi
+  echo "→ [$kind] $key  ($TARGET)"
+  [ "$DRY_RUN" = "1" ] && continue
+  vercel env rm "$key" "$TARGET" -y </dev/null >/dev/null 2>&1 || true
+  printf '%s' "$val" | vercel env add "$key" "$TARGET" $flag >/dev/null
+done 3< "$ENV_FILE"
+echo "✅ $secret_count secret(s), $plain_count plaintext em '$TARGET'."
+[ "$DRY_RUN" = "1" ] && echo "(DRY_RUN — nada foi enviado)"
+```
+
+### §7 — Critérios de aceite
+
+- Auditoria [§0] feita; órfãs removidas após confirmação do usuário.
+- Scripts executáveis; 3 arquivos com mesma sequência alfabética.
+- `./scripts/env-files-check.sh` retorna exit 0.
+- `.gitignore` ignora `.env*` exceto `.env.example`.
+- Nenhum valor real no `.env.example` nem no git.
+
+### §8 — Limitações
+
+Valores multilinha (PEM/JSON) → base64 numa linha ou cadastro manual na Vercel. `NEXT_PUBLIC_*` no target do **build**.
+
+---
+
 ## Project Structure
 
 All projects use TypeScript and follow this structure:

package/.task-flow/guides/platforms/claude-code.md

@@ -29,7 +29,7 @@ projeto/
 ├── CLAUDE.md                 # Índice enxuto + tabela de skills
 ├── .claude/
 │   ├── settings.json
-│   └── skills/               # 14 skills (task-flow-*, rbin-*)
+│   └── skills/               # 10 skills (task-flow-*, rbin-*)
 ├── .cursor/
 │   ├── rules/                # Referência + Cursor alwaysApply
 │   └── skills/               # Espelho das mesmas skills
@@ -53,9 +53,7 @@ CLAUDE.md                          # ≤ 150 linhas: índice + invariantes
     ├── task-flow-run/
     │   ├── SKILL.md
     │   └── workflow.md
-    ├── task-flow-check/
     ├── task-flow-audit/
-    ├── task-flow-improve-changes/
     └── rbin-git/
 .task-flow/                        # tasks, status, contexts (inalterado)
 ```
@@ -89,7 +87,7 @@ task-flow-run/
 |-------|-------------------|
 | `description` | **Obrigatório para descoberta.** Terceira pessoa, WHAT + WHEN, termos `task-flow`, `run next`, `sync`, `RBIN`. Limite ~1536 caracteres na listagem. |
 | `name` | Opcional; comando `/` vem do **nome da pasta** (`task-flow-run` → `/task-flow-run`). |
-| `disable-model-invocation: true` | Workflows com efeito colateral: `run`, `sync`, `check`, deploy. Você dispara; Claude não “decide” sozinho. |
+| `disable-model-invocation: true` | Workflows com efeito colateral: `run`, `sync`, deploy. Você dispara; Claude não “decide” sozinho. |
 | `user-invocable: false` | Conhecimento de fundo (ex.: legado) — raro no Task Flow. |
 | `allowed-tools` | Restringir ferramentas em skills sensíveis (ex.: só `Read`, `Grep` para audit read-only). |
 | `paths` | Ex.: `[".task-flow/**"]` — auto-carregar skill ao editar arquivos de task. |
@@ -122,7 +120,7 @@ Inclua estado real **antes** das instruções:
 1. ...
 ```
 
-O prefixo `` !`comando` `` executa o comando e substitui a linha pelo output. Ideal para `run`, `review` e `improve changes` (diff).
+O prefixo `` !`comando` `` executa o comando e substitui a linha pelo output. Ideal para `run` e `validate`.
 
 ### 4.5 Descoberta e monorepos
 
@@ -142,18 +140,13 @@ Para Task Flow em equipe: prefira **skills de projeto** versionadas (ajuste o `.
 
 | Comando usuário | Skill sugerida | `/` | Regra fonte |
 |-----------------|----------------|-----|-------------|
+| `task-flow: from contexts` | `task-flow-from-contexts` | `/task-flow-from-contexts` | `task_from_contexts.mdc` |
 | `task-flow: sync` | `task-flow-sync` | `/task-flow-sync` | `task-flow-sync.mdc` · `task_generation.mdc` (subtasks) |
 | `task-flow: run next X` / `run X` | `task-flow-run` | `/task-flow-run` | `workflow.md` · stub `task_work.mdc` |
 | `task-flow: status` | `task-flow-status` | `/task-flow-status` | `task_status.mdc` |
-| `task-flow: think` | `task-flow-think` | `/task-flow-think` | `task_analysis.mdc` |
 | `task-flow: audit` | `task-flow-audit` | `/task-flow-audit` | `task_audit.mdc` |
-| `task-flow: improve changes` | `task-flow-improve-changes` | `/task-flow-improve-changes` | `task_improve_changes.mdc` |
-| `task-flow: check` | `task-flow-check` | `/task-flow-check` | `task_check.mdc` |
-| `task-flow: review X` | `task-flow-review` | `/task-flow-review` | `task_review.mdc` |
-| `task-flow: refactor X` | `task-flow-refactor` | `/task-flow-refactor` | `task_refactor.mdc` |
-| `task-flow: estimate X` | `task-flow-estimate` | `/task-flow-estimate` | `task_estimate.mdc` |
+| `task-flow: estimate X` / `X,Y` / `all` | `task-flow-estimate` | `/task-flow-estimate` | `task_estimate.mdc` |
 | `task-flow: report X` | `task-flow-report` | `/task-flow-report` | `task_report.mdc` |
-| `task-flow: generate flow` | `task-flow-generate-flow` | `/task-flow-generate-flow` | `task_generate_flow.mdc` |
 | Implementar código | `rbin-coding-standards` | `/rbin-coding-standards` | checklist `coding_standards.mdc` + `docs/coding-standards-full.md` on demand |
 | Após concluir subtarefa | `rbin-git` | `/rbin-git` | `rbin-git-policy.mdc` (always) |
 
@@ -205,23 +198,21 @@ Copie o corpo longo de `.cursor/rules/task_work.mdc` para `workflow.md`.
 2. /task-flow-sync   (ou: task-flow: sync)
 3. /task-flow-status
 4. /task-flow-run run next 3
-5. /task-flow-check
-6. Você: git add && git commit  (mensagem sugerida pela IA)
+5. Você: git add && git commit  (mensagem sugerida pela IA)
 ```
 
 ### 7.2 Antes do PR
 
 ```text
-/task-flow-improve-changes
-/task-flow-check
-/task-flow-review 1,2
+/task-flow-validate
 ```
 
 ### 7.3 Planejamento / cobrança
 
 ```text
-/task-flow-generate-flow
 /task-flow-estimate 3
+/task-flow-estimate 1,2,3
+/task-flow-estimate all
 ```
 
 ### 7.4 Múltiplos agentes no mesmo repo
@@ -239,11 +230,11 @@ Skills nativas úteis **junto** com Task Flow ([docs](https://code.claude.com/do
 |-------|-------------------|
 | `/code-review` | Após `task-flow: run`, antes do commit |
 | `/debug` | Subtarefa travada em bug |
-| `/verify` | Validar app rodando (além de `task-flow: check`) |
+| `/verify` | Validar app rodando em runtime |
 | `/run` | Subir app para testar UI de subtarefa |
 | `/run-skill-generator` | Uma vez por repo — grava receita de build em `.claude/skills/run-*/` |
 
-`task-flow: check` cobre lint/build; `/verify` cobre comportamento em runtime quando testes não bastam.
+`/verify` cobre comportamento em runtime quando testes não bastam.
 
 ---
 
@@ -268,7 +259,6 @@ Stack: …
 | Sync | `/task-flow-sync` |
 | Executar | `/task-flow-run` |
 | Status | `/task-flow-status` |
-| Lint/build | `/task-flow-check` |
 | Padrões de código | `/rbin-coding-standards` |
 
 Comandos naturais `task-flow: …` também valem.
@@ -325,8 +315,8 @@ Ou use `AGENTS.override.md` / settings locais fora do git e commite `.claude/ski
 ## 13. Checklist de maturidade Claude + Task Flow
 
 - [x] `CLAUDE.md` enxuto com índice de skills
-- [x] Skills instaladas via `rbin-task-flow init` (14 skills)
-- [x] `paths: [".task-flow/**"]` em `task-flow-run`, `sync`, `estimate`, `report`, `generate-flow`
+- [x] Skills instaladas via `rbin-task-flow init` (10 skills)
+- [x] `paths: [".task-flow/**"]` em `task-flow-run`, `sync`, `estimate`, `report`
 - [x] Injeção `` !`head tasks.status.md` `` em `task-flow-run`
 - [ ] `.claude/skills/` versionado no git (ajustar `.gitignore` se o time quiser)
 - [ ] `.task-flow/contexts/` populado para tasks de UI

package/.task-flow/guides/platforms/codex.md

@@ -119,8 +119,6 @@ src/AGENTS.md                      # Opcional: só para subtree (monorepo)
 | `task-flow: sync` | `.cursor/rules/task-flow-sync.mdc` |
 | `task-flow: run next X` / `run N` | `.claude/skills/task-flow-run/workflow.md` (fallback: `task_work.mdc`) |
 | `task-flow: status` | `.task-flow/tasks.status.md` |
-| `task-flow: improve changes` | `.cursor/rules/task_improve_changes.mdc` + `git diff --name-only HEAD` |
-| `task-flow: check` | `.cursor/rules/task_check.mdc` + `package.json` scripts |
 | `task-flow: audit` | `.cursor/rules/task_audit.mdc` + checklist `coding_standards.mdc` (full doc seções se necessário) |
 
 Após cada subtarefa: atualizar `status.json` e `tasks.status.md` (resumo no topo).
@@ -155,18 +153,16 @@ Codex prefere `AGENTS.override.md` sobre `AGENTS.md` **no mesmo nível**.
 
 | Comando | Prompt mínimo eficaz |
 |---------|---------------------|
+| `task-flow: from contexts` | `task_from_contexts.mdc — leia contexts/, append tasks em tasks.input.txt` |
 | `task-flow: sync` | `Leia AGENTS.md e task-flow-sync.mdc. Execute task-flow: sync em tasks.input.txt.` |
 | `task-flow: run next 3` | `Siga task-flow-run workflow.md. task-flow: run next 3. Atualize status.json e tasks.status.md.` |
 | `task-flow: run 2` | Idem + respeitar dependências tasks 1..X-1 |
 | `task-flow: status` | `Mostre o conteúdo de .task-flow/tasks.status.md` |
-| `task-flow: think` | `task-flow: think — sugira tasks; pergunte antes de gravar em tasks.input.txt` |
-| `task-flow: improve changes` | `git diff --name-only HEAD` · checklist `coding_standards.mdc` nos paths alterados |
-| `task-flow: check` | `Rode lint:fix e build do package.json; corrija até passar` |
-| `task-flow: review 1` | `task_review.mdc — verifique se task 1 done está realmente implementada` |
 | `task-flow: validate` | `task_validate.mdc — valide todas as tasks, reverta false done, adicione lacunas em tasks.input.txt e sync` |
 | `task-flow: estimate 1` | `task_estimate.mdc para task 1` |
+| `task-flow: estimate 1,2` | `task_estimate.mdc para tasks 1 e 2` |
+| `task-flow: estimate all` | `task_estimate.mdc para todas as tasks` |
 | `task-flow: report 1` | `task_report.mdc — task 1 deve estar done` |
-| `task-flow: generate flow` | `task_generate_flow.mdc — preencher tasks.flow.md` |
 
 **Padrão universal:**
 
@@ -193,10 +189,6 @@ Leia AGENTS.md. task-flow: sync.
 task-flow: run next 2 — leia .claude/skills/task-flow-run/workflow.md e .task-flow/.internal/tasks.json.
 ```
 
-```text
-task-flow: check
-```
-
 Você executa git manualmente.
 
 ### 6.2 Codex em subpasta (monorepo)
@@ -213,11 +205,7 @@ Codex mescla: `AGENTS.md` (raiz) + `packages/frontend/AGENTS.md` se existir.
 ### 6.3 Antes do PR
 
 ```text
-task-flow: improve changes
-```
-
-```text
-task-flow: review 2,3
+task-flow: validate
 ```
 
 ### 6.4 Sem project doc (debug)
@@ -290,8 +278,7 @@ Config mais específica (perto do CWD) **sobrescreve** a da raiz.
 | Ferramenta | Papel |
 |------------|-------|
 | `rbin-task-flow init` | Instala `AGENTS.md` + `.task-flow/` + `.cursor/rules/` |
-| `rbin-task-flow audit` | Lista unstaged (útil antes de `improve changes`) |
-| Codex | Executa lógica descrita nas regras |
+| Codex | Executa lógica descrita nas regras (`task-flow: audit`, `task-flow: run`, etc.) |
 
 Codex **não** substitui `task-flow: sync` — isso é trabalho do agente lendo as regras.
 
@@ -303,7 +290,7 @@ Codex **não** substitui `task-flow: sync` — isso é trabalho do agente lendo
 |-------|---------|
 | AGENTS.md com 40 KiB de standards | Truncamento silencioso |
 | Assumir que Codex “sabe” task-flow | Sem `.mdc` no prompt, comportamento genérico |
-| `task-flow: audit` em todo commit pequeno | Use `improve changes` |
+| `task-flow: audit` em todo commit pequeno | Use `task-flow: validate` ou escopo manual nos paths alterados |
 | Duplicar git rules em 3 arquivos sem necessidade | Desperdício do orçamento 32 KiB |
 | `CODEX_DISABLE_PROJECT_DOC=1` esquecido no env | AGENTS.md ignorado |
 
@@ -316,7 +303,7 @@ Codex **não** substitui `task-flow: sync` — isso é trabalho do agente lendo
 | Ignora “nunca commit” | AGENTS truncado ou não carregado | `Summarize current instructions`; reduzir AGENTS |
 | Não atualiza status | Procedimento não no prompt | Citir `task-flow-run/workflow.md` ou resumo embutido |
 | Comportamento diferente na subpasta | AGENTS local sobrescreve | Revisar `packages/*/AGENTS.md` |
-| Muito contexto em standards | audit puxou arquivo inteiro | Escopo `improve changes` + paths |
+| Muito contexto em standards | audit puxou arquivo inteiro | Limite paths no prompt ou use checklist só nos arquivos alterados |
 | Conflito global vs repo | `~/.codex/AGENTS.md` | Simplificar global; detalhe no repo |
 
 ---
@@ -328,7 +315,7 @@ Codex **não** substitui `task-flow: sync` — isso é trabalho do agente lendo
 - [x] `.codex/config.toml` com `project_doc_max_bytes = 65536`
 - [ ] Tamanho `AGENTS.md` < ~28 KiB se não usar config.toml
 - [ ] Prompts citam `AGENTS.md` + `.task-flow/guides/CODEX.md` para `run`
-- [ ] `improve changes` + `check` antes de PR
+- [ ] `task-flow: validate` antes de PR quando relevante
 - [ ] `AGENTS.md` em subpastas de monorepo se necessário
 
 ---
@@ -362,7 +349,7 @@ Ao implementar código, seguir o checklist em `.cursor/rules/coding_standards.md
 
 ## 15. Graphify (opcional)
 
-Não adicionamos Graphify ao `AGENTS.md` (limite 32 KiB). Em **`task-flow: run`**, peça no prompt: `graphify query "…"` se `graphify-out/` existir. Ver [GRAPHIFY.md](../GRAPHIFY.md).
+Não adicionamos Graphify ao `AGENTS.md` (limite 32 KiB). Em **`task-flow: run`**, peça no prompt: `graphify query "…"` se `.task-flow/guides/graphify-out/` existir. Ver [GRAPHIFY.md](../GRAPHIFY.md).
 
 ---