Claude Code Spec-Based Workflow

Source: https://x.com (tweet) Author: unknown (Claude Code user) Date: 2025-2026

Summary

Workflow for using Claude Code on large features: start with a minimal spec or prompt, ask Claude to interview you using AskUserQuestion tool to build a complete spec, then start a new session to execute the spec. Two-phase approach: spec first, implementation second.

Key Claims

  • Two-phase approach: (1) spec-building session, (2) implementation session
  • Claude uses AskUserQuestion tool to interview the developer for requirements
  • New session per phase — prevents context contamination between phases
  • Works best for large features where requirements are unclear upfront

Connection to Other Sources

Complements How to Build an Agent and Context Engineering from Manus. The spec-first approach is a form of context pre-engineering.

Concepts