feat: add grill skill merging domain-modeling #16

Merged
alexion merged 1 commits from feat/grill-skill into main 2026-07-25 16:11:04 -04:00
Owner

Merges the interview-driven grill and the domain-modeling discipline into a single, model-invokable grill skill (full absorption — no standalone domain-modeling).

What it does

  • Relentless interview: one question at a time, plain text, each with options + a recommendation and rationale, and a context quote when the question turns on existing material.
  • Agent-agnostic mode selection: discovers .agents/CONTEXT.md then .claude/CONTEXT.md; that directory owns adr/ too; asks if both exist.
    • Domain Modeling Mode — maintains the glossary inline (CONTEXT-FORMAT.md) and offers ADRs under the three-gate test (hard to reverse / surprising / real trade-off).
    • Free Mode — no context file, no doc side effects.
    • Clarification — offers to create a glossary when the plan introduces project-specific vocabulary.
  • Model-invokable so other skills can use it as a backbone.
  • Never begins implementation without an explicit user instruction, even when a caller skill invoked it.

Files

  • skills/grill/SKILL.md
  • skills/grill/CONTEXT-FORMAT.md (verbatim from the former domain-modeling)

Verification

  • nix build .#grill passes; skill is discovered with no name collision; both files land at the derivation root.
  • Test-driven by a subagent on a "grill me on this plan" prompt; the four real friction points it surfaced (undefined mode threshold, missing glossary-creation path, an inaccurate line, and a mode-selection contradiction) were fixed.
Merges the interview-driven `grill` and the `domain-modeling` discipline into a single, model-invokable `grill` skill (full absorption — no standalone `domain-modeling`). ## What it does - Relentless interview: one question at a time, plain text, each with **options + a recommendation and rationale**, and a **context quote** when the question turns on existing material. - **Agent-agnostic mode selection**: discovers `.agents/CONTEXT.md` then `.claude/CONTEXT.md`; that directory owns `adr/` too; asks if both exist. - **Domain Modeling Mode** — maintains the glossary inline (`CONTEXT-FORMAT.md`) and offers ADRs under the three-gate test (hard to reverse / surprising / real trade-off). - **Free Mode** — no context file, no doc side effects. - **Clarification** — offers to create a glossary when the plan introduces project-specific vocabulary. - **Model-invokable** so other skills can use it as a backbone. - **Never begins implementation** without an explicit user instruction, even when a caller skill invoked it. ## Files - `skills/grill/SKILL.md` - `skills/grill/CONTEXT-FORMAT.md` (verbatim from the former `domain-modeling`) ## Verification - `nix build .#grill` passes; skill is discovered with no name collision; both files land at the derivation root. - Test-driven by a subagent on a "grill me on this plan" prompt; the four real friction points it surfaced (undefined mode threshold, missing glossary-creation path, an inaccurate line, and a mode-selection contradiction) were fixed.
alexion added 1 commit 2026-07-25 16:10:42 -04:00
Combine the interview-driven grill and the domain-modeling discipline into a
single model-invokable grill skill, so other skills can reach it as a backbone.

- One question at a time, each with options plus a recommendation and rationale,
  and a context quote when it turns on existing material.
- Agent-agnostic mode selection: discover .agents/CONTEXT.md then
  .claude/CONTEXT.md, and drive Domain Modeling, Free, or Clarification.
- Domain Modeling Mode maintains the glossary inline (CONTEXT-FORMAT.md) and
  offers ADRs under the three-gate test.
- Never begin implementation without an explicit user instruction, even when a
  caller skill invoked grill.
alexion force-pushed feat/grill-skill from 685909d237 to ea8e2c50bc 2026-07-25 16:10:42 -04:00 Compare
alexion merged commit ea8e2c50bc into main 2026-07-25 16:11:04 -04:00
alexion deleted branch feat/grill-skill 2026-07-25 16:11:04 -04:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: alexion/skills#16