How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

add-feature-3.5-tasks - Prompt

Name: add-feature-3.5-tasks
Author: Tiag8

Prompt file imported from Tiag8/bible-study (.windsurf/workflows/add-feature-3.5-tasks.md). Fill in {{BRANCH}}, {{N}} before use. Copyright stays with the author.

Workflow 3.5: Tasks Breakdown

Versão: 1.0.0 Criado: 2025-12-28 Objetivo: Gerar breakdown atômico de tasks ANTES de validação (WF 4.5) Fonte: GitHub Spec Kit (2025) - TASKS phase

📋 PRÉ-REQUISITOS

Workflow 3 (Risk Analysis) executado
{branch}_spec.md preenchido (WF 1)
{branch}_plan.md preenchido (WF 2b)
Riscos identificados e mitigados (WF 3)

🎯 OBJETIVO

Transformar o PLAN em TASKS atômicas executáveis com:

Ordem de dependência clara
Tasks paralelas marcadas com [P]
Cada task < 2h de trabalho
Sincronização com TodoWrite do Claude Code

FASE 1: CARREGAR CONTEXTO

1.1 Ler Artefatos Existentes

# Ler spec e plan
cat .context/{{BRANCH}}_spec.md
cat .context/{{BRANCH}}_plan.md
cat .context/{{BRANCH}}_decisions.md

1.2 Identificar User Stories

Extrair do {branch}_spec.md:

US-1, US-2, US-3... (cada user story)
FR-1, FR-2... (functional requirements)
Critérios de aceite

FASE 2: GERAR TASKS

2.1 Para CADA User Story

Regras:

Cada task deve ser atômica (< 2h trabalho)
Dependências explícitas: (dep: T-1.1, T-1.2)
Tasks paralelas marcadas: [P]
Path de arquivo quando aplicável

Template:

### US-1: [Título da User Story]

- [ ] T-1.1: [Descrição atômica] `(dep: nenhuma)` → `path/to/file.ts`
- [ ] T-1.2: [Descrição atômica] `(dep: T-1.1)` → `path/to/file.ts`
- [ ] T-1.3: [Descrição atômica] `(dep: T-1.1)` `[P]` → `path/to/other.ts`

2.2 Criar Dependency Graph

T-1.1 ─────▶ T-1.2 ─────▶ T-1.4
       └───▶ T-1.3 [P] ──┘

FASE 3: PREENCHER {branch}_tasks.md

3.1 Template Completo

# Tasks: [Feature Name]

**Branch**: `{branch}`
**Created**: YYYY-MM-DD HH:MM
**Spec**: [{branch}_spec.md](./{branch}_spec.md)
**Plan**: [{branch}_plan.md](./{branch}_plan.md)

---

## Task Breakdown

### US-1: [User Story do spec.md]

| Task | Descrição | Deps | Paralela | Arquivo | Status |
|------|-----------|------|----------|---------|--------|
| T-1.1 | [Descrição] | - | - | `src/...` | [ ] |
| T-1.2 | [Descrição] | T-1.1 | - | `src/...` | [ ] |
| T-1.3 | [Descrição] | T-1.1 | [P] | `src/...` | [ ] |

### US-2: [User Story do spec.md]

| Task | Descrição | Deps | Paralela | Arquivo | Status |
|------|-----------|------|----------|---------|--------|
| T-2.1 | [Descrição] | T-1.2, T-1.3 | - | `src/...` | [ ] |

---

## Dependency Graph

\`\`\`
T-1.1 ─────▶ T-1.2 ─────▶ T-2.1
       └───▶ T-1.3 [P] ──┘
\`\`\`

---

## Critérios de Done por Task

### T-1.1: [Nome]
- [ ] Código implementado
- [ ] Testes passando
- [ ] Sem erros TypeScript

---

## Progress Tracking

| Task | Status | Notas | Updated |
|------|--------|-------|---------|
| T-1.1 | [ ] Pending | | |
| T-1.2 | [ ] Pending | | |

**Legenda**: [ ] Pending | [~] In Progress | [x] Done | [!] Blocked

FASE 4: SINCRONIZAR COM TODOWRITE ⭐

4.1 Converter Tasks para TodoWrite

OBRIGATÓRIO: Após preencher {branch}_tasks.md, sincronizar com TodoWrite do Claude Code.

// Exemplo de sincronização
TodoWrite([
  { content: "T-1.1: Criar componente X", status: "pending", activeForm: "Criando componente X" },
  { content: "T-1.2: Implementar hook Y", status: "pending", activeForm: "Implementando hook Y" },
  { content: "T-1.3: Adicionar testes Z [P]", status: "pending", activeForm: "Adicionando testes Z" },
])

4.2 Regras de Sincronização

{branch}_tasks.md	TodoWrite
`[ ] T-1.1: ...`	`status: "pending"`
`[~] T-1.1: ...`	`status: "in_progress"`
`[x] T-1.1: ...`	`status: "completed"`
`[!] T-1.1: ...`	`status: "pending"` + nota "BLOCKED"

4.3 Manter Sincronizado

Durante WF 5a (Implementation):

Ao iniciar task → marcar in_progress em AMBOS
Ao concluir task → marcar completed em AMBOS
Se bloqueado → marcar [!] no tasks.md + nota no TodoWrite

FASE 5: VALIDAR TASKS

5.1 Checklist Pré-WF4.5

Todas US do spec.md têm tasks?
Todas tasks têm dependências explícitas?
Tasks paralelas marcadas com [P]?
Cada task < 2h trabalho?
Arquivos target identificados?
TodoWrite sincronizado?

5.2 Logar Conclusão

echo "[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] WORKFLOW: 3.5 (Tasks) - COMPLETO" >> .context/{{BRANCH}}_attempts.log
echo "[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] ARTIFACT: {{BRANCH}}_tasks.md preenchido" >> .context/{{BRANCH}}_attempts.log
echo "[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] ARTIFACT: TodoWrite sincronizado com {{N}} tasks" >> .context/{{BRANCH}}_attempts.log

📊 OUTPUT

Artefato	Status
`{branch}_tasks.md`	Preenchido
TodoWrite	Sincronizado
`{branch}_attempts.log`	Atualizado

➡️ PRÓXIMO

Workflow 4.5: Pre-Implementation Gates (VALIDATE spec↔plan↔tasks)

📋 CHECKLIST FINAL

SE TUDO OK: Prosseguir para Workflow 4.5 SE FALHOU: Revisar plan.md ou spec.md

Versão: 1.0.0 | Chars: ~4,500

# Workflow 3.5: Tasks Breakdown **Versão**: 1.0.0 **Criado**: 2025-12-28 **Objetivo**: Gerar breakdown atômico de tasks ANTES de validação (WF 4.5) **Fonte**: GitHub Spec Kit (2025) - TASKS phase --- ## 📋 PRÉ-REQUISITOS - [ ] Workflow 3 (Risk Analysis) executado - [ ] `{branch}_spec.md` preenchido (WF 1) - [ ] `{branch}_plan.md` preenchido (WF 2b) - [ ] Riscos identificados e mitigados (WF 3) --- ## 🎯 OBJETIVO Transformar o PLAN em TASKS atômicas executáveis com: - Ordem de dependência clara - Tasks paralelas marcadas com `[P]` - Cada task < 2h de trabalho - Sincronização com TodoWrite do Claude Code --- ## FASE 1: CARREGAR CONTEXTO ### 1.1 Ler Artefatos Existentes ```bash # Ler spec e plan cat .context/{{BRANCH}}_spec.md cat .context/{{BRANCH}}_plan.md cat .context/{{BRANCH}}_decisions.md ``` ### 1.2 Identificar User Stories Extrair do `{branch}_spec.md`: - US-1, US-2, US-3... (cada user story) - FR-1, FR-2... (functional requirements) - Critérios de aceite --- ## FASE 2: GERAR TASKS ### 2.1 Para CADA User Story **Regras**: 1. Cada task deve ser atômica (< 2h trabalho) 2. Dependências explícitas: `(dep: T-1.1, T-1.2)` 3. Tasks paralelas marcadas: `[P]` 4. Path de arquivo quando aplicável **Template**: ```markdown ### US-1: [Título da User Story] - [ ] T-1.1: [Descrição atômica] `(dep: nenhuma)` → `path/to/file.ts` - [ ] T-1.2: [Descrição atômica] `(dep: T-1.1)` → `path/to/file.ts` - [ ] T-1.3: [Descrição atômica] `(dep: T-1.1)` `[P]` → `path/to/other.ts` ``` ### 2.2 Criar Dependency Graph ``` T-1.1 ─────▶ T-1.2 ─────▶ T-1.4 └───▶ T-1.3 [P] ──┘ ``` --- ## FASE 3: PREENCHER {branch}_tasks.md ### 3.1 Template Completo ```markdown # Tasks: [Feature Name] **Branch**: `{branch}` **Created**: YYYY-MM-DD HH:MM **Spec**: [{branch}_spec.md](./{branch}_spec.md) **Plan**: [{branch}_plan.md](./{branch}_plan.md) --- ## Task Breakdown ### US-1: [User Story do spec.md] | Task | Descrição | Deps | Paralela | Arquivo | Status | |------|-----------|------|----------|---------|--------| | T-1.1 | [Descrição] | - | - | `src/...` | [ ] | | T-1.2 | [Descrição] | T-1.1 | - | `src/...` | [ ] | | T-1.3 | [Descrição] | T-1.1 | [P] | `src/...` | [ ] | ### US-2: [User Story do spec.md] | Task | Descrição | Deps | Paralela | Arquivo | Status | |------|-----------|------|----------|---------|--------| | T-2.1 | [Descrição] | T-1.2, T-1.3 | - | `src/...` | [ ] | --- ## Dependency Graph \`\`\` T-1.1 ─────▶ T-1.2 ─────▶ T-2.1 └───▶ T-1.3 [P] ──┘ \`\`\` --- ## Critérios de Done por Task ### T-1.1: [Nome] - [ ] Código implementado - [ ] Testes passando - [ ] Sem erros TypeScript --- ## Progress Tracking | Task | Status | Notas | Updated | |------|--------|-------|---------| | T-1.1 | [ ] Pending | | | | T-1.2 | [ ] Pending | | | **Legenda**: [ ] Pending | [~] In Progress | [x] Done | [!] Blocked ``` --- ## FASE 4: SINCRONIZAR COM TODOWRITE ⭐ ### 4.1 Converter Tasks para TodoWrite **OBRIGATÓRIO**: Após preencher `{branch}_tasks.md`, sincronizar com TodoWrite do Claude Code. ```typescript // Exemplo de sincronização TodoWrite([ { content: "T-1.1: Criar componente X", status: "pending", activeForm: "Criando componente X" }, { content: "T-1.2: Implementar hook Y", status: "pending", activeForm: "Implementando hook Y" }, { content: "T-1.3: Adicionar testes Z [P]", status: "pending", activeForm: "Adicionando testes Z" }, ]) ``` ### 4.2 Regras de Sincronização | {branch}_tasks.md | TodoWrite | |-------------------|-----------| | `[ ] T-1.1: ...` | `status: "pending"` | | `[~] T-1.1: ...` | `status: "in_progress"` | | `[x] T-1.1: ...` | `status: "completed"` | | `[!] T-1.1: ...` | `status: "pending"` + nota "BLOCKED" | ### 4.3 Manter Sincronizado Durante WF 5a (Implementation): 1. Ao iniciar task → marcar `in_progress` em AMBOS 2. Ao concluir task → marcar `completed` em AMBOS 3. Se bloqueado → marcar `[!]` no tasks.md + nota no TodoWrite --- ## FASE 5: VALIDAR TASKS ### 5.1 Checklist Pré-WF4.5 - [ ] Todas US do spec.md têm tasks? - [ ] Todas tasks têm dependências explícitas? - [ ] Tasks paralelas marcadas com `[P]`? - [ ] Cada task < 2h trabalho? - [ ] Arquivos target identificados? - [ ] TodoWrite sincronizado? ### 5.2 Logar Conclusão ```bash echo "[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] WORKFLOW: 3.5 (Tasks) - COMPLETO" >> .context/{{BRANCH}}_attempts.log echo "[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] ARTIFACT: {{BRANCH}}_tasks.md preenchido" >> .context/{{BRANCH}}_attempts.log echo "[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] ARTIFACT: TodoWrite sincronizado com {{N}} tasks" >> .context/{{BRANCH}}_attempts.log ``` --- ## 📊 OUTPUT | Artefato | Status | |----------|--------| | `{branch}_tasks.md` | Preenchido | | TodoWrite | Sincronizado | | `{branch}_attempts.log` | Atualizado | --- ## ➡️ PRÓXIMO **Workflow 4.5**: Pre-Implementation Gates (VALIDATE spec↔plan↔tasks) --- ## 📋 CHECKLIST FINAL - [ ] `{branch}_tasks.md` criado? - [ ] Todas US têm tasks? - [ ] Dependency graph claro? - [ ] TodoWrite sincronizado? - [ ] Logged em attempts.log? **SE TUDO OK**: Prosseguir para Workflow 4.5 **SE FALHOU**: Revisar plan.md ou spec.md --- **Versão**: 1.0.0 | **Chars**: ~4,500

{ "prompt": "# Workflow 3.5: Tasks Breakdown\n\n**Versão**: 1.0.0\n**Criado**: 2025-12-28\n**Objetivo**: Gerar breakdown atômico de tasks ANTES de validação (WF 4.5)\n**Fonte**: GitHub Spec Kit (2025) - TASKS phase\n\n---\n\n## 📋 PRÉ-REQUISITOS\n\n- [ ] Workflow 3 (Risk Analysis) executado\n- [ ] `{branch}_spec.md` preenchido (WF 1)\n- [ ] `{branch}_plan.md` preenchido (WF 2b)\n- [ ] Riscos identificados e mitigados (WF 3)\n\n---\n\n## 🎯 OBJETIVO\n\nTransformar o PLAN em TASKS atômicas executáveis com:\n- Ordem de dependência clara\n- Tasks paralelas marcadas com `[P]`\n- Cada task < 2h de trabalho\n- Sincronização com TodoWrite do Claude Code\n\n---\n\n## FASE 1: CARREGAR CONTEXTO\n\n### 1.1 Ler Artefatos Existentes\n\n```bash\n# Ler spec e plan\ncat .context/{{BRANCH}}_spec.md\ncat .context/{{BRANCH}}_plan.md\ncat .context/{{BRANCH}}_decisions.md\n```\n\n### 1.2 Identificar User Stories\n\nExtrair do `{branch}_spec.md`:\n- US-1, US-2, US-3... (cada user story)\n- FR-1, FR-2... (functional requirements)\n- Critérios de aceite\n\n---\n\n## FASE 2: GERAR TASKS\n\n### 2.1 Para CADA User Story\n\n**Regras**:\n1. Cada task deve ser atômica (< 2h trabalho)\n2. Dependências explícitas: `(dep: T-1.1, T-1.2)`\n3. Tasks paralelas marcadas: `[P]`\n4. Path de arquivo quando aplicável\n\n**Template**:\n```markdown\n### US-1: [Título da User Story]\n\n- [ ] T-1.1: [Descrição atômica] `(dep: nenhuma)` → `path/to/file.ts`\n- [ ] T-1.2: [Descrição atômica] `(dep: T-1.1)` → `path/to/file.ts`\n- [ ] T-1.3: [Descrição atômica] `(dep: T-1.1)` `[P]` → `path/to/other.ts`\n```\n\n### 2.2 Criar Dependency Graph\n\n```\nT-1.1 ─────▶ T-1.2 ─────▶ T-1.4\n └───▶ T-1.3 [P] ──┘\n```\n\n---\n\n## FASE 3: PREENCHER {branch}_tasks.md\n\n### 3.1 Template Completo\n\n```markdown\n# Tasks: [Feature Name]\n\n**Branch**: `{branch}`\n**Created**: YYYY-MM-DD HH:MM\n**Spec**: [{branch}_spec.md](./{branch}_spec.md)\n**Plan**: [{branch}_plan.md](./{branch}_plan.md)\n\n---\n\n## Task Breakdown\n\n### US-1: [User Story do spec.md]\n\n| Task | Descrição | Deps | Paralela | Arquivo | Status |\n|------|-----------|------|----------|---------|--------|\n| T-1.1 | [Descrição] | - | - | `src/...` | [ ] |\n| T-1.2 | [Descrição] | T-1.1 | - | `src/...` | [ ] |\n| T-1.3 | [Descrição] | T-1.1 | [P] | `src/...` | [ ] |\n\n### US-2: [User Story do spec.md]\n\n| Task | Descrição | Deps | Paralela | Arquivo | Status |\n|------|-----------|------|----------|---------|--------|\n| T-2.1 | [Descrição] | T-1.2, T-1.3 | - | `src/...` | [ ] |\n\n---\n\n## Dependency Graph\n\n\\`\\`\\`\nT-1.1 ─────▶ T-1.2 ─────▶ T-2.1\n └───▶ T-1.3 [P] ──┘\n\\`\\`\\`\n\n---\n\n## Critérios de Done por Task\n\n### T-1.1: [Nome]\n- [ ] Código implementado\n- [ ] Testes passando\n- [ ] Sem erros TypeScript\n\n---\n\n## Progress Tracking\n\n| Task | Status | Notas | Updated |\n|------|--------|-------|---------|\n| T-1.1 | [ ] Pending | | |\n| T-1.2 | [ ] Pending | | |\n\n**Legenda**: [ ] Pending | [~] In Progress | [x] Done | [!] Blocked\n```\n\n---\n\n## FASE 4: SINCRONIZAR COM TODOWRITE ⭐\n\n### 4.1 Converter Tasks para TodoWrite\n\n**OBRIGATÓRIO**: Após preencher `{branch}_tasks.md`, sincronizar com TodoWrite do Claude Code.\n\n```typescript\n// Exemplo de sincronização\nTodoWrite([\n { content: \"T-1.1: Criar componente X\", status: \"pending\", activeForm: \"Criando componente X\" },\n { content: \"T-1.2: Implementar hook Y\", status: \"pending\", activeForm: \"Implementando hook Y\" },\n { content: \"T-1.3: Adicionar testes Z [P]\", status: \"pending\", activeForm: \"Adicionando testes Z\" },\n])\n```\n\n### 4.2 Regras de Sincronização\n\n| {branch}_tasks.md | TodoWrite |\n|-------------------|-----------|\n| `[ ] T-1.1: ...` | `status: \"pending\"` |\n| `[~] T-1.1: ...` | `status: \"in_progress\"` |\n| `[x] T-1.1: ...` | `status: \"completed\"` |\n| `[!] T-1.1: ...` | `status: \"pending\"` + nota \"BLOCKED\" |\n\n### 4.3 Manter Sincronizado\n\nDurante WF 5a (Implementation):\n1. Ao iniciar task → marcar `in_progress` em AMBOS\n2. Ao concluir task → marcar `completed` em AMBOS\n3. Se bloqueado → marcar `[!]` no tasks.md + nota no TodoWrite\n\n---\n\n## FASE 5: VALIDAR TASKS\n\n### 5.1 Checklist Pré-WF4.5\n\n- [ ] Todas US do spec.md têm tasks?\n- [ ] Todas tasks têm dependências explícitas?\n- [ ] Tasks paralelas marcadas com `[P]`?\n- [ ] Cada task < 2h trabalho?\n- [ ] Arquivos target identificados?\n- [ ] TodoWrite sincronizado?\n\n### 5.2 Logar Conclusão\n\n```bash\necho \"[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] WORKFLOW: 3.5 (Tasks) - COMPLETO\" >> .context/{{BRANCH}}_attempts.log\necho \"[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] ARTIFACT: {{BRANCH}}_tasks.md preenchido\" >> .context/{{BRANCH}}_attempts.log\necho \"[$(TZ='America/Sao_Paulo' date '+%Y-%m-%d %H:%M')] ARTIFACT: TodoWrite sincronizado com {{N}} tasks\" >> .context/{{BRANCH}}_attempts.log\n```\n\n---\n\n## 📊 OUTPUT\n\n| Artefato | Status |\n|----------|--------|\n| `{branch}_tasks.md` | Preenchido |\n| TodoWrite | Sincronizado |\n| `{branch}_attempts.log` | Atualizado |\n\n---\n\n## ➡️ PRÓXIMO\n\n**Workflow 4.5**: Pre-Implementation Gates (VALIDATE spec↔plan↔tasks)\n\n---\n\n## 📋 CHECKLIST FINAL\n\n- [ ] `{branch}_tasks.md` criado?\n- [ ] Todas US têm tasks?\n- [ ] Dependency graph claro?\n- [ ] TodoWrite sincronizado?\n- [ ] Logged em attempts.log?\n\n**SE TUDO OK**: Prosseguir para Workflow 4.5\n**SE FALHOU**: Revisar plan.md ou spec.md\n\n---\n\n**Versão**: 1.0.0 | **Chars**: ~4,500", "variables": [ "BRANCH", "N" ], "notes": "Transformar o PLAN em TASKS atômicas executáveis com: - Ordem de dependência clara - Tasks paralelas marcadas com `[P]` - Cada task < 2h de trabalho - Sincronização com TodoWrite do Claude Code", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/Tiag8/bible-study", "path": ".windsurf/workflows/add-feature-3.5-tasks.md", "ref": "3a57fc1f2ea0626ae38f967e762dcae21f467978", "url": "https://github.com/Tiag8/bible-study/blob/3a57fc1f2ea0626ae38f967e762dcae21f467978/.windsurf/workflows/add-feature-3.5-tasks.md", "key": "Tiag8/bible-study/.windsurf/workflows/add-feature-3.5-tasks.md" } } }

add-feature-3.5-tasks

About