Estratégias de Coordenação de Tarefas

Estratégias para decompor tarefas complexas em unidades paralelizáveis, projetar grafos de dependência, escrever descrições de tarefas eficazes e monitorar a carga de trabalho em equipes de agentes.

Quando Usar Esta Habilidade

• Dividir uma tarefa complexa para execução paralela
• Projetar relacionamentos de dependência de tarefas (bloqueadoPor/bloqueia)
• Escrever descrições de tarefas com critérios de aceitação claros
• Monitorar e reequilibrar a carga de trabalho entre colegas de equipe
• Identificar o caminho crítico em um fluxo de trabalho de várias tarefas

Estratégias de Decomposição de Tarefas

Por Camada

Divida o trabalho por camada arquitetural:

• Componentes de Frontend
• Endpoints de API de Backend
• Migrações/Modelos de Banco de Dados
• Conjuntos de testes

Melhor para: Funcionalidades full-stack, fatias verticais

Por Componente

Divida o trabalho por componente funcional:

• Módulo de Autenticação
• Módulo de Perfil de Usuário
• Módulo de Notificação

Melhor para: Microsserviços, arquiteturas modulares

Por Preocupação

Divida o trabalho por preocupação transversal:

• Revisão de Segurança
• Revisão de Performance
• Revisão de Arquitetura

Melhor para: Revisões de código, auditorias

Por Propriedade de Arquivo

Divida o trabalho por limites de arquivo/diretório:

• src/components/ — Implementador 1
• src/api/ — Implementador 2
• src/utils/ — Implementador 3

Melhor para: Implementação paralela, evitação de conflitos

Projeto de Grafo de Dependência

Princípios

1. Minimizar a profundidade da cadeia — Prefira grafos largos e rasos em vez de cadeias profundas
2. Identificar o caminho crítico — A cadeia mais longa determina o tempo mínimo de conclusão
3. Usar bloqueadoPor com moderação — Adicione apenas dependências que são verdadeiramente necessárias
4. Evitar dependências circulares — Tarefa A bloqueia B, que bloqueia A é um deadlock

Padrões

Independentes (Melhor paralelismo):

Task A ─┐
Task B ─┼─→ Integration
Task C ─┘

Sequenciais (Dependências necessárias):

Task A → Task B → Task C

Diamante (Misto):

        ┌→ Task B ─┐
Task A ─┤          ├→ Task D
        └→ Task C ─┘

Usando bloqueadoPor/bloqueia

TaskCreate: { subject: "Build API endpoints" }         → Task #1
TaskCreate: { subject: "Build frontend components" }    → Task #2
TaskCreate: { subject: "Integration testing" }          → Task #3
TaskUpdate: { taskId: "3", addBlockedBy: ["1", "2"] }  → #3 waits for #1 and #2

Melhores Práticas para Descrição de Tarefas

Cada tarefa deve incluir:

1. Objetivo — O que precisa ser realizado (1-2 frases)
2. Arquivos de Propriedade — Lista explícita de arquivos/diretórios que este colega de equipe pode modificar
3. Requisitos — Entregas ou comportamentos específicos esperados
4. Contratos de Interface — Como este trabalho se conecta ao trabalho de outros colegas de equipe
5. Critérios de Aceitação — Como verificar se a tarefa foi concluída corretamente
6. Limites de Escopo — O que está explicitamente fora do escopo

Modelo

## Objective
Build the user authentication API endpoints.

## Owned Files
- src/api/auth.ts
- src/api/middleware/auth-middleware.ts
- src/types/auth.ts (shared — read only, do not modify)

## Requirements
- POST /api/login — accepts email/password, returns JWT
- POST /api/register — creates new user, returns JWT
- GET /api/me — returns current user profile (requires auth)

## Interface Contract
- Import User type from src/types/auth.ts (owned by implementer-1)
- Export AuthResponse type for frontend consumption

## Acceptance Criteria
- All endpoints return proper HTTP status codes
- JWT tokens expire after 24 hours
- Passwords are hashed with bcrypt

## Out of Scope
- OAuth/social login
- Password reset flow
- Rate limiting

Monitoramento de Carga de Trabalho

Indicadores de Desequilíbrio

Passos de Reequilíbrio

1. Chamar TaskList para avaliar o estado atual
2. Identificar colegas ociosos ou sobrecarregados
3. Usar TaskUpdate para reatribuir tarefas
4. Usar SendMessage para notificar os colegas afetados
5. Monitorar para melhoria da vazão