Compare commits

..
11 Commits
Author SHA1 Message Date
Matt Pocock c32909ccb2 Added prefactoring 2026-06-07 18:44:44 +01:00
Matt Pocock 208ff8da0b refine: Add skill documentation for resolving merge conflicts 2026-06-07 18:44:44 +01:00
Matt Pocock 50ef06ea3b The fewer seams, the better 2026-06-07 18:44:44 +01:00
Matt Pocock 00e8859e94 Improved /grill-with-docs commit message 2026-06-07 18:44:44 +01:00
Matt Pocock c7d43525e4 refine: Update description for grilling skill to enhance clarity and focus 2026-06-07 18:44:44 +01:00
Matt Pocock 94e085ed74 refine: Remove caveman skill documentation to streamline productivity skills 2026-06-07 18:44:44 +01:00
Matt Pocock d6ab0d3853 refine: Remove caveman skill documentation to streamline productivity skills 2026-06-07 18:44:44 +01:00
Matt Pocock 6c98743168 refine: Add disable-model-invocation flag to edit-article skill for improved functionality 2026-06-07 18:44:44 +01:00
Matt Pocock 8f8a96f136 refine: Update description for grill-me skill and adjust session instruction for clarity 2026-06-07 18:44:44 +01:00
Matt Pocock 8080fb9ab5 refine: Simplify instructions for running grilling and domain modeling skills 2026-06-07 18:44:44 +01:00
Matt Pocock 7a32991c2f feat: Add new skills and templates for domain modeling, bug diagnosis, and architectural improvement
- Introduced a human-in-the-loop script for bug diagnosis to capture user feedback.
- Created ADR and CONTEXT formats to standardize architectural decision records and domain context documentation.
- Developed a domain modeling skill to refine terminology and maintain a shared language.
- Enhanced the improve-codebase-architecture skill to provide visual reports and deepening opportunities.
- Consolidated grilling and handoff skills for better user interaction and documentation.
- Updated existing skills to improve clarity and consistency in descriptions and functionality.
2026-06-07 18:44:44 +01:00
9 changed files with 1 additions and 25 deletions
-1
View File
@@ -17,7 +17,6 @@
"./skills/productivity/grill-me", "./skills/productivity/grill-me",
"./skills/productivity/grilling", "./skills/productivity/grilling",
"./skills/productivity/handoff", "./skills/productivity/handoff",
"./skills/productivity/teach",
"./skills/productivity/write-a-skill" "./skills/productivity/write-a-skill"
] ]
} }
-1
View File
@@ -175,7 +175,6 @@ General workflow tools, not code-specific.
- **[caveman](./skills/productivity/caveman/SKILL.md)** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy. - **[caveman](./skills/productivity/caveman/SKILL.md)** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy.
- **[grill-me](./skills/productivity/grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved. - **[grill-me](./skills/productivity/grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved.
- **[handoff](./skills/productivity/handoff/SKILL.md)** — Compact the current conversation into a handoff document so another agent can continue the work. - **[handoff](./skills/productivity/handoff/SKILL.md)** — Compact the current conversation into a handoff document so another agent can continue the work.
- **[teach](./skills/productivity/teach/SKILL.md)** — Teach the user a new skill or concept over multiple sessions, using the current directory as a stateful teaching workspace.
- **[write-a-skill](./skills/productivity/write-a-skill/SKILL.md)** — Create new skills with proper structure, progressive disclosure, and bundled resources. - **[write-a-skill](./skills/productivity/write-a-skill/SKILL.md)** — Create new skills with proper structure, progressive disclosure, and bundled resources.
**Skills** **Skills**
-15
View File
@@ -1,15 +0,0 @@
---
name: implement
description: "Implement a piece of work based on a PRD or set of issues."
disable-model-invocation: true
---
Implement the work described by the user in the PRD or issues.
Use /tdd where possible, at pre-agreed seams.
Run typechecking regularly, single test files regularly, and the full test suite once at the end.
Once done, use /review to review the work.
Commit your work to the current branch.
@@ -40,10 +40,6 @@ The lesson should teach ONE THING only. It should be completable very quickly -
Make opening a lesson as easy as possible — ideally a single CLI command the user can run to open the HTML file in their browser. Make opening a lesson as easy as possible — ideally a single CLI command the user can run to open the HTML file in their browser.
Each lesson should link via HTML anchors to other lessons and reference documents.
Each lesson should recommend a primary source for the user to read or watch. This should be the most high-quality, high-trust resource you found on the topic.
## The Mission ## The Mission
Every lesson should be tied into the mission - the reason that the user is interested in learning about the topic. Every lesson should be tied into the mission - the reason that the user is interested in learning about the topic.
@@ -52,8 +48,6 @@ If the user is unclear about the mission, or the `MISSION.md` is not populated,
Failing to understand the mission will mean knowledge acquisition is not grounded in real-world goals. Lessons will feel too abstract. You will have no way of judging what the user should do next. Failing to understand the mission will mean knowledge acquisition is not grounded in real-world goals. Lessons will feel too abstract. You will have no way of judging what the user should do next.
Missions may change as the user develops more skills and knowledge. This is normal - make sure to update the `MISSION.md` and add a learning record to capture the change. Confirm with the user before changing the mission.
## Zone Of Proximal Development ## Zone Of Proximal Development
Each lesson, the learner should always feel as if they are being challenged 'just enough'. Each lesson, the learner should always feel as if they are being challenged 'just enough'.
+1 -2
View File
@@ -8,8 +8,7 @@ User-invoked entry points (`disable-model-invocation: true`).
- **[grill-me](./grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved. - **[grill-me](./grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved.
- **[handoff](./handoff/SKILL.md)** — Compact the current conversation into a handoff document so another agent can continue the work. - **[handoff](./handoff/SKILL.md)** — Compact the current conversation into a handoff document so another agent can continue the work.
- **[teach](./teach/SKILL.md)** — Teach the user a new skill or concept over multiple sessions, using the current directory as a stateful teaching workspace. - **[write-a-skill](./write-a-skill/SKILL.md)** — Create a new skill with proper structure, progressive disclosure, and bundled resources.
- **[write-a-skill](./write-a-skill/SKILL.md)** — Create new skills with proper structure, progressive disclosure, and bundled resources.
## Skills ## Skills