rbin-task-flow 1.26.0 → 1.27.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-audit
3
3
  description: Audits the full codebase against RBIN coding standards with a score table and asks which improvements to adopt. Use when the user says task-flow audit or audit coding standards for the whole project.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  ---
6
6
 
7
7
  # Task Flow — Audit
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-estimate
3
3
  description: Estimates hours for RBIN Task Flow tasks (single ID, comma-separated IDs, or all). Use when the user says task-flow estimate 1, estimate 1,2, estimate all, or time estimate for tasks.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  paths: [".task-flow/**"]
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-from-contexts
3
3
  description: Creates tasks in tasks.input.txt from files in .task-flow/contexts/ (images, PDF, text, etc.). Use when the user says task-flow from contexts, import contexts, gerar tasks dos contexts, or criar tasks a partir dos contexts.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  paths: [".task-flow/**"]
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-report
3
3
  description: Generates implementation markdown report for completed RBIN Task Flow tasks. Use when the user says task-flow report X or document completed task.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  paths: [".task-flow/**"]
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-run
3
3
  description: Executes RBIN Task Flow subtasks from tasks.json and status.json. Use when the user says task-flow run, run next X subtasks, work on task N, execute pending subtasks, implement task flow, or trabalhar nas próximas subtarefas.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  paths: [".task-flow/**"]
6
6
  ---
7
7
 
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: task-flow-split
3
+ description: Plans N parallel IA streams from pending tasks (split:N required). Non-conflicting areas, ordered by difficulty, outputs task-flow run X,Y,Z per tier. Use for task-flow split:3, split:2, dividir em 3 ias — not plain split.
4
+ disable-model-invocation: false
5
+ paths: [".task-flow/**"]
6
+ ---
7
+
8
+ # Task Flow — Split
9
+
10
+ ## Status
11
+
12
+ !`head -20 .task-flow/tasks.status.md 2>/dev/null || echo "Run sync first"`
13
+
14
+ ## Steps
15
+
16
+ 1. Parse **`split:N`** — N required (e.g. `split:3`). Plain `split` without `:N` → ask user. Optional scope: `split:3 50-72` or `split:2 50,51`.
17
+ 2. Load pending IDs from `status.json`; read `tasks.json` for those tasks.
18
+ 3. Partition into **N** non-conflicting streams; keep dependency chains together.
19
+ 4. Order streams IA-1 (strongest) → IA-N by difficulty.
20
+ 5. Output **N lines:** `task-flow: run id,id,id` + coordination notes.
21
+ 6. **Do not** implement or update status.
22
+
23
+ Reference: `.cursor/rules/task_split.mdc`
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-status
3
3
  description: Shows RBIN Task Flow progress from tasks.status.md. Use when the user says task-flow status, show task status, status das tasks, or ver progresso das tarefas.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  ---
6
6
 
7
7
  # Task Flow — Status
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-sync
3
3
  description: Synchronizes RBIN Task Flow tasks.input.txt with tasks.json, status.json, and tasks.status.md. Use when the user says task-flow sync, sync tasks, sincronizar tasks, or after editing tasks.input.txt.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  paths: [".task-flow/**"]
6
6
  ---
7
7
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-flow-validate
3
3
  description: Deep-validates RBIN Task Flow tasks against the codebase, reverts false done status, and appends missing gaps to tasks.input.txt then syncs. Use when the user says task-flow validate, validate all, validar tasks, or verificar lacunas.
4
- disable-model-invocation: true
4
+ disable-model-invocation: false
5
5
  ---
6
6
 
7
7
  # Task Flow — Validate
@@ -23,6 +23,7 @@ alwaysApply: true
23
23
  | `task-flow: sync` | `@task-flow-sync` or [task-flow-sync.mdc](mdc:.cursor/rules/task-flow-sync.mdc) |
24
24
  | `task-flow: from contexts` | `@task-flow-from-contexts` |
25
25
  | `task-flow: run next X`, `run N` | `@task-flow-run` |
26
+ | `task-flow: split:N` | `@task-flow-split` |
26
27
  | `task-flow: status` | `@task-flow-status` |
27
28
  | `task-flow: audit` | `@task-flow-audit` |
28
29
  | `task-flow: validate` | `@task-flow-validate` |
@@ -6,7 +6,7 @@ alwaysApply: false
6
6
 
7
7
  # task-flow: sync
8
8
 
9
- **Prefer:** `@task-flow-sync` · Skill workflow: `.claude/skills/task-flow-sync/workflow.md`
9
+ **Prefer:** `@task-flow-sync` · Skill: `.claude/skills/task-flow-sync/workflow.md` · Works with `/task-flow-sync` and `task-flow: sync`.
10
10
 
11
11
  ## 1. Read
12
12
 
@@ -14,6 +14,7 @@ alwaysApply: false
14
14
  | `task-flow: sync` | `@task-flow-sync` |
15
15
  | `task-flow: from contexts` | `@task-flow-from-contexts` |
16
16
  | `task-flow: run next X`, `run N` | `@task-flow-run` |
17
+ | `task-flow: split:N` | `@task-flow-split` |
17
18
  | `task-flow: status` | `@task-flow-status` |
18
19
  | `task-flow: audit` | `@task-flow-audit` |
19
20
  | `task-flow: validate` | `@task-flow-validate` |
@@ -0,0 +1,112 @@
1
+ ---
2
+ description: Plans parallel task-flow run across N AIs — split:N required. Splits pending tasks into non-conflicting streams ordered by difficulty. Use for task-flow split:3, split:2, etc.
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # task-flow: split:N
7
+
8
+ **Prefer:** `@task-flow-split` · **Does not implement** — only outputs copy-paste `task-flow: run X,Y,Z` per IA tier.
9
+
10
+ **`N` is required.** Plain `task-flow: split` (without `:N`) is invalid — ask for `split:2`, `split:3`, etc.
11
+
12
+ ## When to run
13
+
14
+ - `task-flow: split:3` — all pending, 3 IAs
15
+ - `task-flow: split:2` — all pending, 2 IAs
16
+ - `task-flow: split:3 50-72` — scope range, 3 IAs
17
+ - `task-flow: split:2 50,51,69` — scope list, 2 IAs
18
+
19
+ Natural language: `dividir pending em 3 ias` → `split:3`.
20
+
21
+ Default scope (no trailing ids): **all tasks with any pending subtask** in `status.json`.
22
+
23
+ ## What it does NOT do
24
+
25
+ - Does **not** run subtasks or edit `status.json` / `tasks.json`
26
+ - Does **not** replace `task-flow: run` — user pastes each output line into a separate IA session
27
+
28
+ ## Process
29
+
30
+ ### 1. Parse N and scope
31
+
32
+ - **N:** integer ≥1 from `split:N` (typical 2–4)
33
+ - **Scope:** optional `50-72` or `50,51,69` after `split:N`
34
+ - If `N` missing or invalid, stop and show examples
35
+
36
+ ### 2. Load pending scope
37
+
38
+ - Read `status.json` — task IDs with ≥1 `pending` or `in_progress` subtask
39
+ - Filter by scope if provided
40
+ - Read matching tasks from `tasks.json`
41
+ - If zero pending, report and stop
42
+
43
+ ### 3. Infer touch areas (conflict detection)
44
+
45
+ Per task, infer **primary file/module areas** from subtask `instructions` and task text.
46
+
47
+ Optional: `graphify query` when `.task-flow/guides/graphify-out/graph.json` exists.
48
+
49
+ Two tasks **conflict** if they likely edit the **same files or same service/module** in parallel.
50
+
51
+ ### 4. Detect dependency chains
52
+
53
+ Sequential / dependent tasks → **same stream**, **ascending ID order**. Never split a chain across IAs.
54
+
55
+ ### 5. Partition into N streams
56
+
57
+ Goal: **up to N** non-overlapping streams.
58
+
59
+ 1. Group conflicting tasks in the same stream
60
+ 2. Balance into **N** streams with minimal cross-stream overlap
61
+ 3. If pending tasks < N, output that many streams only (no empty streams)
62
+
63
+ ### 6. Order streams by difficulty (IA tier)
64
+
65
+ Strongest model → **IA-1**, then IA-2 … IA-N:
66
+
67
+ | Position | Typical content |
68
+ |----------|-----------------|
69
+ | IA-1 (strongest) | Auth, migrations, Firestore rules, money/idempotency, architecture |
70
+ | Mid tiers | Feature work, integrations |
71
+ | IA-N (lightest) | UI tweaks, verification, docs, small fixes |
72
+
73
+ Within each stream: task IDs **ascending**.
74
+
75
+ ### 7. Output (required format)
76
+
77
+ ```markdown
78
+ ## Task Flow Split (:3)
79
+
80
+ **Pending in scope:** N tasks · **Streams:** 3
81
+
82
+ ### 🟣 IA-1 — strongest (…)
83
+ task-flow: run 58,61,62,63,64,65,66,67,68
84
+
85
+ ### 🟢 IA-2 — (…)
86
+ task-flow: run 50,51,59,53,60
87
+
88
+ ### 🔵 IA-3 — (…)
89
+ task-flow: run 52,54,55,56,57,69,70,71,72
90
+
91
+ ### ⚠️ Coordination
92
+ - …
93
+
94
+ ### Next
95
+ Paste one block per IA session. `task-flow: status`
96
+ ```
97
+
98
+ For `split:2`, use two tiers (🟣 IA-1, 🟢 IA-2). For `split:4`, add 🟡 IA-4, etc.
99
+
100
+ One **`task-flow: run id,id,id`** line per stream.
101
+
102
+ ### 8. Coordination notes
103
+
104
+ Call out shared files between streams, read-after-write deps, and ordering inside each list.
105
+
106
+ ## Integration
107
+
108
+ - Execute: `@task-flow-run` per stream
109
+ - Status: `@task-flow-status`
110
+ - Git: [rbin-git-policy.mdc](mdc:.cursor/rules/rbin-git-policy.mdc)
111
+
112
+ **Principle:** `split:N` = plan N parallel `run` commands; user owns N sessions; no execution.
@@ -81,6 +81,7 @@ Guia completo: [guides/GRAPHIFY.md](guides/GRAPHIFY.md).
81
81
  | `task-flow: validate` | `all` (default) · `X` · `X,Y` | Deep audit vs codebase; revert false done; append gaps to `tasks.input.txt`; sync |
82
82
  | `task-flow: status` | — | Shows current task status |
83
83
  | `task-flow: run` | `next X` · `X` · `X,Y` · `all` | Execute pending subtasks: next N in order, one/many tasks, or everything |
84
+ | `task-flow: split` | `:3` · `:2` · `:3 50-72` | Plan **N** parallel `run` lines — `:N` required |
84
85
  | `task-flow: estimate` | `X` · `X,Y` · `all` | Time estimate for average developer pace (hours + management buffer) |
85
86
  | `task-flow: report` | `X` · `X,Y` · `all` | Implementation report → `.task-flow/guides/reports/task-X-implementation.md` |
86
87
  | `task-flow: audit` | — | Audits codebase against **coding standards checklist**; full doc on demand |
@@ -126,6 +127,15 @@ Audits the **entire codebase** against the **checklist** in [coding_standards.md
126
127
 
127
128
  ## Commands with Task ID
128
129
 
130
+ ### `task-flow: split:N`
131
+ Plans **parallel work across N IAs** (`split:3`, `split:2`, …). **`:N` is required** — plain `split` is invalid.
132
+
133
+ **Examples:**
134
+ - `task-flow: split:3` — all pending, 3 streams
135
+ - `task-flow: split:2 50-72` — range, 2 streams
136
+
137
+ Output: N copy-paste lines `task-flow: run id,id,id` + coordination notes. Invoke: `@task-flow-split`.
138
+
129
139
  ### `task-flow: run next X`
130
140
  Works on next X pending subtasks in sequential order. Implements and marks as "done".
131
141
 
@@ -33,8 +33,9 @@ Os comandos `task-flow: …` são **os mesmos** em Claude Code, Cursor e Codex.
33
33
  1. Definir tasks: editar `tasks.input.txt` **ou** colocar specs em `contexts/` e rodar `task-flow: from contexts`
34
34
  2. `task-flow: sync`
35
35
  3. `task-flow: status`
36
- 4. `task-flow: run next X` ou `task-flow: run N`
37
- 5. **Você** faz `git commit` (a IA sugere)
36
+ 4. `task-flow: split:3` (opcional N IAs em paralelo) → colar cada `run X,Y,Z` numa sessão
37
+ 5. `task-flow: run next X` ou `task-flow: run N`
38
+ 6. **Você** faz `git commit` (a IA só sugere)
38
39
 
39
40
  Detalhes dos comandos: [README.md](../README.md).
40
41
 
@@ -55,7 +56,7 @@ Detalhes dos comandos: [README.md](../README.md).
55
56
  | `.codex/config.toml` | — | — | ✅ (opcional, preservado no update) |
56
57
  | `task-flow-cursor.mdc` | — | ✅ always-on | — |
57
58
  | `rbin-git-policy.mdc` | — | ✅ always-on | — |
58
- | `.claude/skills/` | ✅ (10 skills) | — | — |
59
+ | `.claude/skills/` | ✅ (11 skills) | — | — |
59
60
  | `.cursor/skills/` | — | ✅ (espelho) | — |
60
61
 
61
62
  Por padrão, `.claude/`, `.cursor/`, `.task-flow/`, `CLAUDE.md` e `AGENTS.md` entram no **`.gitignore`** do projeto cliente. Para versionar skills/regras com o time, ajuste o ignore — veja a seção “Versionamento” em cada guia.
@@ -29,6 +29,19 @@ Rule: `.cursor/rules/task_from_contexts.mdc`
29
29
 
30
30
  ---
31
31
 
32
+ ## task-flow: split:N
33
+
34
+ 1. **N obrigatório** — `split:3`, `split:2`. `split` sem `:N` → inválido.
35
+ 2. Escopo opcional: `split:3 50-72` ou `split:2 50,51,69`; senão todas pending.
36
+ 3. Particionar em **N** filas sem conflito; cadeias na mesma fila.
37
+ 4. Ordenar IA-1 (mais forte) → IA-N por dificuldade.
38
+ 5. Output N linhas `task-flow: run id,id,id` + coordenação.
39
+ 6. **Não** implementar nem editar status.
40
+
41
+ Rule: `.cursor/rules/task_split.mdc`
42
+
43
+ ---
44
+
32
45
  ## task-flow: run next X | run X | run all
33
46
 
34
47
  See AGENTS.md **Run** section. Prefer `.claude/skills/task-flow-run/workflow.md`; fallback: `.cursor/rules/task_work.mdc`.
@@ -23,6 +23,7 @@ Verify: `rg 'alwaysApply: true' .cursor/rules` → only the two files above.
23
23
  |---------------------|-------------|
24
24
  | `task-flow: from contexts` | `@task-flow-from-contexts` |
25
25
  | `task-flow: sync` | `@task-flow-sync` |
26
+ | `task-flow: split:N` | `@task-flow-split` |
26
27
  | `task-flow: run next 4` | `@task-flow-run` |
27
28
  | `task-flow: status` | `@task-flow-status` |
28
29
  | `task-flow: validate` | `@task-flow-validate` |
@@ -29,7 +29,7 @@ projeto/
29
29
  ├── CLAUDE.md # Índice enxuto + tabela de skills
30
30
  ├── .claude/
31
31
  │ ├── settings.json
32
- │ └── skills/ # 10 skills (task-flow-*, rbin-*)
32
+ │ └── skills/ # 11 skills (task-flow-*, rbin-*)
33
33
  ├── .cursor/
34
34
  │ ├── rules/ # Referência + Cursor alwaysApply
35
35
  │ └── skills/ # Espelho das mesmas skills
@@ -87,7 +87,8 @@ task-flow-run/
87
87
  |-------|-------------------|
88
88
  | `description` | **Obrigatório para descoberta.** Terceira pessoa, WHAT + WHEN, termos `task-flow`, `run next`, `sync`, `RBIN`. Limite ~1536 caracteres na listagem. |
89
89
  | `name` | Opcional; comando `/` vem do **nome da pasta** (`task-flow-run` → `/task-flow-run`). |
90
- | `disable-model-invocation: true` | Workflows com efeito colateral: `run`, `sync`, deploy. Você dispara; Claude não “decide” sozinho. |
90
+ | `disable-model-invocation: true` | em skills pesadas de referência (`rbin-coding-standards`) evita auto-carregar standards inteiros. |
91
+ | `disable-model-invocation: false` | **`task-flow-*`** (`sync`, `run`, `validate`, …) — `/task-flow-sync` e `task-flow: sync` devem executar quando você pede. |
91
92
  | `user-invocable: false` | Conhecimento de fundo (ex.: legado) — raro no Task Flow. |
92
93
  | `allowed-tools` | Restringir ferramentas em skills sensíveis (ex.: só `Read`, `Grep` para audit read-only). |
93
94
  | `paths` | Ex.: `[".task-flow/**"]` — auto-carregar skill ao editar arquivos de task. |
@@ -98,7 +99,7 @@ task-flow-run/
98
99
  | Tipo | Exemplo Task Flow |
99
100
  |------|------------------|
100
101
  | **Referência** | `/rbin-coding-standards` sob demanda (`disable-model-invocation: true`) — checklist primeiro |
101
- | **Tarefa** | `task-flow-run`, `task-flow-sync` — passos sequenciais; use `disable-model-invocation: true` |
102
+ | **Tarefa** | `task-flow-run`, `task-flow-sync` — `disable-model-invocation: false` (usuário dispara; `/` e `task-flow:` devem funcionar) |
102
103
 
103
104
  Mantenha o corpo do `SKILL.md` **curto** (< 500 linhas). Detalhe em `workflow.md`.
104
105
 
@@ -143,6 +144,7 @@ Para Task Flow em equipe: prefira **skills de projeto** versionadas (ajuste o `.
143
144
  | `task-flow: from contexts` | `task-flow-from-contexts` | `/task-flow-from-contexts` | `task_from_contexts.mdc` |
144
145
  | `task-flow: sync` | `task-flow-sync` | `/task-flow-sync` | `task-flow-sync.mdc` · `task_generation.mdc` (subtasks) |
145
146
  | `task-flow: run next X` / `run X` | `task-flow-run` | `/task-flow-run` | `workflow.md` · stub `task_work.mdc` |
147
+ | `task-flow: split:N` | `task-flow-split` | `/task-flow-split` | `task_split.mdc` |
146
148
  | `task-flow: status` | `task-flow-status` | `/task-flow-status` | `task_status.mdc` |
147
149
  | `task-flow: audit` | `task-flow-audit` | `/task-flow-audit` | `task_audit.mdc` |
148
150
  | `task-flow: estimate X` / `X,Y` / `all` | `task-flow-estimate` | `/task-flow-estimate` | `task_estimate.mdc` |
@@ -160,7 +162,7 @@ Para Task Flow em equipe: prefira **skills de projeto** versionadas (ajuste o `.
160
162
  ---
161
163
  name: task-flow-run
162
164
  description: Executes RBIN Task Flow subtasks from tasks.json and status.json. Use when the user says task-flow run, run next X subtasks, work on task N, execute pending subtasks, or implement task flow.
163
- disable-model-invocation: true
165
+ disable-model-invocation: false
164
166
  allowed-tools: Read Write Edit Glob Grep Shell
165
167
  paths: [".task-flow/**"]
166
168
  ---
@@ -218,7 +220,8 @@ Copie o corpo longo de `.cursor/rules/task_work.mdc` para `workflow.md`.
218
220
  ### 7.4 Múltiplos agentes no mesmo repo
219
221
 
220
222
  - Use **checagem de dependência** (`run 3` só se 1–2 done) — já em `task_work.mdc`.
221
- - Skills com `disable-model-invocation: true` evitam dois Claudes disparando `sync` ao mesmo tempo sem intenção.
223
+ - Skills `task-flow-*` com `disable-model-invocation: false` `/` e linguagem natural executam o workflow.
224
+ - `rbin-coding-standards` mantém `true` para não inflar contexto sem pedido.
222
225
 
223
226
  ---
224
227
 
@@ -305,7 +308,8 @@ Ou use `AGENTS.override.md` / settings locais fora do git e commite `.claude/ski
305
308
  | Evite | Por quê |
306
309
  |-------|---------|
307
310
  | Colar `task_work.mdc` inteiro no `CLAUDE.md` | Estoura contexto fixo da sessão |
308
- | `disable-model-invocation: false` em `sync`/`run` | Claude pode executar workflow pesado sem você pedir |
311
+ | Confiar só em `/` sem ler SKILL quando Skill tool falha | Use `task-flow: sync` + leia `workflow.md` nunca diga que sync é "só manual" |
312
+ | `disable-model-invocation: true` em `sync`/`run` | Bloqueia `/task-flow-sync` no Claude Code; use `false` nos `task-flow-*` |
309
313
  | Editar `status.json` à mão | Dessincroniza `tasks.status.md` |
310
314
  | Confiar só em “continua as tasks” | Sem número ou skill, ordem fica ambígua |
311
315
  | Ignorar reinício após criar `.claude/skills/` | Skills não aparecem no `/` |
@@ -315,7 +319,7 @@ Ou use `AGENTS.override.md` / settings locais fora do git e commite `.claude/ski
315
319
  ## 13. Checklist de maturidade Claude + Task Flow
316
320
 
317
321
  - [x] `CLAUDE.md` enxuto com índice de skills
318
- - [x] Skills instaladas via `rbin-task-flow init` (10 skills)
322
+ - [x] Skills instaladas via `rbin-task-flow init` (11 skills)
319
323
  - [x] `paths: [".task-flow/**"]` em `task-flow-run`, `sync`, `estimate`, `report`
320
324
  - [x] Injeção `` !`head tasks.status.md` `` em `task-flow-run`
321
325
  - [ ] `.claude/skills/` versionado no git (ajustar `.gitignore` se o time quiser)
@@ -154,6 +154,7 @@ Codex prefere `AGENTS.override.md` sobre `AGENTS.md` **no mesmo nível**.
154
154
  | Comando | Prompt mínimo eficaz |
155
155
  |---------|---------------------|
156
156
  | `task-flow: from contexts` | `task_from_contexts.mdc — leia contexts/, append tasks em tasks.input.txt` |
157
+ | `task-flow: split:N` | `task_split.mdc — split:3 ou split:2 50-72, output task-flow: run id,id,id` |
157
158
  | `task-flow: sync` | `Leia AGENTS.md e task-flow-sync.mdc. Execute task-flow: sync em tasks.input.txt.` |
158
159
  | `task-flow: run next 3` | `Siga task-flow-run workflow.md. task-flow: run next 3. Atualize status.json e tasks.status.md.` |
159
160
  | `task-flow: run 2` | Idem + respeitar dependências tasks 1..X-1 |
@@ -8,7 +8,7 @@ Guia para extrair o máximo do **RBIN Task Flow** no [Cursor](https://cursor.com
8
8
 
9
9
  ## 1. Por que o Task Flow “nasce” bem no Cursor
10
10
 
11
- 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)):
11
+ O instalador copia regras para `.cursor/rules/` e **11 skills** para `.cursor/skills/`. Desde **v1.23** (otimização P0 — ver [OPTIMIZATION-PLAN.md](../OPTIMIZATION-PLAN.md)):
12
12
 
13
13
  | Camada | O que carrega | Tokens (~) |
14
14
  |--------|----------------|------------|
@@ -71,6 +71,7 @@ Confirme no projeto: `rg 'alwaysApply: true' .cursor/rules` → deve listar **ap
71
71
  | `task_work.mdc` | fallback curto de `run` | Intelligent — use `@task-flow-run` |
72
72
  | `task_execution.mdc` | índice stub → skills | Intelligent / `@` manual |
73
73
  | `task_from_contexts.mdc` | draft tasks de `contexts/` | Intelligent |
74
+ | `task_split.mdc` | plano paralelo `split:N` | Intelligent |
74
75
  | `task-flow-sync.mdc` | `sync` completo | **Glob** `.task-flow/**` · prefer `@task-flow-sync` |
75
76
  | `task_generation.mdc` | templates de subtarefas | **Glob** `.task-flow/**` |
76
77
  | `task_status.mdc` | `status` | **Glob** `.task-flow/**` |
@@ -108,7 +109,7 @@ Cursor suporta o mesmo formato que Claude Code: `.cursor/skills/<nome>/SKILL.md`
108
109
  | Mesmo workflow em Claude + Cursor | Skills em **ambas** pastas | ✅ |
109
110
  | Referência enorme (coding standards) | checklist glob (~1k tokens) | `@rbin-coding-standards` + full doc por seção |
110
111
 
111
- 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.
112
+ O `rbin-task-flow init` copia **11 skills** para `.cursor/skills/` (mesmo conteúdo que `.claude/skills/`). No Agent, use `@task-flow-split`, `@task-flow-run`, `@task-flow-sync`, etc.
112
113
 
113
114
  Após `rbin-task-flow init` ou `update`, use `@task-flow-*` no Agent. Para sync: `@task-flow-sync` (não `task_generation` isolado).
114
115
 
@@ -281,7 +282,7 @@ Para open source: documente no README — contribuidores podem usar `--share-ai-
281
282
  ## 13. Checklist de maturidade Cursor + Task Flow
282
283
 
283
284
  - [x] `task-flow-cursor.mdc` + `rbin-git-policy.mdc` (2 always-on, v1.23)
284
- - [x] 10 skills em `.cursor/skills/` após `init`
285
+ - [x] 11 skills em `.cursor/skills/` após `init`
285
286
  - [x] Otimização P0 de tokens (ver §3)
286
287
  - [ ] `task-flow: sync` após cada edição em `tasks.input.txt`
287
288
  - [ ] `@task-flow-run` (não `@task_work`) para implementar
package/AGENTS.md CHANGED
@@ -31,6 +31,7 @@ No explanatory comments. Complex topics → `dev-logs/*.md`. Allowed: `// ──
31
31
  | `task-flow: sync` | Section **Sync** below; details `.task-flow/guides/CODEX.md` |
32
32
  | `task-flow: from contexts` | `.cursor/rules/task_from_contexts.mdc` · then `sync` |
33
33
  | `task-flow: run …` | Section **Run** below; details `.task-flow/guides/CODEX.md` |
34
+ | `task-flow: split:N` | `.cursor/rules/task_split.mdc` · N obrigatório (`split:3`, `split:2 50-72`) |
34
35
  | `task-flow: status` | `.task-flow/tasks.status.md` |
35
36
  | `task-flow: audit` | `.cursor/rules/task_audit.mdc` · checklist `coding_standards.mdc` (full: `.task-flow/guides/coding-standards-full.md` if needed) |
36
37
  | `task-flow: validate` | `.cursor/rules/task_validate.mdc` · then sync |
package/CLAUDE.md CHANGED
@@ -16,6 +16,7 @@
16
16
  | Sync input → system | `/task-flow-sync` |
17
17
  | Draft tasks from `contexts/` | `/task-flow-from-contexts` |
18
18
  | Run subtasks | `/task-flow-run` |
19
+ | Split pending for N IAs (`split:3`, `split:2`, …) | `/task-flow-split` |
19
20
  | Status | `/task-flow-status` |
20
21
  | Audit repo | `/task-flow-audit` |
21
22
  | Validate + fill gaps | `/task-flow-validate` |
@@ -26,6 +27,15 @@
26
27
 
27
28
  Natural language `task-flow: …` works the same. Details: [.task-flow/README.md](.task-flow/README.md).
28
29
 
30
+ ## Skills vs `disable-model-invocation`
31
+
32
+ | Skill | Flag | Why |
33
+ |-------|------|-----|
34
+ | `task-flow-*` (`sync`, `run`, …) | `false` | You asked — `/task-flow-sync` and `task-flow: sync` must run the workflow |
35
+ | `rbin-coding-standards` | `true` | Heavy reference; invoke only when implementing code |
36
+
37
+ If the Skill tool ever refuses a slash command, still execute the workflow: read `.claude/skills/task-flow-*/SKILL.md` or `.cursor/rules/task-flow-*.mdc` — **never** tell the user sync/run is "only manual".
38
+
29
39
  ## Anti-patterns (save context)
30
40
 
31
41
  - Prefer **`/task-flow-run`** (or `@task-flow-run`) for executing subtasks — avoid `@task_work` plus duplicate `.cursor/rules/task_work.mdc` in the same turn.
package/README.md CHANGED
@@ -93,13 +93,13 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
93
93
 
94
94
  **Graphify (opcional):** grafo em `.task-flow/guides/graphify-out/`. Novo projeto: `rbin-task-flow init --graphify`. **Já tem Task Flow:** `npm install -g rbin-task-flow@latest` e `rbin-task-flow update --graphify` no projeto (migra `graphify-out/` da raiz + regera grafo). Detalhes: [.task-flow/README.md](.task-flow/README.md#graphify-opcional) · [GRAPHIFY.md](.task-flow/guides/GRAPHIFY.md).
95
95
 
96
- **Claude Code / Cursor skills (v1.20+):** `init` copia 10 skills para `.claude/skills/` e `.cursor/skills/` — use `/task-flow-from-contexts`, `/task-flow-sync`, `/task-flow-run`, etc.
96
+ **Claude Code / Cursor skills (v1.20+):** `init` copia 11 skills para `.claude/skills/` e `.cursor/skills/` — use `/task-flow-split`, `/task-flow-sync`, `/task-flow-run`, etc.
97
97
 
98
98
  **Codex (v1.21+):** `AGENTS.md` com sync/run embutidos, `.task-flow/guides/CODEX.md` sob demanda, `.codex/config.toml` (64 KiB).
99
99
 
100
100
  **Cursor (v1.23+):** `task-flow-cursor.mdc` + `rbin-git-policy.mdc` (2 always-on) + skills — ver `.task-flow/guides/CURSOR.md`.
101
101
 
102
- **Perfil minimal:** `init --profile minimal` instala só as 2 regras always-on e as 10 skills; workflows via `@task-flow-*` (sem `task_work`, `coding_standards` glob, etc.). `standard` (padrão) copia todas as regras `.cursor/rules/`.
102
+ **Perfil minimal:** `init --profile minimal` instala só as 2 regras always-on e as 11 skills; workflows via `@task-flow-*` (sem `task_work`, `coding_standards` glob, etc.). `standard` (padrão) copia todas as regras `.cursor/rules/`.
103
103
 
104
104
  **Compartilhar com o time:** `init --share-ai-config` não ignora `.cursor/skills/` nem `.cursor/rules/` no `.gitignore` (só `.cursor/settings.json` e overrides locais). Padrão: `.cursor/` inteiro ignorado — menos ruído no repo, config local por dev.
105
105
 
@@ -109,6 +109,7 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
109
109
  | `task-flow: sync` | **Sincroniza** tarefas do arquivo texto com o sistema | Mantém tudo sincronizado automaticamente - adiciona novas, remove deletadas, preserva seu progresso |
110
110
  | `task-flow: audit` | **Avalia** o quanto o código bate com os padrões de codificação | Analisa a codebase, dá um score por categoria e pergunta quais melhorias você quer adotar — sem impor nada |
111
111
  | `task-flow: status` | **Visualiza** o progresso rapidamente | Vê resumo com tasks completas, em andamento e quantas subtarefas faltam |
112
+ | `task-flow: split` | `:3` · `:2` · `:3 50-72` | **Divide** trabalho entre N IAs — gera N comandos `run X,Y,Z` (só plano) |
112
113
  | `task-flow: run next X` | **Automatiza** o trabalho nas próximas subtarefas | A IA trabalha nas próximas X subtarefas sequencialmente, você só acompanha |
113
114
  | `task-flow: run X` | **Completa** uma tarefa inteira de uma vez | Executa todas as subtarefas de uma tarefa específica (permite trabalho paralelo) |
114
115
  | `task-flow: run X,Y` | **Completa** múltiplas tarefas | Executa tarefas separadas por vírgula (ex: `task-flow: run 10,11`) |
@@ -475,11 +476,11 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
475
476
 
476
477
  **Graphify (optional):** graph at `.task-flow/guides/graphify-out/`. New project: `rbin-task-flow init --graphify`. **Existing project:** `npm install -g rbin-task-flow@latest` then `rbin-task-flow update --graphify` (migrates legacy root `graphify-out/` + re-extracts). See [.task-flow/README.md](.task-flow/README.md#graphify-opcional) · [GRAPHIFY.md](.task-flow/guides/GRAPHIFY.md).
477
478
 
478
- **Claude / Cursor skills (v1.20+):** installs 10 skills — use `/task-flow-from-contexts`, `/task-flow-sync`, `/task-flow-run`, etc.
479
+ **Claude / Cursor skills (v1.20+):** installs 11 skills — use `/task-flow-split`, `/task-flow-sync`, `/task-flow-run`, etc.
479
480
 
480
481
  **Codex (v1.21+):** optimized `AGENTS.md`, `.task-flow/guides/CODEX.md`, `.codex/config.toml`.
481
482
 
482
- **Cursor (v1.23+):** 2 always-on rules + 10 skills — `@task-flow-from-contexts`, `@task-flow-sync`, `@task-flow-run`.
483
+ **Cursor (v1.23+):** 2 always-on rules + 11 skills — `@task-flow-split`, `@task-flow-sync`, `@task-flow-run`.
483
484
 
484
485
  **Minimal profile:** `init --profile minimal` copies only `task-flow-cursor.mdc` and `rbin-git-policy.mdc` plus skills; use `@task-flow-*` for workflows. `standard` (default) copies all rules under `.cursor/rules/`.
485
486
 
@@ -491,6 +492,7 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
491
492
  | `task-flow: sync` | **Sync** tasks from text file with system | Keeps everything synchronized automatically - adds new, removes deleted, preserves your progress |
492
493
  | `task-flow: audit` | **Evaluate** how well your code matches coding standards | Scans the codebase, scores it by category and asks which improvements you want to adopt — never imposes changes |
493
494
  | `task-flow: status` | **Visualize** progress quickly | See summary with completed tasks, in progress, and remaining subtasks |
495
+ | `task-flow: split` | `:3` · `:2` · `:3 50-72` | **Split** work across N AIs — N `run` commands (plan only) |
494
496
  | `task-flow: run next X` | **Automate** work on next subtasks | AI works on next X subtasks sequentially, you just follow along |
495
497
  | `task-flow: run X` | **Complete** an entire task at once | Executes all subtasks of a specific task (allows parallel work) |
496
498
  | `task-flow: run X,Y` | **Complete** multiple tasks | Executes comma-separated tasks (e.g., `task-flow: run 10,11`) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rbin-task-flow",
3
- "version": "1.26.0",
3
+ "version": "1.27.1",
4
4
  "description": "AI-powered task management for Claude and Cursor",
5
5
  "main": "index.js",
6
6
  "bin": {