grill-with-docs

Align project plans with domain terminology and update CONTEXT.md and ADRs.

138|6|Updated Jan 25, 2025
One-click install
npx skills add https://github.com/yamcodes/arkenv --skill grill-with-docs-yamcodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/yamcodes/arkenv/tree/main/skills/grill-with-docs
Command: npx skills add https://github.com/yamcodes/arkenv --skill grill-with-docs-yamcodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grills your plan against the repo's domain language, forcing alignment with the existing docs and decisions to prevent drift.

Core Features & Use Cases

  • Relentless questioning of every aspect of the plan to surface dependencies and assumptions.
  • Live updates to docs/CONTEXT.md and ADRs inline as decisions crystallize, ensuring the repository language stays current.
  • Guided exploration of the codebase to validate terminology and capture decisions inline.

Quick Start

Initiate a grill-with-docs session to stress-test your plan against the repository's domain model and update CONTEXT.md and ADRs 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 align my project plan with existing domain terminology and prevent documentation drift?

Aligning your project plan with domain terminology requires iteratively questioning assumptions and cross-referencing the existing domain model. This process enforces precise language updates to docs/CONTEXT.md and ADRs inline, preventing documentation drift by capturing decisions as they crystallize.

What is an ADR and when do I need to update it during software planning?

An ADR is an Architecture Decision Record that captures how and why specific technical choices are made. You need to update ADRs during software planning when decisions crystallize through iterative questioning, ensuring your repository maintains a coherent, discoverable record of decisions.

How do I surface hidden dependencies and assumptions in my software architecture plan?

Surface hidden dependencies and assumptions by applying relentless questioning to every aspect of your plan against the repository's domain language. This guided exploration validates your terminology against existing documentation and forces misalignments into the open.

Does this approach work for validating terminology against an existing domain model?

Validating terminology against an existing domain model is the core mechanism of this approach. It guides exploration of the codebase and existing documentation to enforce precise language, resolving misalignments between your plan and the project's established domain terms.

What is the best way to maintain CONTEXT.md files during the development process?

The best way to maintain CONTEXT.md files is through live, inline updates as decisions crystallize during planning sessions. This ensures the repository language stays current and produces a coherent record of how domain terminology and architectural decisions evolve.

When should I not use ADRs for documenting software decisions?

You should avoid using ADRs for trivial or non-architectural decisions that do not impact the domain model. ADRs are intended to capture explicit, significant decisions through iterative alignment, ensuring a discoverable record without cluttering the repository with minor technical choices.