AGENT SKILL

matt-mode

Use when the user invokes matt-mode to clarify requirements, discuss design, map decisions, or prepare implementation through specs and tickets.

License 许可
MIT
所属仓库
pascalandy/skills
最近更新
2026-11-15
Stars
★ 0
Forks
1

01 前言 Front Matter

kind
dev
name
matt-mode
description
Use when the user invokes matt-mode to clarify requirements, discuss design, map decisions, or prepare implementation through specs and tickets.

02 资源文件 25

03 SKILL.md 正文

Matt mode

Matt-mode prepares implementation. It produces planning artifacts and implementation-ready context; it does not implement software, including through subagents.

Use Matt Pocock's procedures under their original names. Read local adaptations, then the procedure for the requested result. Resolve bundled paths relative to this file. Load supporting files only when the selected procedure needs them.

The procedure bodies and their supporting files are imported from a pinned upstream revision. Follow their full instructions within the local adaptations and the caller's scope. Keep routing follow-ups for the same effort until the user changes task or mode. Stop at the requested result.

Choose a procedure

Recognize spaced names such as "to spec", "to tickets", "grill with docs", and "domain modeling" as their hyphenated route names. A caller can resolve this package and read one named procedure without changing its own workflow or activating every route.

Name Use when Read
grill-me Sharpen an idea through conversation grill-me
grill-with-docs Interview while recording resolved domain terms and qualifying ADRs grill-with-docs
domain-modeling Define or challenge domain vocabulary and relationships domain-modeling
codebase-design Design a module's interface, depth, or seam codebase-design
wayfinder Chart or resume decisions across sessions while the route is uncertain wayfinder
to-spec Synthesize existing context into a spec, including design and testing decisions to-spec
to-tickets Break defined work into verifiable deliveries and blocking edges to-tickets

For an architecture review of existing code, including improve-codebase-architecture, direct the caller to code-review-mode instead of running a Matt-mode procedure.

When upstream asks to call a Skill by one of these names, read that procedure here. A slash command is an instruction pointer, not a required executable or separate installed skill.

Shared skills

Resolve research, grilling, and writing-for-agents from the active catalog or the sibling skill directories in a source or compiled installation. Read each skill's SKILL.md before using it. Their canonical upstream bodies live in those packages, not here.

  • research gathers primary-source evidence, including when the user says matt-mode ; research
  • grilling supplies the interview used by grill-me, grill-with-docs, and Wayfinder
  • writing-for-agents supplies the writing discipline when producing a spec, tickets, a map, or another artifact an agent will consume

If a required dependency is unavailable, name it and the affected step. Continue independent work without claiming the missing procedure ran.

Choose the order

Small, obvious changes can go directly to the execution workflow. Use grill-me for discussion, or grill-with-docs when documentation is requested. Domain modeling and codebase design apply within relevant work, not as compulsory preliminary stages.

Research supplies missing facts through source inspection and primary documentation. Wayfinder manages uncertainty that exceeds one session; defined work does not need a map just because it is large.

For a substantial planning effort, the usual sequence is discussion, then to-spec, then to-tickets. Skip completed stages. A to-spec request synthesizes the available context without restarting the interview.

Finish with the requested spec, plan, tickets, or readiness assessment. When implementation or a runnable prototype is requested, direct the user to poteto-mode with the existing context. Read the PStack handoff when preparing that context; completion of planning does not start execution.

Maintenance

Read lineage and updating to refresh upstream content. Use acceptance cases when changing routing or local adaptations. Neither is needed during ordinary work.

04 同仓库更多 Skills