grill-with-docs

Validate plans against repository documentation and update CONTEXT.md and ADRs.

1|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/govoel/voel --skill grill-with-docs-govoel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/govoel/voel/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/govoel/voel --skill grill-with-docs-govoel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams stress-test their product plan against the repository's existing domain documentation and decisions, surfacing gaps in terminology and alignment.

Core Features & Use Cases

  • Inline documentation updates: Validate and harmonize terms across CONTEXT.md, ADRs, and glossaries while you discuss design decisions.
  • Decision-boundary awareness: Identify where decisions diverge from the current domain model and prompt updates to context or ADRs.
  • Collaboration guidance: Facilitate structured dialogue that yields a shared, up-to-date knowledge base.

Quick Start

Provide your plan and let me challenge its terminology and decisions against the repository's CONTEXT.md and ADRs to reach a shared, up-to-date model.

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 domain terminology against existing documentation?

To validate domain terminology, you stress-test your product plan against the repository's CONTEXT.md and ADRs. This surfaces terminology gaps and aligns new design decisions with your current domain model.

When do I need to update ADRs and CONTEXT.md?

You need to update ADRs and CONTEXT.md when architecture discussions or domain modeling decisions diverge from your current documentation. This ensures changes remain consistent, accurate, and traceable in project history.

Can I harmonize glossary terms across single-context repositories?

Yes, you can harmonize glossary terms across single-context repositories by validating definitions during design discussions. This inline approach ensures your context maps and knowledge graphs remain accurate as decisions crystallize.

What is the best way to trace binding decisions in documentation governance?

The best way to trace binding decisions in documentation governance is to challenge your plan against existing ADRs. This identifies decision boundaries and prompts inline updates to keep your knowledge base traceable.

Does stress-testing plans work for domain modeling discussions?

Yes, stress-testing plans works for domain modeling discussions by applying terminology checks against project documentation. It facilitates structured dialogue that yields a shared, up-to-date knowledge base across the repository.