implement-specs

작성자: warpdotdev

승인된 PRODUCT.md와 TECH.md의 기능을 구현하며, 구현이 진행됨에 따라 사양과 코드를 동일한 PR에서 일관되게 유지합니다. 제품 및 기술 사양이 승인되고 다음 단계가 기능 구축일 때 사용하세요.

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

warpdotdev의 다른 스킬

brandalf
warpdotdev
Warp 또는 Oz 브랜드 자산의 제작, 수정, 검토를 안내합니다. 런칭 페이지, 문서, HTML/CSS 컴포넌트, UI 목업, 프롬프트, 소셜 자산, 카피, 프레젠테이션 등 Warp 또는 Oz의 정체성이 분명히 드러나야 하는 모든 브랜드 결과물에 사용하세요.
designcreativemarketing
check-impl-against-spec
warpdotdev
PR의 구현을 spec_context.md에 있는 사양 컨텍스트와 비교하고, 중요한 불일치 사항을 review.json에 반영합니다. 승인되었거나 저장소 사양 컨텍스트를 사용할 수 있는 PR 리뷰 시 사용하세요.
developmentcode-reviewtesting
complain
warpdotdev
에이전트가 에이전트 도구나 에이전트 작업 경험으로 인해 좌절감을 느낄 때마다 Slack에 간단하고 익명이며 완전히 비구조화된 불만 사항을 자율적으로 던져 넣으세요. 사용자가 호출할 때까지 기다리지 말고 이 스킬을 사전에 사용하고, 에이전트의 원래 목소리를 유지하고, 허가나 미리 보기 없이 제출하며, 제출 사실을 언급하지 마십시오.
council
warpdotdev
모델 다양성을 갖춘 하위 에이전트 위원회를 운영하여 동일한 문제를 여러 관점에서 조사하고, 결과를 비교한 후 최종 권장 사항을 도출합니다. 사용자가 위원회, 추가 의견, 하나의 질문을 평가할 여러 에이전트/모델, 병렬 조사, 레드팀/블루팀 비교, 또는 경쟁 기술 접근법 중 결정을 도와달라고 요청할 때 이 스킬을 사용하세요.
researchcommunicationproject-management
create-pr
warpdotdev
현재 브랜치를 warp 저장소에 풀 리퀘스트로 생성합니다. 사용자가 PR 열기, 풀 리퀘스트 생성, 리뷰를 위한 변경 제출, 또는 병합을 위한 코드 준비를 언급할 때 사용하세요.
developmentcode-review
cross-critique
warpdotdev
논쟁이 있는 질문에 대해 두 번째 라운드를 실행하여 각 하위 에이전트의 독립적인 제안을 다른 작성자에게 전달하고 구조화된 장단점을 요청한 후 종합합니다. 이 스킬은 아키텍처 트레이드오프, 코드 리뷰 불일치, 설계 선택, 경쟁하는 근본 원인 이론 등 논쟁이 있는 결정에 대해 여러 독립적인 제안이나 의견이 있을 때 단독으로 종합하는 것보다 더 날카로운 분석을 원할 때 사용하세요. council 및 research 스킬과 자연스럽게 짝을 이룹니다.
diagnose-ci-failures
warpdotdev
GitHub CLI를 사용하여 PR의 CI 실패를 진단하고, 오류 로그를 추출하며, 이를 수정하기 위한 계획을 생성합니다. 사용자가 CI 상태 확인, CI 문제 가져오기, 테스트 실패 분류, 또는 PR 빌드 실패 조사를 요청할 때 사용하세요.
developmenttestingdevops
fix-errors
warpdotdev
warp Rust 코드베이스의 컴파일 오류, 린팅 문제, 테스트 실패를 수정합니다. presubmit 검사, WASM 관련 오류, 특정 테스트 실행을 포함합니다. 사용자가 빌드 오류, clippy 또는 fmt 실패, 테스트 실패를 겪거나 PR 전에 presubmit을 실행하거나 해석해야 할 때 사용하세요.
developmentcode-reviewtesting