rbin-task-flow 1.25.1 → 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/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).
 
 ---
 

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

@@ -8,13 +8,13 @@ Guia para extrair o máximo do **RBIN Task Flow** no [Cursor](https://cursor.com
 
 ## 1. Por que o Task Flow “nasce” bem no Cursor
 
-O instalador copia regras para `.cursor/rules/` e **14 skills** para `.cursor/skills/`. Desde **v1.23** (otimização P0 — ver [OPTIMIZATION-PLAN.md](../OPTIMIZATION-PLAN.md)):
+O instalador copia regras para `.cursor/rules/` e **10 skills** para `.cursor/skills/`. Desde **v1.23** (otimização P0 — ver [OPTIMIZATION-PLAN.md](../OPTIMIZATION-PLAN.md)):
 
 | Camada | O que carrega | Tokens (~) |
 |--------|----------------|------------|
 | **Always-on (2)** | `task-flow-cursor.mdc`, `rbin-git-policy.mdc` | ~0,9k / turno |
 | **Skills** | `@task-flow-run`, `@task-flow-sync`, … | sob demanda |
-| **Intelligent** | `task_work`, `task_audit`, `task_analysis` (think), … | quando o Agent casa `description` |
+| **Intelligent** | `task_work`, `task_audit`, `task_validate`, … | quando o Agent casa `description` |
 | **Glob** | `task-flow-sync`, `task_generation` (`.task-flow/**`), `coding_standards` (`src/**`, `app/**`) | arquivos no contexto |
 
 Isso significa:
@@ -44,7 +44,7 @@ Documentação: [Cursor Rules](https://cursor.com/docs/context/rules) · Referê
 |------|-------------|-------------------------|
 | **Always Apply** | `alwaysApply: true` | `task-flow-cursor`, `rbin-git-policy` only |
 | **Apply to Specific Files** | `globs: "**/.task-flow/**"` | Regras só ao editar tasks/status/contexts |
-| **Apply Intelligently** | `description` rica, `alwaysApply: false`, sem globs | `task_audit`, `task_refactor` — quando o assunto é auditoria/refactor |
+| **Apply Intelligently** | `description` rica, `alwaysApply: false`, sem globs | `task_audit`, `task_validate` — quando o assunto é auditoria/validação |
 | **Apply Manually** | sem description/globs, `alwaysApply: false` | Rascunhos, regras experimentais — `@nome-da-regra` |
 
 ### Matriz frontmatter (oficial Cursor)
@@ -70,18 +70,13 @@ Confirme no projeto: `rg 'alwaysApply: true' .cursor/rules` → deve listar **ap
 | `rbin-git-policy.mdc` | git write proibido + sugestão de commit | **Always** |
 | `task_work.mdc` | fallback curto de `run` | Intelligent — use `@task-flow-run` |
 | `task_execution.mdc` | índice stub → skills | Intelligent / `@` manual |
+| `task_from_contexts.mdc` | draft tasks de `contexts/` | Intelligent |
 | `task-flow-sync.mdc` | `sync` completo | **Glob** `.task-flow/**` · prefer `@task-flow-sync` |
 | `task_generation.mdc` | templates de subtarefas | **Glob** `.task-flow/**` |
-| `task_analysis.mdc` | `think` apenas | Intelligent |
 | `task_status.mdc` | `status` | **Glob** `.task-flow/**` |
 | `task_audit.mdc` | audit vs checklist standards | Intelligent |
-| `task_improve_changes.mdc` | audit só no diff | Intelligent |
-| `task_check.mdc` | lint + build | Intelligent |
-| `task_review.mdc` | verificar “done” | Intelligent |
-| `task_refactor.mdc` | refactor sem mudar comportamento | Intelligent |
 | `task_estimate.mdc` | estimativas | Intelligent / `@` |
 | `task_report.mdc` | relatórios | Intelligent / `@task-flow-report` |
-| `task_generate_flow.mdc` | `tasks.flow.md` | Intelligent / `@` |
 | `coding_standards.mdc` | checklist (~100 linhas) | **Glob** `src/**`, `app/**` |
 | `code_comments.mdc` | sem comentários explicativos | **Glob** `**/*.{ts,tsx,js,jsx}` |
 | `graphify-task-flow.mdc` | Graphify + Task Flow | Intelligent |
@@ -113,9 +108,9 @@ Cursor suporta o mesmo formato que Claude Code: `.cursor/skills/<nome>/SKILL.md`
 | Mesmo workflow em Claude + Cursor | Skills em **ambas** pastas | ✅ |
 | Referência enorme (coding standards) | checklist glob (~1k tokens) | `@rbin-coding-standards` + full doc por seção |
 
-O `rbin-task-flow init` copia **14 skills** para `.cursor/skills/` (mesmo conteúdo que `.claude/skills/`). No Agent, use `@task-flow-run`, `@task-flow-sync`, etc.
+O `rbin-task-flow init` copia **10 skills** para `.cursor/skills/` (mesmo conteúdo que `.claude/skills/`). No Agent, use `@task-flow-run`, `@task-flow-sync`, etc.
 
-Após `rbin-task-flow init` ou `update`, use `@task-flow-*` no Agent. Para sync: `@task-flow-sync` (não `task_generation` / `task_analysis` isolados).
+Após `rbin-task-flow init` ou `update`, use `@task-flow-*` no Agent. Para sync: `@task-flow-sync` (não `task_generation` isolado).
 
 ---
 
@@ -124,7 +119,7 @@ Após `rbin-task-flow init` ou `update`, use `@task-flow-*` no Agent. Para sync:
 | Superfície | Task Flow | Dica |
 |------------|-----------|------|
 | **Agent** (Ctrl+I / Composer) | Melhor para `run next X`, implementação multi-arquivo | Abra arquivos de `contexts/` no chat se UI |
-| **Chat** | `sync`, `think`, `status`, `estimate` | Peça explicitamente `task-flow: …` |
+| **Chat** | `sync`, `status`, `estimate` | Peça explicitamente `task-flow: …` |
 | **Cursor CLI** | Mesmas regras do projeto se `.cursor/rules` presente | Útil em CI local com agent |
 
 **MCP:** regras não substituem MCP (DB, APIs). Task Flow não conflita — subtarefas podem dizer “usar MCP X” em `tasks.json`.
@@ -156,25 +151,12 @@ task-flow: run next 4
 
 Ao terminar cada subtarefa, o Agent deve atualizar `status.json` + `tasks.status.md` (`@task-flow-run` / `task_work` stub).
 
-```text
-task-flow: check
-```
-
 Commit **manual** (regra `rbin-git-policy`).
 
 ### 6.3 Qualidade antes do merge
 
 ```text
-task-flow: improve changes
-task-flow: review 2
-```
-
-`improve changes` usa `git diff --name-only HEAD` — só arquivos alterados.
-
-### 6.4 Refactor pós-task
-
-```text
-task-flow: refactor 1
+task-flow: validate
 ```
 
 Remove comentários explicativos; mantém separadores `// ───`.
@@ -197,7 +179,6 @@ Coloque PNG/PDF/MD em `.task-flow/contexts/`. Nas subtarefas geradas, instruçõ
 | Execução clara | `task-flow: run next 3` |
 | Task específica | `task-flow: run 2` |
 | Sincronizar após editar input | `task-flow: sync` |
-| Auditoria focada | `task-flow: improve changes` (não `audit` no repo inteiro) |
 | Padrões ao codificar | `@rbin-coding-standards` ou arquivo em `src/` (checklist glob) |
 | Regra sob demanda | `@task-flow-audit` ou `@task_audit` + `task-flow: audit` |
 | Run explícito | `@task-flow-run` + `task-flow: run next 2` |
@@ -246,9 +227,9 @@ Cursor também pode ler `AGENTS.md` em alguns fluxos; no RBIN ele é focado em *
 |---------|-------------|
 | **@-mentions** | `@tasks.input.txt`, `@contexts/dashboard.png`, `@task-flow-run` |
 | **Notepads / Docs** | Links para `.task-flow/README.md` |
-| **Bugbot / PR** | `task-flow: review X` antes de merge |
+| **Bugbot / PR** | `task-flow: validate` antes de merge |
 | **Background Agent** | `run next 1` por job; cuidado com conflito de `status.json` |
-| **Plan mode** | `think` + `sync` para gerar tasks antes de `run` |
+| **Plan mode** | Edite `tasks.input.txt` + `sync` antes de `run` |
 
 ---
 
@@ -260,9 +241,8 @@ Cursor também pode ler `AGENTS.md` em alguns fluxos; no RBIN ele é focado em *
 | `rbin-task-flow update` | Atualiza rules; preserva `.internal/` |
 | `rbin-task-flow reset` | Recria `.task-flow` do zero |
 | `rbin-task-flow reset --graphify` | Reset + `graphify extract . --backend claude-cli` |
-| `rbin-task-flow audit` | Lista arquivos **unstaged** (não substitui `task-flow: improve changes`) |
 
-O Agent executa o workflow; o CLI prepara arquivos.
+O Agent executa o workflow (`task-flow: audit`, `task-flow: run`, etc.); o CLI prepara arquivos.
 
 ---
 
@@ -301,13 +281,12 @@ Para open source: documente no README — contribuidores podem usar `--share-ai-
 ## 13. Checklist de maturidade Cursor + Task Flow
 
 - [x] `task-flow-cursor.mdc` + `rbin-git-policy.mdc` (2 always-on, v1.23)
-- [x] 14 skills em `.cursor/skills/` após `init`
+- [x] 10 skills em `.cursor/skills/` após `init`
 - [x] Otimização P0 de tokens (ver §3)
 - [ ] `task-flow: sync` após cada edição em `tasks.input.txt`
 - [ ] `@task-flow-run` (não `@task_work`) para implementar
 - [ ] Contextos em `.task-flow/contexts/` para tasks de UI
-- [ ] `improve changes` antes de commit
-- [ ] `task-flow: check` antes de push
+- [ ] `task-flow: validate` antes de merge quando relevante
 - [ ] Time alinhado: git manual sempre
 
 ---
@@ -317,7 +296,7 @@ Para open source: documente no README — contribuidores podem usar `--share-ai-
 Com Graphify instalado (`rbin-install-dev`), o Task Flow traz **`graphify-task-flow.mdc`** (`alwaysApply: false`) em vez de depender do `graphify.mdc` always-on do `graphify cursor install`.
 
 - **`rbin-task-flow init`** rebaixa `graphify.mdc` upstream se existir.
-- Use Graphify só em **`task-flow: run`**, `think`, `review` — ver [GRAPHIFY.md](../GRAPHIFY.md).
+- Use Graphify só em **`task-flow: run`**, `validate` — ver [GRAPHIFY.md](../GRAPHIFY.md).
 
 ---
 

package/.task-flow/tasks.input.txt

@@ -9,10 +9,9 @@
 
 ## Contexts:
 
-- The `.task-flow/contexts/` folder is for AIs to consult when working on tasks (different file types: .md, .txt, .png, .jpg, .json, etc.)
-- Add specs, mockups, requirements, examples, or any reference file to this folder
-- RBIN Task Flow detects and references them when generating and implementing subtasks
-- To reference a specific context in a task: `task-flow-screen filename.ext`
+- The `.task-flow/contexts/` folder is for specs, mockups, requirements (`.md`, `.txt`, `.png`, `.jpg`, `.pdf`, `.json`, etc.)
+- **`task-flow: from contexts`** — reads new files in `contexts/` and appends `- tasks` here (then run `task-flow: sync`)
+- Manual reference in a task: `task-flow-screen filename.ext`
 - Example: `- Create login screen task-flow-screen login-mockup.png`
 
 ## Tasks: