grill-with-docs

Evaluate project plans against CONTEXT.md domain terminology and documented decisions.

Updated Sep 30, 2024
One-click install
npx skills add https://github.com/phillip-hirsch/dotfiles --skill grill-with-docs-phillip-hirsch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/phillip-hirsch/dotfiles/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/phillip-hirsch/dotfiles --skill grill-with-docs-phillip-hirsch

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The grill-with-docs skill addresses the need for deep domain analysis, ensuring that planning is in alignment with established language and decisions within the project.

Core Features & Use Cases

  • Domain Analysis: Encourage alignment of project plans with the established domain language.
  • Term Clarification: Enhance understanding and use of precise terminology in the project context.
  • Documentation Updates: Keep CONTEXT.md and ADRs updated as decisions evolve.

Quick Start

Use the grill-with-docs skill to walk through your plan's implications against the current domain language.

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 project plans against established domain terminology?

Validating project plans against domain terminology involves evaluating proposed plans for consistency with established language and documented decisions. You can assess alignment against your project's CONTEXT.md to identify terminology gaps before implementation.

What is domain analysis in software planning?

Domain analysis in software planning ensures proposed project plans align with established domain language and documented decisions. It evaluates terminology consistency and checks that new plans respect existing CONTEXT.md definitions and architectural decision records.

When do I need to update CONTEXT.md during decision making?

You need to update CONTEXT.md during decision making when project plans evolve beyond established domain terminology or contradict documented decisions. Inline documentation updates keep your domain language synchronized as new decisions are made.

Can I use design validation to check alignment with existing architectural decisions?

Design validation can check alignment with existing architectural decisions by evaluating user-proposed plans against documented ADRs and CONTEXT.md. This process identifies inconsistencies between new proposals and established project decisions.

How do I keep ADRs updated as project decisions evolve?

Keeping ADRs updated as decisions evolve requires suggesting inline documentation updates as part of the planning process. Evaluating proposed plans against existing domain terminology triggers updates to both CONTEXT.md and ADRs when misalignment is detected.

What's the best way to ensure contextual planning respects domain language?

The best way to ensure contextual planning respects domain language is evaluating proposed plans against established CONTEXT.md and documented decisions. This design validation approach surfaces terminology inconsistencies and suggests inline documentation updates during planning.