grill-me-with-docs

Challenge plans against CONTEXT.md, ADRs, and spec documents.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/arthur-debert/dodot --skill grill-me-with-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-me-with-docs
Source: https://github.com/arthur-debert/dodot/tree/main/.agents/skills/grill-me-with-docs
Command: npx skills add https://github.com/arthur-debert/dodot --skill grill-me-with-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you pressure-test a feature or plan against existing documentation, so decisions align with the current domain language and avoid conflicting assumptions.

Core Features & Use Cases

  • Terminology sharpening: Detects vague, overloaded, or conflicting terms and proposes clearer canonical language.
  • Decision validation: Challenges architectural and product choices against CONTEXT.md, ADRs, and the current spec so durable decisions get documented.
  • Documentation updates: Writes or updates glossary entries and ADRs inline when a decision or term is stable enough to capture.
  • Use case: A team is planning a new feature and wants to ensure it fits the established model before implementation starts.

Quick Start

Ask the grill-me-with-docs skill to challenge my plan against the existing docs and surface any glossary or ADR updates I should make.

Frequently Asked Questions about grill-me-with-docs

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

FAQPage Schema
How do I validate a feature plan against existing project documentation?

To validate a feature plan against existing project documentation, you can challenge the plan by reviewing CONTEXT.md, ADRs, and spec documents to surface inconsistencies, ambiguities, and misaligned domain terminology before implementation starts.

What is the best way to keep ADRs and glossary entries aligned during planning?

Keeping ADRs and glossary entries aligned during planning involves pressure-testing architectural choices against the current domain language, detecting vague or overloaded terms, and writing inline documentation updates when decisions or terms are stable enough to capture.

Can I use CONTEXT.md to detect conflicting terminology in a feature spec?

Yes, you can use CONTEXT.md to detect conflicting terminology in a feature spec by challenging the spec against established domain language, identifying overloaded or ambiguous terms, and proposing clearer canonical language for the codebase.

How do I record architectural decisions inline when refining a plan?

To record architectural decisions inline when refining a plan, validate the choices against existing ADR history and spec documents, then write or update ADR entries directly when the decision is durable enough to document across the codebase.

When do I need to stress-test a plan against domain language and ADRs?

You need to stress-test a plan against domain language and ADRs when a team is planning a new feature and wants to ensure it fits the established domain model, avoiding conflicting assumptions before implementation begins.

Does this approach work without existing spec or ADR documents?

This approach requires existing spec documents, a glossary, and ADR history to function effectively, as it relies on challenging new plans against these established records to surface inconsistencies and refine terminology.