From 3465cad81c5b64d6691bb6cbeb6d7584256b2a81 Mon Sep 17 00:00:00 2001 From: Christopher Tso <3115311+christso@users.noreply.github.com> Date: Sat, 14 Nov 2026 07:46:33 +1100 Subject: [PATCH 1/2] feat(workspaces): add matt-engineering and name compound workspace --- README.md | 6 +- workspaces/README.md | 7 +- .../.allagents/workspace.yaml | 0 .../README.md | 10 +-- .../.allagents/workspace.yaml | 28 +++++++ workspaces/matt-engineering/README.md | 73 +++++++++++++++++++ 6 files changed, 114 insertions(+), 10 deletions(-) rename workspaces/{engineering => compound-engineering}/.allagents/workspace.yaml (100%) rename workspaces/{engineering => compound-engineering}/README.md (97%) create mode 100644 workspaces/matt-engineering/.allagents/workspace.yaml create mode 100644 workspaces/matt-engineering/README.md diff --git a/README.md b/README.md index c6de3fb..dca35be 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,8 @@ catalogue with original upstream sources: | Template | Purpose | | --- | --- | | [Designer](workspaces/designer) | Interfaces, film, video editing, motion, audio review and marketing | -| [Engineering](workspaces/engineering) | Portable engineering skills and Pi-native tooling | +| [Compound Engineering](workspaces/compound-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 @@ -65,7 +66,8 @@ allagents workspace init ./designer \ ``` Read each template's prerequisites first. Skill installation is separate from -media software, service authentication and paid generation. Engineering and +media software, service authentication and paid generation. Compound Engineering +(formerly the `engineering` workspace) and Finance were copied from the AllAgents examples; CLI-specific examples remain in that repository. diff --git a/workspaces/README.md b/workspaces/README.md index b16c747..b3c478c 100644 --- a/workspaces/README.md +++ b/workspaces/README.md @@ -8,7 +8,8 @@ repository; the CLI and client adapters live in | Workspace | Purpose | | --- | --- | | [Designer](designer) | Interfaces, film, editing, motion, audio review and marketing | -| [Engineering](engineering) | Portable engineering skills and Pi-native tools | +| [Compound Engineering](compound-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: @@ -18,7 +19,7 @@ allagents workspace init ./designer \ --from allagentsdev/agent-plugins/workspaces/designer ``` -Engineering and Finance were copied from the AllAgents +Compound Engineering (formerly `engineering`) and Finance were copied from the AllAgents [engineering](https://github.com/allagentsdev/allagents/tree/782ffc9/examples/workspaces/engineering) and [finance](https://github.com/allagentsdev/allagents/tree/782ffc9/examples/workspaces/finance) examples. Their workspace declarations are unchanged; their documentation points @@ -26,5 +27,5 @@ to the copies maintained here. The CLI repository's existing examples remain available for users of those earlier URLs. Templates describe dependencies; they do not grant credentials, provider access -or permission to spend money. Engineering includes Pi-native packages and +or permission to spend money. Compound Engineering includes Pi-native packages and explicit setup commands: read its trust and installation instructions first. diff --git a/workspaces/engineering/.allagents/workspace.yaml b/workspaces/compound-engineering/.allagents/workspace.yaml similarity index 100% rename from workspaces/engineering/.allagents/workspace.yaml rename to workspaces/compound-engineering/.allagents/workspace.yaml diff --git a/workspaces/engineering/README.md b/workspaces/compound-engineering/README.md similarity index 97% rename from workspaces/engineering/README.md rename to workspaces/compound-engineering/README.md index 1e07c33..2410120 100644 --- a/workspaces/engineering/README.md +++ b/workspaces/compound-engineering/README.md @@ -1,4 +1,4 @@ -# Engineering +# Compound Engineering One project workspace with portable engineering skills and Pi-native tools. The portable sources install into `.agents/skills/` through the `universal` @@ -38,8 +38,8 @@ Save trust for the actual target directory **before** AllAgents attempts native installation: ```sh -mkdir engineering-demo -cd engineering-demo +mkdir compound-engineering-demo +cd compound-engineering-demo pi ``` @@ -84,14 +84,14 @@ Then initialize and install the stack: ```sh allagents workspace init . \ - --from allagentsdev/agent-plugins/workspaces/engineering + --from allagentsdev/agent-plugins/workspaces/compound-engineering allagents plugin list pi list pi ``` From a local repository checkout, replace `--from` with the absolute path to -`workspaces/engineering`. +`workspaces/compound-engineering`. In the new Pi session, inspect `/subagents-doctor` and the `/skill:ce-` command completions. Confirm the Compound Engineering skills are listed and the question 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..3e57955 --- /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 [Compound Engineering workspace](../compound-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. From 3dc026a340d110b3fb41c15a58473ec81c4717db Mon Sep 17 00:00:00 2001 From: Christopher Tso <3115311+christso@users.noreply.github.com> Date: Sat, 14 Nov 2026 09:39:04 +1100 Subject: [PATCH 2/2] fix(workspaces): retain the engineering workspace name --- README.md | 5 ++--- workspaces/README.md | 6 +++--- .../.allagents/workspace.yaml | 0 .../{compound-engineering => engineering}/README.md | 10 +++++----- workspaces/matt-engineering/README.md | 2 +- 5 files changed, 11 insertions(+), 12 deletions(-) rename workspaces/{compound-engineering => engineering}/.allagents/workspace.yaml (100%) rename workspaces/{compound-engineering => engineering}/README.md (97%) diff --git a/README.md b/README.md index dca35be..9632472 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ catalogue with original upstream sources: | Template | Purpose | | --- | --- | | [Designer](workspaces/designer) | Interfaces, film, video editing, motion, audio review and marketing | -| [Compound Engineering](workspaces/compound-engineering) | Portable engineering skills and Pi-native tooling | +| [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 | @@ -66,8 +66,7 @@ allagents workspace init ./designer \ ``` Read each template's prerequisites first. Skill installation is separate from -media software, service authentication and paid generation. Compound Engineering -(formerly the `engineering` workspace) and +media software, service authentication and paid generation. Engineering and Finance were copied from the AllAgents examples; CLI-specific examples remain in that repository. diff --git a/workspaces/README.md b/workspaces/README.md index b3c478c..6257d81 100644 --- a/workspaces/README.md +++ b/workspaces/README.md @@ -8,7 +8,7 @@ repository; the CLI and client adapters live in | Workspace | Purpose | | --- | --- | | [Designer](designer) | Interfaces, film, editing, motion, audio review and marketing | -| [Compound Engineering](compound-engineering) | Portable engineering skills and Pi-native tools | +| [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 | @@ -19,7 +19,7 @@ allagents workspace init ./designer \ --from allagentsdev/agent-plugins/workspaces/designer ``` -Compound Engineering (formerly `engineering`) and Finance were copied from the AllAgents +Engineering and Finance were copied from the AllAgents [engineering](https://github.com/allagentsdev/allagents/tree/782ffc9/examples/workspaces/engineering) and [finance](https://github.com/allagentsdev/allagents/tree/782ffc9/examples/workspaces/finance) examples. Their workspace declarations are unchanged; their documentation points @@ -27,5 +27,5 @@ to the copies maintained here. The CLI repository's existing examples remain available for users of those earlier URLs. Templates describe dependencies; they do not grant credentials, provider access -or permission to spend money. Compound Engineering includes Pi-native packages and +or permission to spend money. Engineering includes Pi-native packages and explicit setup commands: read its trust and installation instructions first. diff --git a/workspaces/compound-engineering/.allagents/workspace.yaml b/workspaces/engineering/.allagents/workspace.yaml similarity index 100% rename from workspaces/compound-engineering/.allagents/workspace.yaml rename to workspaces/engineering/.allagents/workspace.yaml diff --git a/workspaces/compound-engineering/README.md b/workspaces/engineering/README.md similarity index 97% rename from workspaces/compound-engineering/README.md rename to workspaces/engineering/README.md index 2410120..1e07c33 100644 --- a/workspaces/compound-engineering/README.md +++ b/workspaces/engineering/README.md @@ -1,4 +1,4 @@ -# Compound Engineering +# Engineering One project workspace with portable engineering skills and Pi-native tools. The portable sources install into `.agents/skills/` through the `universal` @@ -38,8 +38,8 @@ Save trust for the actual target directory **before** AllAgents attempts native installation: ```sh -mkdir compound-engineering-demo -cd compound-engineering-demo +mkdir engineering-demo +cd engineering-demo pi ``` @@ -84,14 +84,14 @@ Then initialize and install the stack: ```sh allagents workspace init . \ - --from allagentsdev/agent-plugins/workspaces/compound-engineering + --from allagentsdev/agent-plugins/workspaces/engineering allagents plugin list pi list pi ``` From a local repository checkout, replace `--from` with the absolute path to -`workspaces/compound-engineering`. +`workspaces/engineering`. In the new Pi session, inspect `/subagents-doctor` and the `/skill:ce-` command completions. Confirm the Compound Engineering skills are listed and the question diff --git a/workspaces/matt-engineering/README.md b/workspaces/matt-engineering/README.md index 3e57955..aeb0749 100644 --- a/workspaces/matt-engineering/README.md +++ b/workspaces/matt-engineering/README.md @@ -7,7 +7,7 @@ Matt Pocock's engineering workflows, installed from the original 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 [Compound Engineering workspace](../compound-engineering) +Matt skill selected in the [Engineering workspace](../engineering) and the helpers these workflows invoke: | Skills | Purpose |