grill-with-docs

Interrogate project plans against domain models and update CONTEXT.md and ADRs.

Updated Nov 16, 2022
One-click install
npx skills add https://github.com/kos3nz/dotfiles --skill grill-with-docs-kos3nz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/kos3nz/dotfiles/tree/main/.config/agents/skills/grill-with-docs
Command: npx skills add https://github.com/kos3nz/dotfiles --skill grill-with-docs-kos3nz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

Core Features & Use Cases

  • Relentless interrogation of plan assumptions to surface ambiguities and resolve terminology conflicts.
  • Inline documentation updates: CONTEXT.md and ADRs are revised as decisions crystallize.
  • Guided, question-by-question exploration that reveals dependencies and trade-offs.

Quick Start

Start the grilling session and walk through each decision branch, one question at a time.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stress-test a project plan against existing domain documentation?

To stress-test a project plan against existing domain documentation, you run a guided grilling session that interrogates plan assumptions question-by-question to surface ambiguities and resolve terminology conflicts using your documented domain model.

What is the best way to keep CONTEXT.md and ADRs in sync with planning decisions?

The best way to keep CONTEXT.md and ADRs in sync is to apply inline documentation updates during planning sessions, revising records as decisions crystallize rather than waiting until after the session ends.

How do I resolve terminology conflicts when planning new software features?

You resolve terminology conflicts when planning new features by challenging your plan against the existing domain model through a question-by-question exploration flow that reveals dependencies and enforces terminology alignment.

Can I update architecture decision records while interrogating plan assumptions?

Yes, you can update architecture decision records while interrogating plan assumptions. The grilling process records decisions and ensures ADR documentation stays in sync with the evolving plan as decisions crystallize.

When should I use a question-by-question exploration flow for project planning?

You should use a question-by-question exploration flow for project planning when you need to surface hidden ambiguities, resolve terminology conflicts, and ensure documentation stays aligned with the evolving plan before implementation begins.