grill-with-docs
Per-story grilling that stress-tests your plan against the project's domain model, sharpens terminology, and writes CONTEXT.md/ADRs inline as decisions crystallise. Run it when designing a business user story before slicing it into work.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-12
- Stars
- ★ 20
- Forks
- 7
01 前言 Front Matter
- name
- grill-with-docs
- description
- Per-story grilling that stress-tests your plan against the project's domain model, sharpens terminology, and writes CONTEXT.md/ADRs inline as decisions crystallise. Run it when designing a business user story before slicing it into work.
03 SKILL.md 正文
Call the Skill tool twice, for grilling (the interview method) and domain-modeling (the glossary + ADR discipline). Together they are the session: grill one decision at a time down the design tree, and write CONTEXT.md/ADRs inline as terms and decisions land. Everything about how to grill and what to write lives in those two skills — this skill only adds where the session runs and what comes next.
Branch placement
This session writes versioned context files (CONTEXT.md, ADRs). Before the first file write, land on the integration branch for this business user story — not on develop or a stray feature/*:
- Branch
integration/<business-ref>-<slug>from up-to-datedevelop(create it if absent). Name it after the business user story from the business backlog (its reference + a slug) — you're at the grilling step, before/to-spec, so the branch is NOT named after the spec/technical ticket (it doesn't exist yet). Seedocs/agents/business-backlog.mdfor where the business backlog lives. - The grilling output lands here.
/to-specthen synthesises the spec;/to-ticketspushes this branch and bases the sub-tickets on it;ready-for-agentsub-tickets auto-merge back into the integration branch (after a green local check), and theintegration -> developmerge stays human.
See the git-flow skill for the full integration-branch workflow.
Next step
When shared understanding is reached and the docs are written, signpost the next step: /to-spec to synthesise the spec on the technical backlog from this grilling output. Guided, not gated — name the step, don't force it.
04 同仓库更多 Skills
to-tickets
Break a plan, spec, or the current conversation into vertical-slice tickets on the technical backlog, each declaring its blocking edges — text in one file per ticket locally, or native blocking links on GitHub/GitLab.
to-spec
Turn the current conversation into a spec and publish it to the technical backlog — no interview, just synthesis of what you've already discussed.
implement
Implement a spec or set of tickets by orchestrating a tdd role, an independent code-review role, and an agentic-tests role in a loop until build, tests, and the Feature Path are green with no blocking finding.