implement-spec

Implement the result of /to-spec and /to-tickets in code.

npx skills add https://github.com/mattpocock/skills --skill implement-spec

You have been provided a spec. This spec should have tickets associated with it, describing how to implement the spec.

The issue tracker should have been provided to you. If not, tell the user to run /setup-matt-pocock-skills.

The goal is the entire spec implemented on a single integration branch, with every ticket resolved the way the issue tracker closes work.

The tickets are not a list of steps. They are a task graph with blocking relationships between them. This means there is always a frontier of tickets which are ready to be grabbed.

Start every subagent with a fresh context window.

Communication to and from subagents should be sparse. Communicate primarily through context pointers: to the spec, tickets, research notes, and previous commits. Don't duplicate information already available via pointers.

Implementer subagents should be run in the background where possible for maximum concurrency.

Steps

  1. Read the spec and tickets to understand the task graph.

  2. (optional) Use an exploration subagent to conduct any exploration required by the tickets - relevant codebase files or external documentation. Ensure the exploration subagent can save files - it should save its markdown notes in a directory outside the repo, accessible by all future subagents. This lets implementer subagents focus on implementation rather than exploration.

  3. Create the integration branch. If the issue tracker closes work through PRs, or the user asks for one, open a draft PR after the first merge in step 5 (a branch with no commits ahead of main can't open one), marked as closing the spec and tickets.

  4. Use a fresh implementer subagent for each ticket, each in its own worktree on its own branch. Each implementer subagent:

    • confirms its worktree is based on the integration branch before starting, and resets onto it if not;
    • calls the Skill tool with tdd to build the ticket;
    • merges the integration branch tip into its own branch before reporting done
  5. Once an implementer subagent completes, merge its work to the integration branch with a merger subagent.

  6. If this changes the frontier of available tickets, kick off more implementer subagents to work on the new tickets. This allows for maximum concurrency.

  7. Once all tickets are complete, call the Skill tool with code-review on the integration branch. Fix all issues raised by the code review in a single fresh implementer subagent.

  8. If a draft PR exists, mark it ready for review. Otherwise, resolve each ticket the way the issue tracker closes work, and report the integration branch.

  9. Clean up all implementer subagent worktrees.

Thêm skills từ mattpocock

ask-matt
mattpocock
Hỏi kỹ năng hoặc luồng nào phù hợp với tình huống của bạn. Một bộ định tuyến qua các kỹ năng do người dùng gọi trong repo này.
communicationresearchproductivity
chief-of-staff
mattpocock
Pursue a long-running goal in a single session by co-ordinating subagents.
productivityproject-managementcommunication
claude-handoff
mattpocock
Chuyển cuộc trò chuyện hiện tại cho một tác nhân nền mới, người sẽ tiếp nhận công việc ngay lập tức.
codebase-design
mattpocock
Từ vựng chung để thiết kế các mô-đun sâu. Sử dụng khi người dùng muốn thiết kế hoặc cải thiện giao diện của một mô-đun, tìm cơ hội đào sâu, quyết định vị trí đặt seam, làm cho mã dễ kiểm thử hơn hoặc dễ dẫn đường cho AI, hoặc khi một kỹ năng khác cần từ vựng về mô-đun sâu.
designdevelopmentcode-review
code-review
mattpocock
Xem xét các thay đổi kể từ một điểm cố định (commit, branch, tag, hoặc merge-base) theo hai khía cạnh — Tiêu chuẩn (mã có tuân theo các tiêu chuẩn lập trình được ghi lại của repo này không?) và Đặc tả (mã có khớp với những gì issue/PRD yêu cầu không?). Chạy cả hai bài đánh giá song song trong các tác nhân phụ và báo cáo chúng cạnh nhau. Sử dụng khi người dùng muốn xem xét một branch, một PR, các thay đổi đang trong quá trình làm việc, hoặc yêu cầu "xem xét kể từ X".
testingdevelopmentcode-review
design-an-interface
mattpocock
Tạo nhiều thiết kế giao diện khác biệt hoàn toàn cho một mô-đun bằng cách sử dụng các tác nhân phụ song song. Sử dụng khi người dùng muốn thiết kế API, khám phá các tùy chọn giao diện, so sánh hình dạng mô-đun hoặc đề cập đến "thiết kế hai lần".
developmentdesignapi
diagnosing-bugs
mattpocock
Vòng lặp chẩn đoán cho các lỗi khó và suy giảm hiệu suất. Sử dụng khi người dùng nói "chẩn đoán"/"gỡ lỗi cái này", hoặc báo cáo điều gì đó bị hỏng/gây lỗi/thất bại/chậm.
testingdevelopmentcode-review
domain-modeling
mattpocock
Xây dựng và mài giũa mô hình miền của dự án. Sử dụng khi người dùng muốn xác định thuật ngữ miền hoặc ngôn ngữ chung, ghi lại quyết định kiến trúc, hoặc khi một kỹ năng khác cần duy trì mô hình miền.
designdevelopmentdocument