# Stop Writing Specs. Let Claude Do It.

Source: https://www.youtube.com/watch?v=WHsRYkwR_YY
Recap page: https://rapidrecap.app/video/WHsRYkwR_YY
Generated: 2026-01-02T15:01:42.518+00:00

---
## Quick Overview

The speaker demonstrates a highly effective, iterative specification-driven development process where Claude AI, utilizing the AskUserQuestionTool, refines a minimal feature specification (a text-to-image generator) through detailed questioning, leading to a comprehensive technical specification document before actual implementation begins.

**Key Points:**
- The process starts with a minimal specification (SPEC.md) for a text-to-image generator using the Google Gemini API.
- Claude AI is instructed to interview the user using the AskUserQuestionTool to flesh out technical details, UI/UX, concerns, and tradeoffs.
- Key decisions covered include API key management (user-provided in UI), deployment target (Pure client-side SPA), image layout (1x4 horizontal row), and technology stack (Vanilla HTML/CSS/JS).
- The iterative questioning process resulted in 26 detailed questions covering areas like error handling, UI state management, and API request format.
- The final specification document, generated through continuous refinement, detailed architecture, implementation steps, and expected behavior.
- The speaker successfully implements a feature (dark mode toggle) based on the generated specification, demonstrating the efficacy of this method.
- The final UI showcases the generated images (astronauts) with a clean, minimal aesthetic, validating the entire specification process.

![Screenshot at 00:17: The initial prompt instructing Claude to read the SPEC.md file and interview the user in detail using the AskUserQuestionTool until the specification is complete.](https://ss.rapidrecap.app/screens/WHsRYkwR_YY/00-00-17.jpg)

**Context:** The video introduces a methodology for building large software features by starting with a minimal specification (SPEC.md) and then leveraging an AI agent, Claude, equipped with a specialized tool called AskUserQuestionTool. This tool enables Claude to act as an interviewer, asking in-depth, non-obvious questions across technical, design, and implementation domains to collaboratively build a complete and robust specification document before any code is written.

## Detailed Analysis

The speaker outlines his preferred method for building substantial features: specification-driven development facilitated by Claude AI using the AskUserQuestionTool. He begins with a minimal spec for a text-to-image generator utilizing the Gemini API, requiring four sequential image generations. Claude then conducts an in-depth interview, asking questions across multiple categories like UI/UX, API integration, API key management, and image layout. For instance, the AI questioned how to handle partial failures (rate limits), how sequential generations should appear to the user, and how to manage the API key (decided to be user-provided in the UI). After answering 26 detailed questions, a comprehensive specification was generated, covering technical architecture (pure client-side SPA, Vanilla JS), API integration details (Gemini 2.5 Flash API), and specific UI/UX behaviors (e.g., dark mode implementation). The speaker then demonstrates the initial implementation, showing a clean UI that successfully generates four images of an astronaut, confirming the detailed specification was sufficient for a functional product.

### Initial Specification & Tool Usage

- Started with a minimal spec for a text-to-image generator using Gemini API
- Instructed Claude to use AskUserQuestionTool for in-depth interviewing
- This iterative refinement process yields a comprehensive specification document.

### Key Specification Areas Covered

- API Key Management (user-provided in UI, persisted in localStorage)
- Architecture (Pure client-side SPA, HTML/CSS/JS only)
- Image Layout (1x4 horizontal row, desktop only)
- Error Handling (Partial failures show successful images immediately with retry buttons).

### Dark Mode Implementation

- A subsequent iteration involved implementing user-toggleable dark mode with three-way switching (Light/Dark/System) persisted via localStorage
- This required defining specific aesthetic directions for dark mode (e.g., soft background, subtle borders).

### Demonstration & Results

- The speaker demonstrated the resulting application, showing a clean, minimalist UI that correctly generated four high-quality astronaut images based on the refined specification.

### Iterative Refinement Cycle

- The overall workflow involves creating an initial spec, using Claude's questioning tool to iterate and refine all technical and design decisions, and finally, implementing the product based on the resulting detailed document.

![Screenshot at 00:04: Speaker introducing the concept of starting with a specification and asking Claude how to derive initial specs.](https://ss.rapidrecap.app/screens/WHsRYkwR_YY/00-00-04.jpg)
![Screenshot at 00:17: Screen showing the prompt instructing Claude to read the SPEC.md and interview the user in detail using the AskUserQuestionTool.](https://ss.rapidrecap.app/screens/WHsRYkwR_YY/00-00-17.jpg)
![Screenshot at 01:25: The initial specification document in VS Code, detailing the Gemini API call structure and initial requirements.](https://ss.rapidrecap.app/screens/WHsRYkwR_YY/00-01-25.jpg)
![Screenshot at 03:35: Claude asking a detailed question about API key management options \(User-provided in UI selected\).](https://ss.rapidrecap.app/screens/WHsRYkwR_YY/00-03-35.jpg)
![Screenshot at 06:11: The final running application displaying four generated images of an astronaut in space, validating the specification.](https://ss.rapidrecap.app/screens/WHsRYkwR_YY/00-06-11.jpg)