grill-with-docs

Stress-test decisions against CONTEXT.md and ADRs to surface terminology conflicts.

32|5|Updated Oct 6, 2024
One-click install
npx skills add https://github.com/gilesknap/tpi-k3s-ansible --skill grill-with-docs-gilesknap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/gilesknap/tpi-k3s-ansible/tree/main/.claude/skills/grill-with-docs
Command: npx skills add https://github.com/gilesknap/tpi-k3s-ansible --skill grill-with-docs-gilesknap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grill with docs clarifies mismatches between decisions and the project domain language, helping teams converge on a shared vocabulary and inline governance.

Core Features & Use Cases

  • Domain alignment: Stress-tests decisions against the existing CONTEXT.md and ADRs to surface ambiguities and misinterpretations.
  • Inline documentation updates: Promptly updates CONTEXT.md and ADRs as design decisions crystallize.
  • Governance & collaboration: Encourages disciplined debate and clear, actionable terminology across stakeholders.

Quick Start

Guide the user through a relentless, question-driven session and update CONTEXT.md and ADRs inline as decisions crystallize.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I check if my architecture decisions align with my project's domain language?

You can stress-test decisions against existing CONTEXT.md and ADRs to surface ambiguities and misinterpretations. This domain alignment process clarifies mismatches between your planned architecture and the established project domain language, ensuring shared vocabulary across stakeholders.

How do I update CONTEXT.md and ADRs during a design discussion?

Update CONTEXT.md and ADRs inline as design decisions crystallize during a question-driven session. This inline documentation approach ensures governance artifacts are promptly modified, capturing precise terminology changes while maintaining documentation governance workflows.

What is the best way to surface terminology conflicts in software documentation?

Surface terminology conflicts through a relentless, question-driven governance session that cross-references decisions against existing ADRs and CONTEXT.md. This domain alignment approach identifies domain language mismatches and generates actionable documentation artifacts resolving discrepancies.

Can I use ADRs and CONTEXT.md for inline governance during architectural planning?

Yes, you can use ADRs and CONTEXT.md for inline governance by guiding sessions that stress-test plans against existing documentation. This ensures disciplined debate, surfaces terminology conflicts, and generates precise documentation updates as architectural decisions are made.

When do I need to stress-test plans against existing architecture decisions?

Stress-test plans against existing architecture decisions when your team requires convergent domain language and inline governance. This is crucial when new design choices risk misinterpreting established terminology documented in your CONTEXT.md and ADRs.