Skip to content

Stub: retro skill — raw idea dump - #889

Draft
mattpocock wants to merge 2 commits into
mainfrom
stub/retro-skill
Draft

Stub: retro skill — raw idea dump#889
mattpocock wants to merge 2 commits into
mainfrom
stub/retro-skill

Conversation

@mattpocock

@mattpocock mattpocock commented Aug 16, 2026

Copy link
Copy Markdown
Owner

Summary

  • skills/in-progress/retro/SKILL.md is now a stub, not a working skill: an uncut capture of every idea from the design conversation, explicitly marked not-functional, meant to be reduced to a real process later via /writing-for-agents.
  • Ideas captured (all of them, not just the ones with enough detail to build): determinism hunting, CLAUDE.mdCODING_STANDARDS.md migration, writing-for-agents' branch vocabulary applied to code review, tool economy read off the session JSONL, navigation-pointer gaps, the codebase-design lens, the sub-agents-vs-single-skill architecture question left open, multi-session mode, and propose-never-apply (a PR, never a direct write).
  • Background: Matt tweeted the seed of this Aug 15-16 (compound engineering's promise without ceding control to the model): https://x.com/mattpocockuk/status/2088741042744901842 — name, CODING_STANDARDS.md as destination, and the must-also-delete requirement all trace to that thread; the rest is from the design conversation that produced this PR.
  • in-progress bucket per this repo's CLAUDE.md: no docs page, no top-level README.md/plugin registration, no ask-matt update needed.

Test plan

  • N/A — markdown + yaml stub, no code path. No skill-structure CI in this repo to run.
  • Human read of the "Ideas to fold in" list for completeness before anyone runs /writing-for-agents against it.

🤖 Generated with Claude Code

Matt tweeted the shape on Aug 15-16 (compound engineering's promise
without ceding control to the model): mine session friction, propose
CODING_STANDARDS.md additions AND deletions, land as a PR rather than
writing directly. Name, destination file, and the "must delete too"
requirement all came from that thread.

Three more lenses (tool economy from session JSONL, navigation-pointer
drafting, multi-session transcript fan-out) are named in the SKILL.md's
"Not yet built" section but not specified closely enough to build yet.

In-progress bucket: no docs page, no plugin/README (top-level)
registration, no ask-matt update needed per CLAUDE.md's bucket rules.
@changeset-bot

changeset-bot Bot commented Aug 16, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 88cfec7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
mattpocock-skills Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Previous version built one lens out to a real process, which wasn't
the ask — this replaces it with an uncut capture of every idea from
the design conversation (determinism hunting, CLAUDE.md->standards
migration, writing-for-agents branches applied to review, tool
economy off session JSONL, navigation pointers, codebase design,
the sub-agents-vs-single-skill question, multi-session mode,
propose-never-apply), explicitly marked not-functional and parked
for a /writing-for-agents pass later.
@mattpocock mattpocock changed the title Stub: retro skill (steering-hygiene lens only) Stub: retro skill — raw idea dump Aug 16, 2026
@mattpocock
mattpocock marked this pull request as draft August 17, 2026 07:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant