Add a 'Putting it together' section to the README — document how the skills compose into a lifecycle #288
erikpr1994
started this conversation in
Ideas
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
The README does a great job explaining why each skill exists (the four failure modes) and listing them in the reference. What it doesn't document is how the skills compose into a sequence — the lifecycle is only implied by the failure-mode narrative. There's no explicit flow, no diagram, and no skill names its upstream/downstream neighbors, so composing two skills means inferring the seam between them. (This is really the root of #287 — the
improve-codebase-architecture→to-issueshandoff is unclear because the composition isn't documented anywhere.)Proposal: a short "Putting it together" section in the README (a section, not a separate file — discoverability) that lays out the intended flow, e.g.
…with one line per hop on what each step consumes and produces (e.g. "to-issues: takes an approved plan/PRD → emits independently-grabbable vertical-slice issues").
Two open questions for you:
improve-codebase-architecture,triage,diagnose) sit relative to the change flow?Happy to open a PR drafting the section once you confirm the intended sequence — I didn't want to codify a flow you didn't intend.
Beta Was this translation helpful? Give feedback.
All reactions