diff --git a/README.md b/README.md index c6de3fb..9632472 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,7 @@ catalogue with original upstream sources: | --- | --- | | [Designer](workspaces/designer) | Interfaces, film, video editing, motion, audio review and marketing | | [Engineering](workspaces/engineering) | Portable engineering skills and Pi-native tooling | +| [Matt Engineering](workspaces/matt-engineering) | Matt Pocock's requirements, specs, tickets, implementation and design workflows | | [Finance](workspaces/finance) | Financial models, budgets, forecasts and workpapers | ```sh diff --git a/workspaces/README.md b/workspaces/README.md index b16c747..6257d81 100644 --- a/workspaces/README.md +++ b/workspaces/README.md @@ -9,6 +9,7 @@ repository; the CLI and client adapters live in | --- | --- | | [Designer](designer) | Interfaces, film, editing, motion, audio review and marketing | | [Engineering](engineering) | Portable engineering skills and Pi-native tools | +| [Matt Engineering](matt-engineering) | Matt Pocock's requirements, specs, tickets, implementation and design workflows | | [Finance](finance) | Financial modeling, budgets, forecasts and workpapers | Use the template's README for prerequisites and account setup. For example: diff --git a/workspaces/matt-engineering/.allagents/workspace.yaml b/workspaces/matt-engineering/.allagents/workspace.yaml new file mode 100644 index 0000000..50a3e44 --- /dev/null +++ b/workspaces/matt-engineering/.allagents/workspace.yaml @@ -0,0 +1,28 @@ +version: 2 + +repositories: [] + +plugins: + # Install Matt's original workflows and the helper skills they invoke. + # An explicit selection keeps unrelated upstream additions out of this recipe. + # Use skill names: upstream's manifest declares individual skill directories. + - source: https://github.com/mattpocock/skills + skills: + - grill-me + - to-spec + - to-tickets + - implement + - tdd + - code-review + - wayfinder + - grill-with-docs + - improve-codebase-architecture + - domain-modeling + - research + - prototype + - codebase-design + - setup-matt-pocock-skills + - grilling + +clients: + - universal diff --git a/workspaces/matt-engineering/README.md b/workspaces/matt-engineering/README.md new file mode 100644 index 0000000..aeb0749 --- /dev/null +++ b/workspaces/matt-engineering/README.md @@ -0,0 +1,73 @@ +# Matt Engineering + +Matt Pocock's engineering workflows, installed from the original +[mattpocock/skills](https://github.com/mattpocock/skills) source into +`.agents/skills/` through AllAgents' `universal` client. + +The recipe includes the four skills named in +[Machina's post](https://x.com/EXM7777/status/2120856056977113363): +`grill-me`, `to-spec`, `to-tickets`, and `implement`. It also includes every +Matt skill selected in the [Engineering workspace](../engineering) +and the helpers these workflows invoke: + +| Skills | Purpose | +| --- | --- | +| `grill-me`, `grilling`, `grill-with-docs` | Explore requirements and decisions, with optional domain documentation | +| `to-spec`, `to-tickets` | Turn the conversation into a spec and implementation tickets | +| `implement`, `tdd`, `code-review` | Implement, test, and review the work | +| `wayfinder`, `research`, `prototype` | Resolve larger planning decisions through research and prototypes | +| `improve-codebase-architecture`, `codebase-design`, `domain-modeling` | Improve module design and record domain language and decisions | +| `setup-matt-pocock-skills` | Configure the project's issue tracker and domain documentation | + +The explicit skill selection follows upstream's default branch and includes +supporting resources. New unrelated upstream skills are not enabled automatically. + +## Prerequisites + +- AllAgents, Git, and network access for installation. +- An assistant that discovers `.agents/skills/`, supports invoking skills, and + can delegate to subagents for the workflows that use them. +- Your project's normal build, typecheck, and test tools. +- For GitHub or GitLab issue tracking, the corresponding authenticated `gh` or + `glab` CLI and repository access. Local Markdown tracking is also supported. + +Model access and hosting are separate from skill installation. Choose and +authenticate models in your assistant. To follow the post's optional Cloudflare +hosting and database setup, install and authenticate +[Wrangler](https://developers.cloudflare.com/workers/wrangler/) separately. +This recipe does not configure models, accounts, hosting, or databases. + +## Create a workspace + +```sh +allagents workspace init ./matt-engineering-demo \ + --from allagentsdev/agent-plugins/workspaces/matt-engineering +``` + +From a local repository checkout, replace `--from` with the absolute path to +`workspaces/matt-engineering`. + +Open the new project in your assistant and run `/setup-matt-pocock-skills` once +to configure its issue tracker and domain documentation. Use your assistant's +equivalent skill invocation syntax if it does not use slash commands. Then follow +the post's sequence: + +```text +/grill-me +/to-spec +/to-tickets +/implement +``` + +The upstream workflows retain their own questions and approval steps for specs +and tickets. Keep credentials and personal service configuration outside this +shared template. + +## Update + +```sh +allagents plugin update --scope project +``` + +This fetches the latest upstream revision while preserving the recipe's explicit +skill selection.