grill-with-docs

Challenge proposed plans against domain models and update CONTEXT.md and ADRs.

35|Updated Apr 30, 2025
One-click install
npx skills add https://github.com/pedroscosta/live-state --skill grill-with-docs-pedroscosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/pedroscosta/live-state/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/pedroscosta/live-state --skill grill-with-docs-pedroscosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grilling sessions help teams stress-test a proposed plan against the project's domain model and existing documentation, ensuring alignment with the language and decisions recorded in CONTEXT.md and ADRs.

Core Features & Use Cases

  • Guided, question-by-question session to validate decisions against the codebase and existing docs
  • Inline documentation updates: reflect term choices and decisions directly in CONTEXT.md and ADRs as consensus crystallizes
  • Conversation-driven risk discovery: surface ambiguities and dependencies in domain concepts and architecture

Quick Start

Start a grilling session by outlining the plan, then proceed step-by-step to resolve each decision and update the documentation inline.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I validate a proposed plan against my project's domain model and documentation?

Validating a proposed plan against your domain model involves a guided grilling session that relentlessly challenges your approach question-by-question, resolving ambiguities by surfacing risks and dependencies in your existing documentation.

What is the best way to update CONTEXT.md and ADRs during architectural decision-making?

Updating CONTEXT.md and ADRs during decision-making is handled through conversation-driven grilling sessions that reflect term choices and decisions inline as consensus crystallizes, ensuring language consistency and traceable rationale across the codebase.

How do I resolve domain concept ambiguities when planning a new software feature?

Resolving domain concept ambiguities requires a step-by-step grilling session that stress-tests your proposed approach against existing architecture, driving concrete decisions and updating governance documentation inline.

Can I enforce documentation discipline while exploring a new technical approach?

Enforcing documentation discipline during exploration is achieved by applying a grilling session that updates CONTEXT.md and ADRs inline, ensuring decisions and traceable rationale are recorded directly as they crystallize.

When should I use a grilling session for architectural governance?

A grilling session for architectural governance should be used when you need to stress-test a proposed plan, surface hidden dependencies in your domain model, and ensure alignment with the language recorded in your existing documentation.

Does grill-with-docs work without external dependencies?

The grill-with-docs skill operates entirely without external dependencies, using a guided conversation to challenge plans against your domain model and update CONTEXT.md and ADRs inline during decision-making.