skills.rest
flaviogragnolati
flaviogragnolatiCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Validate domain models and update CONTEXT.md and ADRs during planning.

Updated Jun 26, 2025
Search Tags:#documentation#domain model#project validation#real-time updates#terminology clarification
One-click install
npx skills add https://github.com/flaviogragnolati/coco --skill grill-with-docs-flaviogragnolati
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/flaviogragnolati/coco/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/flaviogragnolati/coco --skill grill-with-docs-flaviogragnolati

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you validate and refine your project's domain model and documentation (CONTEXT.md, ADRs) by challenging your plans, clarifying terminology, and updating documentation in real-time.

Core Features & Use Cases

  • Domain Model Validation: Stress-test your project's plan against the existing domain model.
  • Terminology Clarification: Improve the precision of your project's terminology.
  • Documentation Update: Update CONTEXT.md and ADRs inline as decisions crystallize.
  • Use Case: Imagine you are working on a new feature. Use this Skill to discuss your plan with the AI, which will challenge your assumptions, suggest terminology, and update your documentation as you go.

Quick Start

Start a grill-with-docs session by asking, "How should we implement the new feature?"

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 domain model against existing project documentation?▼

Validate a domain model by challenging your project plan against existing codebase documentation, clarifying terminology, and updating CONTEXT.md and ADRs in real-time as decisions crystallize. This process stress-tests assumptions and refines project terminology.

What is the best way to update CONTEXT.md and ADRs during feature planning?▼

Update CONTEXT.md and ADRs inline by discussing your feature plan with an AI that challenges assumptions and proposes alternatives. Documentation updates happen in real-time as terminology is clarified and architectural decisions are finalized.

Can I use this approach to refine project terminology and clarify domain concepts?▼

Refine project terminology by analyzing the existing codebase and documentation to propose precise domain concepts. The AI challenges your current vocabulary, suggesting more accurate terminology and updating references immediately.

Does domain model validation require analyzing the codebase before starting?▼

Domain model validation requires analyzing the existing codebase and documentation to effectively challenge user plans. This prerequisite analysis enables the AI to propose alternatives and discuss architectural trade-offs accurately.

When should I not use real-time documentation updates for architectural decisions?▼

Avoid real-time documentation updates if your project lacks a defined domain model or existing ADRs to analyze. The approach requires an established codebase and documentation baseline to effectively challenge plans and propose alternatives.

Related Skills

Explore More Software Engineering Skills→
cameronraysmithcameronraysmith
14

event-modeling-brownfield

Reverse engineer an Event Model from a brownfield codebase into EventCatalog-ready documentation.

Community
Advanced
malinskibeniaminmalinskibeniamin
3

grill-with-docs

Update ADRs and CONTEXT.md to align architectural decisions with context documentation.

Community
Advanced
purefunctionspurefunctions

do-grill-with-docs

Validates design decisions against ADRs and CONTEXT.md during interactive Q&A sessions.

Community
Intermediate
chaimtchaimt

adlc-spec-analyze

Analyze spec, plan, tasks, and implementation artifacts for cross-artifact inconsistencies.

Community
Advanced