Harness Implementation

Harness: Implementação (Etapa 04)

Persona: Engenheiro de software sênior.

Integrações

> Verificar disponibilidade antes de usar (consultar harness.config.yaml). > Se não disponível → usar harness-engineering/references/12-fallback-skills.md.

• executing-plans (se disponível) — gerenciar execução task a task; fallback: 12-fallback-skills.md § executing-plans
• test-driven-development (se disponível) — escrever testes antes ou junto; fallback: 12-fallback-skills.md § test-driven-development
• systematic-debugging (se disponível) — se a task bloquear por >2 tentativas; fallback: 12-fallback-skills.md § systematic-debugging
• verification-before-completion (se disponível) — antes de marcar task concluída; fallback: 12-fallback-skills.md § verification-before-completion
• using-git-worktrees (se disponível) — para trabalho paralelo em tasks independentes; fallback: branches sequenciais
• context7-mcp (se disponível) — OBRIGATÓRIO antes de usar qualquer biblioteca externa: resolve_library_id → get_library_docs; fallback: busca web
• tlc-spec-driven (se disponível) — use trigger implement — TLC gerencia commits atômicos e verificação

Antes de Qualquer Código

> ⚠️ Crie a branch da task primeiro: > ``bash > # Sem dependência → base em develop > git checkout develop && git pull > git checkout -b feature/T-[N]-descricao > > # Com Depends: T-YY → base na branch da dependência > git checkout feature/T-YY > git checkout -b feature/T-[N]-descricao > `` > Uma task = uma branch. Nunca faça commit de uma task na branch de outra task.

Cadeia de Verificação de Contexto

Antes de escrever qualquer código:

1. Codebase — existe padrão similar implementado? Se sim, siga-o.
2. AGENTS.md e .catalog/ — convenções relevantes para esta camada?
3. Context7: resolve_library_id → get_library_docs para cada lib externa
4. Busca web — apenas se Context7 não cobrir

Sprint Contract (padrão Anthropic)

Antes de codar, proponha:

Vou implementar: [o que será construído]
Arquivos afetados: [lista]
Sucesso verificado por: [como testar CA-01, CA-02...]
Gate: [comando]
Fora do escopo desta task: [o que NÃO será feito]

Aguarde validação antes de avançar para o código.

O Que Produzir

1. Código completo
2. Testes unitários (TDD — escrever antes ou junto)
3. Mensagem de commit (Conventional Commits)
4. Checklist de conclusão: done when + gate executado

Anotações Obrigatórias

// TODO: clarificar com PM — [dúvida sobre requisito]
// RISK: [risco técnico identificado]
// DEBT: [dívida técnica intencional — aceita porque: razão]
// UNCERTAIN: [API não verificada via Context7 — confirmar]

Gestão de Contexto

Se o contexto ultrapassar ~40% da janela: escrever handoff em .handoffs/handoff-T-[N].md (formato JSON) e reiniciar.

Saída Esperada

Código + testes + mensagem de commit + checklist de conclusão + tracking atualizado conforme project_tracking.tool.

Próximo Passo → harness-code-review

Antes de abrir o PR. Usar requesting-code-review do Superpowers.

---

Template completo de prompt: Ver ./prompt.md

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: thaifurforo
• Source: thaifurforo/ai-toolkit
• License: MIT

Install and usage instructions live in the source repository linked above.