Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
1 change: 1 addition & 0 deletions workspaces/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
28 changes: 28 additions & 0 deletions workspaces/matt-engineering/.allagents/workspace.yaml
Original file line number Diff line number Diff line change
@@ -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
73 changes: 73 additions & 0 deletions workspaces/matt-engineering/README.md
Original file line number Diff line number Diff line change
@@ -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.
Loading