Matt Pocock's skills 1.3 builds a whole spec in parallel, then writes the PR and runs the retro

1 month ago

Matt Pocock's agent skills 1.3 adds implement-spec, which builds a whole spec in parallel on one integration branch, plus pr for scannable pull request bodies and retro for fixing what slowed the agent down. CONTEXT.md becomes GLOSSARY.md, and resolving-merge-conflicts is removed. Source: https://github.com/mattpocock/skills/pull/1120 Repository: https://github.com/mattpocock/skills

Ask about this presentation

Chapters

  1. 0:00Matt Pocock's skills now build a whole spec in parallel
  2. 0:25Build the whole spec
  3. 0:27Tickets as a task graph
  4. 0:49One integration branch
  5. 1:20implement or implement-spec
  6. 1:45Ship it and look back
  7. 1:47The pr skill
  8. 2:14Merge Danger
  9. 2:40The retro skill
  10. 3:12The main flow
  11. 3:33Skills call the Skill tool
  12. 3:55Where implement-spec needs a hand
  13. 4:24Before you upgrade
  14. 4:27CONTEXT.md becomes GLOSSARY.md
  15. 4:50resolving-merge-conflicts removed
  16. 5:10Get it
Show transcript
  1. Matt Pocock's skills repository merged its 1.3 update on September 29th. Three skills join the Claude Code plugin, and one leaves it. The biggest is implement spec. It takes a spec and its tickets and builds all of it in one run, with several agents working at once. Then pr shapes the pull request, and retro looks back at the session. The plugin goes from 25 skills to 27.

    Slide text
    Build Ship Upgrade

    Three skills join the plugin and one leaves in mattpocock/skills 1.3

    skills/engineering/
    + implement-spec/
    + pr/
    + retro/
    - resolving-merge-conflicts/
  2. First, implement spec.

    Slide text
    1

    Build the whole spec in one run

  3. You type slash implement spec and point it at a spec that the to tickets skill has already split into tickets. It reads those tickets as a task graph. Blocking edges decide what can start, so at any moment there's a frontier of tickets whose blockers have all landed, and every ticket on that frontier runs at once. Each one goes to an implementer subagent working in its own git worktree.

    Slide text
    Build Ship Upgrade

    implement-spec builds every ticket whose blockers have landed, all at once

    Each ticket gets its own agent, in its own git worktree

    Ticket 1 ready frontier
    Ticket 2 ready frontier
    Ticket 3 blocked by 1
    Ticket 4 blocked by 1 and 2
  4. Each implementer does the same three things. It checks that its worktree starts from the integration branch, builds its ticket with the tdd skill one failing test at a time, and merges the latest integration branch in before it reports done, so landing its work is a fast-forward. When every ticket is in, code review runs once over the whole branch. A draft pull request opens only when your issue tracker closes work through pull requests, or when you ask for one. On a local markdown tracker, the whole run works offline.

    Slide text
    Build Ship Upgrade

    Every ticket lands on one integration branch, built test-first

    1 Start from the integration branch
    2 Build the ticket with /tdd, red then green
    3 Merge the integration tip in, so landing is a fast-forward

    Then /code-review runs once, over the whole branch

  5. The implement skill still works one ticket per session. You're the dispatcher: you clear context between tickets and keep track of which ones are unblocked. Implement spec hands that job to one orchestrating session, and you review the whole integration branch once, at the end. It needs a harness that runs subagents in the background and gives each one a worktree. For a small change with no real graph to it, use implement directly.

    Slide text
    Build Ship Upgrade

    Reach for it when you'd rather orchestrate than dispatch each ticket

    /implement One session per ticket. You clear between tickets and track what's unblocked.
    /implement-spec One session runs the graph. You review the integration branch at the end.

    Needs a harness that runs background subagents, each with a git worktree

  6. Next, shipping the work and learning from it.

    Slide text
    2

    Ship it, then look back

  7. The pr skill is a format for the pull request body, and the agent uses it on its own whenever it writes one. The summary is the smallest picture that shows the change: pseudocode, a call tree, a file tree, a Mermaid diagram, or a diff. Evidence is a before and an after: a screenshot when the change is visual, and otherwise the test that failed and now passes. The skill writes the body only. Opening the pull request is still up to you or your agent.

    Slide text
    Build Ship Upgrade

    The pr skill writes a body a reviewer can scan

    The agent reaches for it whenever it writes a pull request

    ## Summary
    <diagram, diff-sketch, or tree>
    ## Evidence
    - Before: … After: …
    ## Merge Danger
    Door: one-way or two-way · Blast Radius: …
  8. The last section is Merge Danger. A two-way door is cheap to walk back. A one-way door, like a destructive migration or a removed public API, is not. Blast radius names what breaks if the change is wrong. Here's that call on the 1.3 pull request itself: two-way for the new skills, and one-way-ish for the removal and the glossary rename. Read this line most carefully, because the agent that wrote the change is the one grading it.

    Slide text
    Build Ship Upgrade

    Merge Danger says whether you can walk the change back

    Door: two-way for the graduations, one-way-ish for the removal and the glossary rename
    Blast Radius: plugin

    The Merge Danger section of the 1.3 pull request, mattpocock/skills #1120

  9. Retro comes last. Type slash retro after a session that felt harder than it should have. It reads that session's record and suggests changes to the agent's environment. A file that took too long to find gets a navigation pointer. A mistake a tool could have caught gets a deterministic check: a lint rule, a hook, or a CI job. Only real judgement calls become coding standards, which the review agent reads. A repo with no guardrail at all is a finding by itself. Retro only proposes, and you pick which fixes to apply.

    Slide text
    Build Ship Upgrade

    retro turns a rough session into fixes for the next one

    Slow to find a file A navigation pointer
    A mistake a tool could catch A lint rule, test, hook or CI job
    A judgement call the reviewer missed A rule in CODING_STANDARDS.md
    Information it couldn't reach Wider read-only access
  10. Put together, here's the main flow now. Grill with docs sharpens the idea. To spec and to tickets turn it into a plan. Implement spec, or implement one ticket at a time, builds it test-first. Code review checks the branch, pr describes it, and retro improves the setup for next time. The Ask Matt router skill now points you to each one.

    Slide text
    Build Ship Upgrade

    The main flow now runs from the first question to the retro

    /grill-with-docs /to-spec /to-tickets /implement-spec /code-review /pr /retro
  11. Under the hood, skills now call each other more directly. When a step needs another skill, it says: call the Skill tool with grilling. It used to mention slash grilling in the middle of a sentence. That's aimed at the most reported problem with grill with docs, where the grilling step failed to load. It also reads the same way in Claude Code, Codex and other harnesses.

    Slide text
    Build Ship Upgrade

    Skills now load each other by calling the Skill tool

    Aimed at grill-with-docs' most reported problem: grilling that doesn't load

    - Run the /grilling skill.
    + Call the Skill tool with "grilling".
  12. Implement spec still needs a hand in three places. One user's five-ticket feature spent about four hours in the review and fix loop. If a second broad review starts, ask for focused checks on what was fixed, then stop. On GitHub, a blocked ticket waits until its blocker closes, which usually happens at the end of the run, so have the orchestrator track merges itself. And two tickets running in parallel can name the same thing differently. Add a blocking edge between them, or pin the names in the shared notes.

    Slide text
    Build Ship Upgrade

    Where implement-spec still needs a hand

    The review and fix loop runs long Ask for focused checks on the fixed findings, then stop
    GitHub holds blocked tickets until their blocker closes Have it track merges into the integration branch
    Parallel tickets name one thing two ways Add a blocking edge, or pin names in shared notes
  13. Two changes need action before you upgrade.

    Slide text
    3
  14. The shared glossary that grill with docs writes has a new name. Every skill that reads or writes it, from grill with docs to tdd, diagnosing bugs and the new pr skill, now looks only for GLOSSARY.md, and for the glossary map when a repo has several. If your repo has a CONTEXT.md, rename it with git mv, and your glossary keeps working.

    Slide text
    Build Ship Upgrade

    Rename CONTEXT.md to GLOSSARY.md so the skills keep reading it

    - CONTEXT.md
    + GLOSSARY.md
    - CONTEXT-MAP.md
    + GLOSSARY-MAP.md
    $ git mv CONTEXT.md GLOSSARY.md
  15. The second change is a removal. The resolving merge conflicts skill leaves the plugin and the Ask Matt router, with no replacement skill. The agent works through a conflicted merge or rebase on its own. Its page on aihero.dev stays up, marked archived. If you rely on it, keep a copy of the skill before you update.

    Slide text
    Build Ship Upgrade

    resolving-merge-conflicts leaves the plugin, with no replacement

    The agent now works through a conflicted merge or rebase on its own

    skills/engineering/
    - resolving-merge-conflicts/
    aihero.dev/skills-resolving-merge-conflicts archived
  16. Implement spec gets you to a draft fast, and its code review is where that draft gets finished. Version 1.3 is on the main branch now, and the Claude Code plugin moves from 1.2.3 to 1.3.0 when its version pull request merges. Rename your context file first. Then the whole flow, from the first question to the retro, comes in one install, and Matt Pocock's skills build a whole spec in parallel.

    Slide text
    Build Ship Upgrade

    Matt Pocock's skills now build a whole spec in parallel

    1.3 is on main. The plugin moves from 1.2.3 to 1.3.0 when its version pull request merges.

    $ claude plugins install mattpocock-skills
    github.com/mattpocock/skills

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built with ❤️ in New York