rbin-task-flow 1.27.1 → 1.30.3

package/AGENTS.md

@@ -13,6 +13,7 @@
 | `.task-flow/.internal/tasks.json` | Task definitions |
 | `.task-flow/.internal/status.json` | Status source of truth |
 | `.task-flow/contexts/` | Specs/mockups for subtasks |
+| `.task-flow/dev-logs/` | Manual steps + conversation log (AI updates from chat) |
 
 ## Git
 
@@ -52,12 +53,13 @@ No explanatory comments. Complex topics → `dev-logs/*.md`. Allowed: `// ──
 ## Run (embedded)
 
 1. Read `tasks.json` + `status.json`.
-2. `run next X` (default X=1): next X **pending** subtasks in order 1.1, 1.2, …, 2.1…
-3. `run X` / `X,Y` / `all`: all pending for task(s); for `run X`, block if tasks `1..X-1` have any pending subtask.
-4. Per subtask: follow `instructions`; read `contexts/` if cited; implement + verify.
-5. If `.task-flow/guides/graphify-out/graph.json` exists, prefer `graphify query … --graph .task-flow/guides/graphify-out/graph.json` before repo-wide grep.
-6. Mark subtask `done` in `status.json`; update `tasks.status.md` Summary.
-7. Parent task `done` when all subtasks done. Suggest commit; never git write.
+2. **Resolve `manual` first:** read dev-logs + conversation; append Conversation log; mark `done` only when verified.
+3. `run next X` (default X=1): next X **pending** subtasks (skip unresolved `manual`).
+4. `run X` / `X,Y` / `all`: all pending for task(s); block if tasks `1..X-1` have non-`done` subtasks.
+5. Per subtask: `instructions`; `contexts/`; implement + verify; optional `graphify query`.
+6. **Automatable** → `done`; **manual intervention** → `manual` + dev-log; user reports in chat; AI updates log and completes when verified.
+7. Parent task `done` when all subtasks `done`. Suggest commit; never git write.
+8. **Never** write `guides/reports/` during run.
 
 ## Prompt templates (copy)
 

package/README.md

@@ -33,7 +33,7 @@
 <a id="português"></a>
 # 🇧🇷 Português
 
-> **v1.25.1** — Padrão `.env` Vercel nos coding standards. De **1.25.0**: `npm install -g rbin-task-flow@1.25.1` e `rbin-task-flow update`. [CHANGELOG](CHANGELOG.md) · [Publicação](RELEASE-1.25.1.md).
+> **v1.30.3** — `.gitignore`: só `.task-flow` no final, sem comentários. `npm install -g rbin-task-flow@1.30.3` e `rbin-task-flow reset --keep-tasks`. [CHANGELOG](CHANGELOG.md) · [Publicação](RELEASE-1.30.3.md).
 
 ## O Que É Este Projeto?
 
@@ -74,11 +74,12 @@ rbin-task-flow init
 rbin-task-flow init          # Inicializa no projeto atual
 rbin-task-flow init --profile minimal  # Só 2 regras always-on + skills (menos tokens no Cursor)
 rbin-task-flow init --share-ai-config  # Versiona .cursor/skills/ e .cursor/rules/ no git (time)
-rbin-task-flow update        # Atualiza configurações (mantém profile em install-meta.json)
-rbin-task-flow update --profile standard  # Passa a copiar todas as regras .mdc
+rbin-task-flow init --graphify  # Init + grafo em .task-flow/guides/graphify-out/
 rbin-task-flow reset         # Reinstala o Task Flow do zero
-rbin-task-flow update --graphify # Update + grafo em .task-flow/guides/graphify-out/
+rbin-task-flow reset --keep-tasks  # Sobe versão sem sobrescrever suas tasks
+rbin-task-flow reset --profile standard  # Passa a copiar todas as regras .mdc
 rbin-task-flow reset --graphify  # Reset + graphify extract (CLI Graphify no PATH)
+rbin-task-flow reset --keep-tasks --graphify  # Upgrade + mantém tasks + graphify extract
 rbin-task-flow version-check # Verifica atualizações de modelos
 rbin-task-flow info          # Mostra informações
 rbin-task-flow estimate <ids> # Estima tempo (ex: "1" ou "1,2" ou "all")
@@ -91,7 +92,7 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
 
 **Otimizar por plataforma:** [.task-flow/guides/AI-PLATFORMS.md](.task-flow/guides/AI-PLATFORMS.md) · [Claude](.task-flow/guides/platforms/claude-code.md) · [Cursor](.task-flow/guides/platforms/cursor.md) · [Codex](.task-flow/guides/platforms/codex.md) · [Graphify](.task-flow/guides/GRAPHIFY.md)
 
-**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).
+**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 reset --keep-tasks --graphify` no projeto (migra `graphify-out/` da raiz + regera grafo). **Manter suas tasks ao subir versão:** `rbin-task-flow reset --keep-tasks`. Detalhes: [.task-flow/README.md](.task-flow/README.md#graphify-opcional) · [GRAPHIFY.md](.task-flow/guides/GRAPHIFY.md).
 
 **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.
 
@@ -101,7 +102,7 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
 
 **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/`.
 
-**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.
+**Compartilhar com o time:** `.cursor/`, `CLAUDE.md` e `AGENTS.md` já podem ir no git; só `.task-flow/` fica ignorado (tasks e progresso locais). Flag `--share-ai-config` grava preferência em `install-meta.json`.
 
 | Comando | Por Que Usar | Feature Principal |
 |---------|--------------|-------------------|
@@ -110,7 +111,7 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
 | `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 |
 | `task-flow: status` | **Visualiza** o progresso rapidamente | Vê resumo com tasks completas, em andamento e quantas subtarefas faltam |
 | `task-flow: split` | `:3` · `:2` · `:3 50-72` | **Divide** trabalho entre N IAs — gera N comandos `run X,Y,Z` (só plano) |
-| `task-flow: run next X` | **Automatiza** o trabalho nas próximas subtarefas | A IA trabalha nas próximas X subtarefas sequencialmente, você só acompanha |
+| `task-flow: run next X` | **Automatiza** o trabalho nas próximas subtarefas | IA implementa o que pode; passos manuais → `dev-logs/`; você reporta no chat |
 | `task-flow: run X` | **Completa** uma tarefa inteira de uma vez | Executa todas as subtarefas de uma tarefa específica (permite trabalho paralelo) |
 | `task-flow: run X,Y` | **Completa** múltiplas tarefas | Executa tarefas separadas por vírgula (ex: `task-flow: run 10,11`) |
 | `task-flow: run all` | **Completa** todas as tarefas | Executa todas as tarefas pendentes |
@@ -145,7 +146,7 @@ Repositório centralizado de configurações e regras de desenvolvimento que pod
 - **Instalação Global NPM** - Instale uma vez, use em qualquer lugar com `npm install -g rbin-task-flow`
 - **Gerenciamento Simples de Tarefas** - Defina tarefas em texto simples, a IA gera subtarefas detalhadas
 - **Múltiplos Modelos de IA** - Claude Code Sonnet configurado e pronto para uso
-- **.gitignore Discreto** - Configurações de IA ocultas com comentários genéricos
+- **.gitignore mínimo** - Só `.task-flow/` ignorado; `.cursor/` e instruções versionáveis no git
 - **Zero Configuração** - Pronto para usar imediatamente
 - **RBIN Task Flow** - Gerenciamento de tarefas alimentado por IA com interface de texto simples
 
@@ -247,23 +248,14 @@ Gerenciamento de tarefas simples e poderoso:
 - **Rastreamento Simples**: Gerenciamento de status baseado em JSON com comandos CLI fáceis
 - **Monitoramento de Progresso**: Feedback visual claro sobre a conclusão das tarefas
 
-## .gitignore Discreto
+## .gitignore
 
-O instalador adiciona estas entradas ao `.gitignore`:
+O instalador adiciona `.task-flow` ao final do `.gitignore`:
 
 ```gitignore
-.claude/
-.cursor/
-.task-flow/
-CLAUDE.md
+.task-flow
 ```
 
-**Por que discreto?**
-- Sem comentários explicando o que são
-- Sem menção a "IA", "Claude" ou "Anthropic"
-- Tudo relacionado ao RBIN Task Flow permanece local
-- Histórico git limpo sem arquivos de ferramentas de IA
-
 ## Atualizando Projetos
 
 Para atualizar configurações em um projeto existente:
@@ -271,11 +263,17 @@ Para atualizar configurações em um projeto existente:
 ```bash
 # Usando NPM (recomendado)
 cd /caminho/para/seu/projeto
-rbin-task-flow update
 
-# Para reiniciar o Task Flow do zero, incluindo .task-flow/.internal
+# Primeira instalação
+rbin-task-flow init
+
+# Subir versão do pacote mantendo suas tasks
+npm install -g rbin-task-flow@latest
+rbin-task-flow reset --keep-tasks
+rbin-task-flow reset --keep-tasks --graphify
+
+# Reiniciar o Task Flow do zero (perde tasks)
 rbin-task-flow reset
-# Com grafo de código (requer graphify no PATH):
 rbin-task-flow reset --graphify
 
 # Ou usando método legacy
@@ -336,9 +334,7 @@ Lista cada `.cursor/rules/*.mdc` (bytes, linhas, `alwaysApply`), soma always-on
 - ⚠️ Este é um **repositório template** - não use RBIN Task Flow aqui
 - ✅ Use RBIN Task Flow em **projetos que recebem** as configurações via instalação
 - 🔄 O instalador **sempre sobrescreve** configurações existentes
-- 🤫 As entradas do .gitignore são **discretas** (sem menções a IA)
-- 🎯 Funciona com **Claude Code CLI** ou **Cursor Pro**
-- 📦 O diretório Task Flow (`.task-flow/`) é **automaticamente gitignored**
+- 📦 Apenas `.task-flow/` é **gitignored** (tasks e progresso locais)
 - 📝 Defina tarefas em `.task-flow/tasks.input.txt` usando formato simples: `- Descrição da tarefa`
 - 🚀 **Instalação Global NPM**: `npm install -g rbin-task-flow`, depois use `rbin-task-flow init` em qualquer projeto
 - 🔒 **Chaves de API podem ser necessárias** - depende do seu provedor de IA (Claude Code ou Cursor Pro)
@@ -416,7 +412,7 @@ Para problemas ou perguntas:
 <a id="english"></a>
 # 🇬🇧 English
 
-> **v1.25.1** — Vercel `.env` pattern in coding standards. From **1.25.0**: `npm install -g rbin-task-flow@1.25.1` then `rbin-task-flow update`. [CHANGELOG](CHANGELOG.md) · [Release guide](RELEASE-1.25.1.md).
+> **v1.30.3** — `.gitignore`: append `.task-flow` only, no comments. `npm install -g rbin-task-flow@1.30.3` then `rbin-task-flow reset --keep-tasks`. [CHANGELOG](CHANGELOG.md) · [Release guide](RELEASE-1.30.3.md).
 
 ## What Is This Project?
 
@@ -457,11 +453,12 @@ rbin-task-flow init
 rbin-task-flow init          # Initialize in current project
 rbin-task-flow init --profile minimal  # 2 always-on rules + skills only (lower Cursor token cost)
 rbin-task-flow init --share-ai-config  # Commit .cursor/skills and rules with the team
-rbin-task-flow update        # Update configs (keeps profile from .task-flow/install-meta.json)
-rbin-task-flow update --profile standard  # Install all .cursor/rules/*.mdc
+rbin-task-flow init --graphify  # Init + graph at .task-flow/guides/graphify-out/
 rbin-task-flow reset         # Reinstall Task Flow from scratch
-rbin-task-flow update --graphify # Update + graph at .task-flow/guides/graphify-out/
+rbin-task-flow reset --keep-tasks  # Upgrade package without overwriting your tasks
+rbin-task-flow reset --profile standard  # Install all .cursor/rules/*.mdc
 rbin-task-flow reset --graphify  # Reset + graphify extract (Graphify CLI on PATH)
+rbin-task-flow reset --keep-tasks --graphify  # Upgrade + keep tasks + graphify extract
 rbin-task-flow version-check # Check for model updates
 rbin-task-flow info          # Show information
 rbin-task-flow estimate <ids> # Estimate time (e.g., "1" or "1,2" or "all")
@@ -474,7 +471,7 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
 
 **Per-platform optimization:** [index](.task-flow/guides/AI-PLATFORMS.md) · [Claude](.task-flow/guides/platforms/claude-code.md) · [Cursor](.task-flow/guides/platforms/cursor.md) · [Codex](.task-flow/guides/platforms/codex.md) · [Graphify](.task-flow/guides/GRAPHIFY.md)
 
-**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).
+**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 reset --keep-tasks --graphify` (migrates legacy root `graphify-out/` + re-extracts). **Keep your tasks when upgrading:** `rbin-task-flow reset --keep-tasks`. See [.task-flow/README.md](.task-flow/README.md#graphify-opcional) · [GRAPHIFY.md](.task-flow/guides/GRAPHIFY.md).
 
 **Claude / Cursor skills (v1.20+):** installs 11 skills — use `/task-flow-split`, `/task-flow-sync`, `/task-flow-run`, etc.
 
@@ -484,7 +481,7 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
 
 **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/`.
 
-**Share with team:** `init --share-ai-config` leaves `.cursor/skills/` and `.cursor/rules/` out of `.gitignore` (see comment block in `.gitignore` for token vs team trade-off). Default ignores all of `.cursor/`.
+**Share with team:** `.cursor/`, `CLAUDE.md`, and `AGENTS.md` can be committed; only `.task-flow/` is gitignored (local tasks and progress). `--share-ai-config` saves preference in `install-meta.json`.
 
 | Command | Why Use It | Key Feature |
 |---------|------------|-------------|
@@ -493,7 +490,7 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
 | `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 |
 | `task-flow: status` | **Visualize** progress quickly | See summary with completed tasks, in progress, and remaining subtasks |
 | `task-flow: split` | `:3` · `:2` · `:3 50-72` | **Split** work across N AIs — N `run` commands (plan only) |
-| `task-flow: run next X` | **Automate** work on next subtasks | AI works on next X subtasks sequentially, you just follow along |
+| `task-flow: run next X` | **Automate** work on next subtasks | AI implements what it can; manual steps → `dev-logs/`; you report in chat |
 | `task-flow: run X` | **Complete** an entire task at once | Executes all subtasks of a specific task (allows parallel work) |
 | `task-flow: run X,Y` | **Complete** multiple tasks | Executes comma-separated tasks (e.g., `task-flow: run 10,11`) |
 | `task-flow: run all` | **Complete** all tasks | Executes all pending tasks |
@@ -528,7 +525,7 @@ A centralized repository of development configurations and rules that can be ins
 - **NPM Global Installation** - Install once, use everywhere with `npm install -g rbin-task-flow`
 - **Simple Task Management** - Define tasks in plain text, AI generates detailed subtasks
 - **Multiple AI Models** - Claude Code Sonnet configured and ready to use
-- **Discrete .gitignore** - AI configs hidden with generic comments
+- **Minimal .gitignore** - Only `.task-flow/` ignored; `.cursor/` and instruction files committable
 - **Zero Configuration** - Ready to use immediately
 - **RBIN Task Flow** - AI-powered task management with simple text interface
 
@@ -630,23 +627,14 @@ Simple yet powerful task management:
 - **Simple Tracking**: JSON-based status management with easy CLI commands
 - **Progress Monitoring**: Clear visual feedback on task completion
 
-## Discrete .gitignore
+## .gitignore
 
-The installer adds these entries to `.gitignore`:
+The installer appends `.task-flow` at the end of `.gitignore`:
 
 ```gitignore
-.claude/
-.cursor/
-.task-flow/
-CLAUDE.md
+.task-flow
 ```
 
-**Why discrete?**
-- No comments explaining what they are
-- No mention of "AI", "Claude", or "Anthropic"
-- Everything related to RBIN Task Flow stays local
-- Clean git history without AI tooling files
-
 ## Updating Projects
 
 To update configs in an existing project:
@@ -654,11 +642,17 @@ To update configs in an existing project:
 ```bash
 # Using NPM (recommended)
 cd /path/to/your/project
-rbin-task-flow update
 
-# To reset Task Flow from scratch, including .task-flow/.internal
+# First install
+rbin-task-flow init
+
+# Upgrade package while keeping your tasks
+npm install -g rbin-task-flow@latest
+rbin-task-flow reset --keep-tasks
+rbin-task-flow reset --keep-tasks --graphify
+
+# Reset Task Flow from scratch (loses tasks)
 rbin-task-flow reset
-# With code knowledge graph (requires graphify on PATH):
 rbin-task-flow reset --graphify
 
 # Or using legacy method
@@ -719,9 +713,7 @@ Prints each `.cursor/rules/*.mdc` (bytes, lines, `alwaysApply`), totals always-o
 - ⚠️ This is a **template repository** - don't use RBIN Task Flow here
 - ✅ Use RBIN Task Flow in **projects that receive** the configs via installation
 - 🔄 Installer **always overwrites** existing configs
-- 🤫 .gitignore entries are **discrete** (no AI mentions)
-- 🎯 Works with **Claude Code CLI** or **Cursor Pro**
-- 📦 Task Flow directory (`.task-flow/`) is **automatically gitignored**
+- 📦 Only `.task-flow/` is **gitignored** (local tasks and progress)
 - 📝 Define tasks in `.task-flow/tasks.input.txt` using simple format: `- Task description`
 - 🚀 **NPM Global Install**: `npm install -g rbin-task-flow`, then use `rbin-task-flow init` in any project
 - 🔒 **API keys may be required** - depends on your AI provider (Claude Code or Cursor Pro)

package/bin/cli.js

@@ -22,11 +22,15 @@ function addInstallCommand(name, description, extra = {}) {
     .option('-g, --graphify', 'Run graphify extract → .task-flow/guides/graphify-out/ (claude-cli backend; requires graphify CLI)')
     .option(
       '--profile <profile>',
-      'Cursor rules: minimal (2 always-on + skills) or standard (all rules); update without flag keeps .task-flow/install-meta.json'
+      'Cursor rules: minimal (2 always-on + skills) or standard (all rules); reset without flag keeps .task-flow/install-meta.json'
     )
     .option(
       '--share-ai-config',
-      'Do not gitignore .cursor/skills/ or .cursor/rules/ (team can commit shared AI config; see .gitignore comment)'
+      'Save team AI config preference in install-meta.json (appends .task-flow to .gitignore)'
+    )
+    .option(
+      '--keep-tasks',
+      'Preserve tasks.input.txt, tasks.status.md, .internal/, and dev-logs/ on reset (upgrade package without losing task definitions)'
     )
     .action(async (options) => {
       const targetPath = options.path || process.cwd();
@@ -39,6 +43,7 @@ function addInstallCommand(name, description, extra = {}) {
           graphify: options.graphify,
           profile,
           shareAiConfig,
+          keepTasks: options.keepTasks === true,
         });
       } catch (error) {
         console.error(chalk.red('\n' + error.message + '\n'));
@@ -48,7 +53,6 @@ function addInstallCommand(name, description, extra = {}) {
 }
 
 addInstallCommand('init', 'Initialize RBIN Task Flow in current directory');
-addInstallCommand('update', 'Update RBIN Task Flow in current directory', { update: true });
 addInstallCommand('reset', 'Reset RBIN Task Flow in current directory', { reset: true });
 
 program
@@ -93,9 +97,10 @@ program
     console.log(chalk.cyan('  rbin-task-flow init --profile minimal') + ' - Low-token install (2 always-on rules + skills)');
     console.log(chalk.cyan('  rbin-task-flow init --share-ai-config') + ' - Version .cursor/skills and rules in git');
     console.log(chalk.cyan('  rbin-task-flow init --graphify') + ' - Init + graphify extract --backend claude-cli (if CLI installed)');
-    console.log(chalk.cyan('  rbin-task-flow update') + '       - Update configurations');
     console.log(chalk.cyan('  rbin-task-flow reset') + '        - Reset task flow files from scratch');
+    console.log(chalk.cyan('  rbin-task-flow reset --keep-tasks') + ' - Upgrade package without overwriting tasks');
     console.log(chalk.cyan('  rbin-task-flow reset --graphify') + ' - Reset + graphify extract --backend claude-cli (if CLI installed)');
+    console.log(chalk.cyan('  rbin-task-flow reset --keep-tasks --graphify') + ' - Upgrade + keep tasks + graphify extract');
     console.log(chalk.cyan('  rbin-task-flow version-check') + ' - Check for model updates');
     console.log(chalk.cyan('  rbin-task-flow estimate <ids>') + ' - Estimate time (e.g., "1" or "1,2" or "all")');
     console.log(chalk.cyan('  rbin-task-flow report <ids>') + '  - Generate report (e.g., "1" or "1,2" or "all")');

package/lib/cursor.js

@@ -30,7 +30,7 @@ async function setupCursorIntegration(targetPath, options = {}) {
 
   if (profile === 'minimal') {
     showInfo('Minimal profile: 2 always-on rules; workflows via @task-flow-* skills only');
-    showInfo('Full rules: rbin-task-flow update --profile standard');
+    showInfo('Full rules: rbin-task-flow reset --profile standard --keep-tasks');
   } else {
     showInfo('Rules: 2 always-on + intelligent/glob rules; prefer @task-flow-* skills for workflows');
   }

package/lib/gitignore.js

@@ -1,99 +1,68 @@
 const fs = require('fs-extra');
 const path = require('path');
 
-const MARKER_START = '# RBIN Task Flow (rbin-task-flow)';
-const MARKER_END = '# END RBIN Task Flow (rbin-task-flow)';
-
-const ENTRIES_DEFAULT = [
-  '.claude/',
-  '.cursor/',
-  '.task-flow/',
-  'CLAUDE.md',
-  'AGENTS.md',
-];
-
-const ENTRIES_SHARE_AI_CONFIG = [
-  '.claude/',
-  '.cursor/settings.json',
-  '.cursor/rules/*.local.mdc',
-  '.task-flow/',
-  'CLAUDE.md',
-  'AGENTS.md',
+const GITIGNORE_ENTRY = '.task-flow';
+
+const LEGACY_MARKER_START = '# RBIN Task Flow (rbin-task-flow)';
+const LEGACY_MARKER_END = '# END RBIN Task Flow (rbin-task-flow)';
+
+const STRIP_LINE_PATTERNS = [
+  /^\.task-flow\/?\s*$/m,
+  /^\.claude\/\s*$/m,
+  /^\.cursor\/\s*$/m,
+  /^CLAUDE\.md\s*$/m,
+  /^AGENTS\.md\s*$/m,
+  /^\.cursor\/settings\.json\s*$/m,
+  /^\.cursor\/rules\/\*\.local\.mdc\s*$/m,
+  /^graphify-out\/\s*$/m,
+  /^\.task-flow\/scripts\/tasks\.json\s*$/m,
+  /^\.task-flow\/scripts\/status\.json\s*$/m,
+  /^# RBIN Task Flow.*$/m,
+  /^# END RBIN Task Flow.*$/m,
+  /^# share-ai-config:.*$/m,
+  /^# Trade-off:.*$/m,
+  /^# Default \(no flag\):.*$/m,
+  /^# Only \.task-flow\/.*$/m,
+  /^# \.cursor\/.*$/m,
 ];
 
-const STRIP_PATTERNS = [
-  ...ENTRIES_DEFAULT,
-  ...ENTRIES_SHARE_AI_CONFIG,
-  MARKER_START,
-  MARKER_END,
-  '# share-ai-config:',
-  '# Trade-off:',
-  '# Default (no flag):',
-];
-
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function stripRbinGitignoreBlock(content) {
+function stripTaskFlowGitignoreLines(content) {
   let next = content;
 
   const blockRegex = new RegExp(
-    `\\n?${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}\\n?`,
+    `\\n?${LEGACY_MARKER_START.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${LEGACY_MARKER_END.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n?`,
     'g'
   );
   next = next.replace(blockRegex, '\n');
 
-  for (const entry of STRIP_PATTERNS) {
-    const lineRegex = new RegExp(`^${escapeRegExp(entry)}\\s*$`, 'gm');
-    next = next.replace(lineRegex, '');
+  for (const pattern of STRIP_LINE_PATTERNS) {
+    next = next.replace(pattern, '');
   }
 
-  return next.replace(/\n{3,}/g, '\n\n');
+  return next.replace(/\n{3,}/g, '\n\n').replace(/\s+$/, '');
 }
 
-function buildRbinGitignoreBlock(shareAiConfig) {
-  const lines = ['', MARKER_START, ''];
-
-  if (shareAiConfig) {
-    lines.push(
-      '# share-ai-config: .cursor/skills/ and .cursor/rules/ are NOT ignored — commit them for team consistency.',
-      '# Trade-off: shared AI config improves workflow parity; each developer still pays token cost when the Agent loads rules/skills.',
-      '# Default (no flag): entire .cursor/ stays local and gitignored — lower repo noise, no team sync of rules.',
-      ''
-    );
-    lines.push(...ENTRIES_SHARE_AI_CONFIG);
-  } else {
-    lines.push(...ENTRIES_DEFAULT);
-  }
-
-  lines.push(MARKER_END, '');
-  return lines.join('\n');
+function appendTaskFlowEntry(content) {
+  const normalized = stripTaskFlowGitignoreLines(content);
+  const suffix = normalized.length > 0 ? '\n' : '';
+  return `${normalized}${suffix}${GITIGNORE_ENTRY}\n`;
 }
 
-async function updateGitignore(targetPath, { shareAiConfig = false } = {}) {
+async function updateGitignore(targetPath) {
   const gitignorePath = path.join(targetPath, '.gitignore');
 
   if (!fs.existsSync(gitignorePath)) {
-    await fs.writeFile(gitignorePath, '');
+    await fs.writeFile(gitignorePath, `${GITIGNORE_ENTRY}\n`);
+    return;
   }
 
-  let content = await fs.readFile(gitignorePath, 'utf8');
-  content = stripRbinGitignoreBlock(content);
-
-  if (!content.endsWith('\n')) {
-    content += '\n';
-  }
-
-  content += buildRbinGitignoreBlock(shareAiConfig);
-  await fs.writeFile(gitignorePath, content);
-
-  return { shareAiConfig };
+  const content = await fs.readFile(gitignorePath, 'utf8');
+  await fs.writeFile(gitignorePath, appendTaskFlowEntry(content));
 }
 
 module.exports = {
-  MARKER_START,
-  buildRbinGitignoreBlock,
-  stripRbinGitignoreBlock,
+  GITIGNORE_ENTRY,
+  stripTaskFlowGitignoreLines,
+  appendTaskFlowEntry,
   updateGitignore,
 };