mirrors/mattpocock-skills
2
0
Fork 1
mirror of https://github.com/mattpocock/skills.git synced 2026-06-25 08:24:06 +00:00
Code Issues Projects Releases Packages Wiki Activity

refine: Clarify multi-session build process and enhance triage guidance in 'ask-matt' skill documentation

Browse source
This commit is contained in:
Matt Pocock 2026-06-17 14:53:11 +01:00
commit 48f3d31fef
1 changed files with 5 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
skills/engineering/ask-matt/SKILL.md
View file

@ -20,7 +20,7 @@ The route most work travels. You have an idea and want it built.
- **`/prototype`** to answer the question with throwaway code,
- **`/handoff`** back what you learned, and reference it from the original idea thread.
3. **Branch — is this a multi-session build?**
- **Yes** → **`/to-prd`** (turn the thread into a PRD) → **`/to-issues`** (split the PRD into independently-grabbable issues) → **`/implement`** the issues one by one, each in its own agent.
- **Yes** → **`/to-prd`** (turn the thread into a PRD) → **`/to-issues`** (split the PRD into independently-grabbable issues). Because the issues are independent, **clear context between each one**: start a fresh session per issue and kick off **`/implement`** by passing it the PRD and the single issue to work on.
- **No** → **`/implement`** right here, in the same context window.
### Context hygiene
@ -35,11 +35,13 @@ A starting situation that generates work, then merges onto the main flow.
- **Bugs and requests piling up** → **`/triage`**. It moves issues through triage roles and produces agent-ready issues, which **`/implement`** later picks up.
Triage is only for issues **you didn't create** — bug reports, incoming feature requests, anything that arrives raw. Issues that `/to-issues` produced are already agent-ready, so **don't triage them**.
## Codebase health
Not feature work — upkeep.
- **`/improve-codebase-architecture`** — run whenever you have a spare moment to keep the codebase good for agents to operate in. It surfaces deepening opportunities; picking one *generates an idea* you can take into the main flow at `/grill-with-docs`.
- **`/improve-codebase-architecture`** — run whenever you have a spare moment to keep the codebase good for agents to operate in. It surfaces deepening opportunities; picking one _generates an idea_ you can take into the main flow at `/grill-with-docs`.
## Crossing sessions
@ -56,4 +58,4 @@ Off the main flow entirely.
## Precondition
**`/setup-matt-pocock-skills`** — run once per repo before any engineering flow. It configures the issue tracker, triage labels, and doc layout the other skills assume.
**`/setup-matt-pocock-skills`** — run before your first engineering flow to configure the issue tracker, triage labels, and doc layout the other skills assume. Custom issue trackers also work.