skills.rest
InditexTech
InditexTechOFFICIAL
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Surface assumptions and update CONTEXT.md and ADRs inline during architecture reviews.

195|16|Updated Feb 18, 2025
Search Tags:#architecture#documentation#collaboration#adr#design-decisions#context.md#grill
One-click install
npx skills add https://github.com/InditexTech/weavejs --skill grill-with-docs-inditextech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/InditexTech/weavejs/tree/main/code/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/InditexTech/weavejs --skill grill-with-docs-inditextech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams stress-test project plans by surfacing assumptions and updating documentation inline.

Core Features & Use Cases

  • Comprehensive domain-grounded questioning to surface hidden assumptions.
  • Live documentation updates: inline adjustments to CONTEXT.md and ADRs as decisions crystallize.
  • Suitable for architecture reviews, design walkthroughs, and documentation refresh cycles across CONTEXT.md and ADRs.

Quick Start

Begin a guided grilling session by asking a sequence of design questions and updating CONTEXT.md and ADRs in real time 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 surface hidden assumptions during an architecture review?▼

Surface hidden assumptions during architecture reviews by applying domain-grounded questioning to stress-test plans, then capturing decisions through inline updates to existing CONTEXT.md and ADRs.

What is the best way to maintain a single source of truth for design decisions in CONTEXT.md?▼

Maintaining a single source of truth for design decisions in CONTEXT.md involves validating terminology and applying inline adjustments to the documentation as decisions crystallize during design walkthroughs.

Can I use this approach to update Architecture Decision Records in real time?▼

Yes, you can update Architecture Decision Records in real time by running a guided grilling session that asks design questions and applies live inline adjustments to ADR formats as decisions are made.

Does stress-testing documentation require a specific repository structure?▼

Stress-testing documentation relies on your repository's existing docs structure, specifically requiring established CONTEXT.md and ADR formats to enforce a single source of truth through inline updates.

When should I run a documentation refresh cycle for ADRs?▼

Run a documentation refresh cycle for ADRs during architecture reviews or design walkthroughs when you need to validate terminology, surface assumptions, and enforce a single source of truth across project documentation.

Related Skills

Explore More Software Engineering Skills→
JeromyJSmithJeromyJSmith
3

grill-with-docs

Aligns proposed designs and domain terminology with existing CONTEXT.md and ADR documentation via interactive codebase cross-checking.

Community
Advanced
ClyptAIClyptAI

domain-model

Compare project plans against domain models to surface terminology gaps.

Official
Advanced
axiomanticaxiomantic
8

devils-advocate

Identify flaws and surface risks in design documents and decisions.

Official
Advanced
ari-ayvazyanari-ayvazyan
1

grill-with-docs

Guide domain clarification interviews and update CONTEXT.md and ADRs inline.

Community
Advanced