grill-with-docs

Validate project plans against domain models and architectural documentation.

Updated May 21, 2026
One-click install
npx skills add https://github.com/caiohbfurtado/apac-web --skill grill-with-docs-caiohbfurtado
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/caiohbfurtado/apac-web/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/caiohbfurtado/apac-web --skill grill-with-docs-caiohbfurtado

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents architectural drift and terminology confusion by forcing your project plans to align with existing domain models, ADRs, and established project language.

Core Features & Use Cases

  • Domain Alignment: Challenges your proposed changes against the existing glossary and architectural decisions.
  • Documentation Sync: Automatically updates CONTEXT.md and ADRs as decisions are finalized during the session.
  • Use Case: When planning a new feature, use this skill to ensure your proposed terminology matches the existing codebase and that your design choices are consistent with previous architectural decisions.

Quick Start

Initiate a grilling session to review the proposed plan for the new billing module against the current project context.

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 existing domain models and architectural documentation?

To validate project plans against existing domain models, you can use an interviewing process to resolve dependencies and enforce architectural constraints. This ensures your proposed changes remain consistent with established terminology and technical rigor.

How does architectural documentation sync work when planning new features?

Architectural documentation sync works by automatically updating project files like CONTEXT.md and ADRs in real-time. As you finalize design choices during a planning session, the documentation is updated to reflect the new architectural decisions.

What is the best way to prevent domain terminology confusion and architectural drift?

The best way to prevent terminology confusion and architectural drift is to stress-test proposed plans against existing project glossaries and ADRs. This forces new features to align with the established domain language and architectural constraints.

Do I need access to repository codebase and documentation to enforce domain-driven design constraints?

Yes, you need access to repository documentation and the codebase to verify domain relationships. This access is required to effectively enforce architectural constraints and ensure technical rigor during the planning validation process.

Can I use this approach to check if my proposed terminology matches an existing codebase?

Yes, you can check if proposed terminology matches an existing codebase by challenging your proposed changes against an established project glossary. This domain alignment process ensures your new feature plans use consistent project language.

When should I not use automated architectural decision records validation for project planning?

You should not use automated architectural decision records validation if your project lacks existing domain models, ADRs, or established project language. The validation process requires pre-existing documentation to effectively challenge and align new plans.