ad-grill-me

Analyze code and documentation to clarify ambiguous project requirements.

1|Updated May 8, 2026
One-click install
npx skills add https://github.com/alexandremendoncaalvaro/agentic-development --skill ad-grill-me
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-grill-me
Source: https://github.com/alexandremendoncaalvaro/agentic-development/tree/main/.agents/skills/ad-grill-me
Command: npx skills add https://github.com/alexandremendoncaalvaro/agentic-development --skill ad-grill-me

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the ambiguity in project requirements by forcing a structured, codebase-first interview process before any research or implementation begins, preventing wasted effort on poorly defined tasks.

Core Features & Use Cases

  • Codebase-First Validation: Automatically checks existing context and code before asking the user questions.
  • Decision Tree Navigation: Guides the user through complex requirements one branch at a time to ensure clarity.
  • Inline Capture: Integrates directly with domain documentation and ADR processes to ensure decisions are recorded as they are made.
  • Use Case: When a developer has a vague request like "make the user flow better," this skill forces them to define what "better" means, identify the relevant domain objects, and resolve trade-offs before writing a single line of code.

Quick Start

Invoke the ad-grill-me skill to begin a structured interview session for your current fuzzy task.

Frequently Asked Questions about ad-grill-me

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

FAQPage Schema
How do I clarify ambiguous project requirements before starting implementation?

To clarify ambiguous project requirements, you can use a structured, codebase-first interview process that challenges assumptions and captures architectural decisions. This approach analyzes existing documentation and code to define vague requests before any research or coding begins.

What is a codebase-first interview for software architecture decision-making?

A codebase-first interview for software architecture decision-making is a structured process that analyzes existing code and documentation to navigate complex requirement branches. It sharpens vocabulary and ensures decisions are recorded directly within ADR workflows.

How do I capture architectural decisions inline during requirements gathering?

You capture architectural decisions inline during requirements gathering by integrating decision tree navigation directly with domain documentation and ADR workflows. This ensures trade-offs and assumptions are recorded as they are resolved during the interview.

When should I use a structured interview to resolve decision trees in my codebase?

You should use a structured interview to resolve decision trees when you have fuzzy tasks like making a user flow better. It forces you to define what better means, identify domain objects, and analyze existing code before writing a single line of code.

Do I need existing context files and ADR workflows to use a codebase-first interview?

Yes, you need existing domain-specific context files and ADR workflows to ensure consistent project evolution. The interview process requires integration with these workflows to properly challenge assumptions and capture architectural decisions as they are made.

What is the best way to define vague requests like improving user flow without wasted effort?

The best way to define vague requests without wasted effort is to navigate the decision tree one branch at a time. By validating existing context and code first, you resolve trade-offs and sharpen vocabulary before initiating any implementation.