grill-with-docs

Verifies plans and designs against documented domain models and ADRs.

779|80|Updated Jun 20, 2025
One-click install
npx skills add https://github.com/Haohao-end/openagent --skill grill-with-docs-haohao-end
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Haohao-end/openagent/tree/main/api/internal/core/skills/catalog/grill-with-docs
Command: npx skills add https://github.com/Haohao-end/openagent --skill grill-with-docs-haohao-end

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps you find mismatches between a proposal and the project’s documented domain language, boundaries, and recorded decisions.

Core Features & Use Cases

  • Document-driven term convergence: Forces alignment with the terminology and constraints defined in the project documentation (e.g., context files and ADR records).
  • Branch-by-branch interrogation: Probes one question at a time, narrowing uncertainty until a shared understanding is reached.
  • Decision traceability for ADR: Checks whether key decisions have already been documented and pushes updates when they become clear.

Quick Start

Ask the assistant to stress-test your architecture plan against the repository’s domain docs and ADR history, one focused question at a time.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I verify an architecture proposal against existing domain documentation?

You can verify an architecture proposal by stress-testing it against your repository's documented domain language and ADR history to find terminology mismatches and boundary violations. This ensures your plan aligns with the established project context before implementation.

What is the best way to check if a refactor plan conflicts with recorded architecture decisions?

Checking a refactor plan against ADR records identifies conflicts with documented decisions. The process probes your design through stepwise interrogation, pushing updates to your decision traceability logs when newly clarified choices emerge during the review.

How do I align new design terminology with an existing domain model?

Aligning new design terminology requires branch-by-branch interrogation that forces convergence with constraints defined in your context files. It narrows uncertainty one question at a time until your proposal's language matches the documented domain model.

Can I use prompt-based review for refactoring proposals that need consistent terminology?

Yes, prompt-based review supports refactoring proposals by applying stepwise question refinement with dependency-aware follow-ups. This interrogates your design until key decisions are clarified and ensures all terminology aligns with your project documentation.

When do I need to stress-test plans against domain docs?

You need to stress-test plans against domain docs when proposing architectural changes, refactors, or new features that require consistent terminology and decision traceability. This prevents undocumented shifts in your domain boundaries and project language.