Danijel Martinek
a372eeda86
docs/glossary.md is the shared vocabulary source for humans and agents.
Resolves every cross-cutting term used in this repo (feature, use case,
manifest, slice, conformance, dispatch, ...) with one-sentence definitions,
relationships, and flagged ambiguities. Linked from CLAUDE.md "Read First"
and AGENTS.md preamble so every session loads it early.
.claude/skills/ installs four mattpocock skills adapted to this monorepo:
- to-prd: writes to docs/work/prds/ with the repo's PRD frontmatter +
merged user-stories/implementation/testing sections
- grill-with-docs: points at docs/decisions/ + docs/glossary.md; adds
feature.manifest.ts + conformance-rule cross-checks
- grill-me: minor — adds pnpm work / fallow / manifest shortcuts
- handoff: adds the repo's specific don't-duplicate artifacts list
Also fixes a missed "Phase-1" residual in CLAUDE.md's Read First section.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
19 lines
1.3 KiB
Markdown
19 lines
1.3 KiB
Markdown
---
|
|
name: grill-me
|
|
description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when the user wants to stress-test a plan, get grilled, or mentions "grill me". Use grill-with-docs instead when the plan should cross-check against ADRs + glossary + manifests.
|
|
---
|
|
|
|
Interview the user relentlessly about every aspect of this plan until you reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
|
|
|
|
Ask the questions **one at a time**, waiting for feedback before continuing.
|
|
|
|
If a question can be answered by exploring the codebase, explore the codebase instead. Useful shortcuts in this repo:
|
|
|
|
- `pnpm work status` — current epics and ready stories
|
|
- `cat packages/<feature>/src/feature.manifest.ts` — declared use cases / events / audits
|
|
- `ls docs/decisions/` — ADRs by number
|
|
- `pnpm fallow` — dead exports, dupes, complexity hotspots
|
|
- grep manifests across all features: `grep -r "publishes:" packages/*/src/feature.manifest.ts`
|
|
|
|
When grilling pulls in ADR / glossary / manifest cross-checks and you want to update those docs inline, switch to `grill-with-docs` instead.
|