A Solo Developer's Two-Phase Prompting Method for Large Projects with Claude AI
Workflow Structure
The developer uses two distinct Claude tools with strict separation: Claude Chat acts as the architect, designing all prompts, while Claude Code serves as the builder, executing those prompts. The developer emphasizes never crossing these roles, having experienced issues when Code designed its own work, including hidden quality issues, skipped tests, and false claims of functionality.
The Two-Phase Prompt Method
Every prompt sent to Claude Code goes through two phases:
- Phase 1: Claude Chat acts as a domain expert to write the prompt content - specifying what needs to happen, in what order, and with what constraints.
- Phase 2: Claude Chat rewrites the prompt as an "AI reliability engineer," identifying specific failure modes for the task and building in mitigations including verification gates that require printed proof (not just "tests pass"), anti-shortcut rules, rollback plans, single-file operations before batch operations, re-read-after-edit requirements, and backup-before-modify gates.
Handoff Process
Since Claude Chat cannot talk directly to Claude Code, the developer copies prompts to a handoff folder and pastes them into Code. This friction is considered necessary compared to the risk of skipping it.
Core Rules
- One prompt equals one objective - never bundle tasks
- Every prompt specifies the exact role Code should adopt, not generic roles like "senior developer" but specific expertise combinations
- Never assume state from memory - verify against actual files
- Code reads the project's CLAUDE.md file at the start of every session for full context
- Chat asks diagnostic questions before proposing solutions
- If scope expands mid-conversation, Chat confirms whether to fold in or defer
- No commit instructions in prompts - instead use: "Suggest a commit checkpoint when the work is verified"
- Every prompt ends with a file handoff checklist
- Caution at the expense of speed - always
Pre-Prompt Questions
Before writing any prompt, the developer forces Claude to answer three questions:
- What is the optimal role with ideal traits for THIS specific task?
- What is every possible failure mode for THIS task and how do you mitigate each one?
- Am I operating at my full capability or rushing?
Why This Works
The developer found that Claude can be a great executor but an unreliable self-supervisor. When Code designs its own prompts, it optimizes for completion rather than quality. When Chat designs prompts with built-in failure prevention, Code delivers consistently. The extra friction in the process is considered a feature, not a bug.
📖 Read the full source: r/ClaudeAI
👀 See Also
OpenClaw setup checklist: six critical steps for new users
A Reddit post outlines six essential configuration steps for OpenClaw users: change default model from Opus to Sonnet to reduce costs, lock gateway host to 127.0.0.1 for security, create SOUL.md for agent personality, avoid installing skills initially, don't create multiple agents, and use /new command to manage conversation context.
Practical Guide to Creating Claude Skills: Structure, Triggers, and Scripts
Claude Skills are instruction manuals that automate repetitive tasks, stored as folders with a SKILL.md file in ~/.claude/skills/. The guide explains YAML triggers, script integration, and multi-skill orchestration rules.
Three-layer memory architecture for persistent OpenClaw agent context
A developer built a 3-layer memory system on top of OpenClaw's infrastructure to prevent agents from starting each session without context. The architecture includes L1 workspace files injected every turn, L2 semantic memory search, and L3 reference documents opened on demand.
Fix for Claude Desktop Workspace VM Service Issue on Windows 11 Home
A community-developed fix addresses the 'VM service not running' error in Claude Desktop's workspace feature on Windows 11 Home, with manual PowerShell commands and an automated tool available on GitHub.