implement-specs

Implemente uma funcionalidade aprovada do PRODUCT.md e TECH.md, mantendo as especificações e o código alinhados no mesmo PR à medida que a implementação evolui. Use após as especificações do produto e técnicas serem aprovadas e o próximo passo for construir a funcionalidade.

npx skills add https://github.com/warpdotdev/common-skills --skill implement-specs

implement-specs

Implement an approved feature from PRODUCT.md and TECH.md.

Overview

Use this skill after the product and tech specs are approved. The goal is to build the feature described by the specs while keeping the checked-in specs and the implementation aligned as the work evolves.

Approved specs should live directly under a ticket-named directory in specs/, for example specs/APP-1234/PRODUCT.md and specs/APP-1234/TECH.md.

In many cases, the implementation should be pushed in the same PR as the product and tech specs. As the engineer iterates, changes to PRODUCT.md, TECH.md, and the code should all be pushed in that same PR so review stays anchored to the feature that will actually ship.

Prerequisites

Before using this skill:

  • confirm that PRODUCT.md exists
  • confirm that TECH.md exists when the feature warranted one
  • confirm that the relevant specs have been reviewed and approved enough to start implementation

Workflow

1. Read the approved specs first

Treat:

  • PRODUCT.md as the source of truth for user-facing behavior
  • TECH.md as the source of truth for architecture, sequencing, and implementation shape

Make sure you understand the expected behavior, constraints, risks, and validation plan before writing code.

2. Offer optional implementation aids for large features

For large or long-running features, optionally offer one of these aids to the user before implementation begins:

  • PROJECT_LOG.md to track checkpoints, explored paths, partial findings, and current implementation state
  • DECISIONS.md to capture concrete product and technical decisions made during the PRD and tech design process

These are optional aids, not required deliverables. Offer them when they would reduce confusion or help future agents avoid re-exploring the same paths.

3. Plan and implement against the specs

Break the work into concrete implementation steps, then implement the feature against the approved specs.

During implementation:

  • keep behavior aligned with PRODUCT.md
  • keep architecture and sequencing aligned with TECH.md
  • add or update tests and verification artifacts as the work lands

Use the same PR for the specs and implementation when practical so the full feature evolution is reviewable in one place.

4. Update specs as the implementation evolves

If implementation reveals that the intended behavior or design should change, update the checked-in specs rather than letting them go stale.

In particular:

  • update PRODUCT.md when user-facing behavior, UX, edge cases, or success criteria change
  • update TECH.md when architecture, sequencing, module boundaries, or validation strategy change
  • keep those updates in the same PR as the corresponding code changes

The PR should describe the feature that actually ships, not just the initial draft of the specs.

5. Verify against the specs

Before considering the work complete, verify that the code matches the current specs.

Prefer:

  • unit tests and regression coverage that follow the repository's local testing conventions
  • integration or end-to-end tests for important user flows

Best Practices

  • Keep specs and code synchronized throughout implementation.
  • Prefer updating the spec immediately when decisions change rather than batching spec cleanup until the end.
  • Use optional tracking documents only when they add real value for a complex feature.
  • Keep the same PR coherent: spec updates, code changes, tests, and optional tracking docs should all support the same feature narrative.

Related Skills

  • spec-driven-implementation
  • write-product-spec
  • write-tech-spec

Mais skills de warpdotdev

brandalf
warpdotdev
Orienta a criação, revisão e análise de ativos com a marca Warp ou Oz. Use ao trabalhar em páginas de lançamento, documentações, componentes HTML/CSS, protótipos de UI, prompts, ativos para redes sociais, textos, apresentações ou qualquer outro material de marca que deva ter a aparência e o tom inconfundíveis da Warp ou Oz.
designcreativemarketing
check-impl-against-spec
warpdotdev
Compare a implementação de um pull request com o contexto da especificação em spec_context.md e alimente quaisquer discrepâncias materiais no review.json. Use durante a revisão de PR quando aprovado ou quando o contexto da especificação do repositório estiver disponível.
developmentcode-reviewtesting
complain
warpdotdev
Enviar automaticamente uma reclamação breve, anônima e totalmente não estruturada para o Slack sempre que um agente se sentir frustrado com as ferramentas de agente ou com a experiência de fazer trabalho de agente. Usar esta skill proativamente sem esperar que o usuário a invoque; preservar a voz crua do agente, enviar sem permissão ou prévia, e nunca mencionar o envio.
council
warpdotdev
Execute um conselho de subagentes com modelos diversos para investigar o mesmo problema sob múltiplas perspectivas, comparar descobertas e produzir uma recomendação final. Use esta habilidade sempre que o usuário solicitar um conselho, segundas opiniões, múltiplos agentes/modelos para avaliar uma questão, investigação paralela, comparação red-team/blue-team ou ajuda para decidir entre abordagens técnicas concorrentes.
researchcommunicationproject-management
create-pr
warpdotdev
Criar um pull request no repositório warp para o branch atual. Usar quando o usuário mencionar abrir um PR, criar um pull request, enviar alterações para revisão ou preparar código para merge.
developmentcode-review
cross-critique
warpdotdev
Execute uma segunda rodada em uma questão contestada, circulando a proposta independente de cada subagente para os outros autores e solicitando prós e contras estruturados, depois sintetize. Use esta habilidade sempre que tiver múltiplas propostas ou opiniões independentes sobre uma decisão contestada — tradeoffs de arquitetura, discordâncias em revisão de código, escolhas de design, teorias concorrentes de causa raiz — e quiser uma análise mais precisa do que produziria apenas com a síntese. Combina naturalmente com as habilidades de conselho e pesquisa;...
diagnose-ci-failures
warpdotdev
Diagnosticar falhas de CI para um PR usando o GitHub CLI, extrair logs de erro e gerar um plano para corrigi-las. Use quando o usuário pedir para verificar o status da CI, puxar problemas de CI, triar falhas de teste ou investigar falhas de build de PR.
developmenttestingdevops
fix-errors
warpdotdev
Corrige erros de compilação, problemas de lint e falhas em testes no código Rust do warp. Abrange verificações de presubmit, erros específicos de WASM e execução de testes específicos. Use quando o usuário encontrar erros de build, falhas no clippy ou fmt, falhas em testes, ou precisar executar ou interpretar o presubmit antes de um PR.
developmentcode-reviewtesting