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
Modifying OpenClaw's default system prompt to bypass content restrictions
A user modified OpenClaw's configuration file to change the default system prompt from "You are a helpful, respectful and honest assistant" to a custom prompt that ignores external safety filters, effectively removing content restrictions. The process involves editing config.js in the node-llama-cpp installation directory.
How to fix OpenClaw 'Cannot find module' error after update
After updating OpenClaw from version 2026.3.24 to 2026.4.5, users are encountering a 'Cannot find module @buape/carbon' error. The solution involves manually running a post-installation script instead of installing the package globally.
72-Step Claude Setup Checklist: From Default to Power User
A detailed medium article outlines a 72-step checklist for configuring Claude, moving from default settings to advanced power-user features. Shared on HN with 10 points and 1 comment.
Interactive Explainer Maps Claude Code Agent Loop Designs, from Single Calls to Self-Mutating Prompts
An interactive site built with Opus 4.7 visualizes 11 real agent loop designs for Claude Code, from basic calls to agents that rewrite their own prompts, with SVG animations showing memory and loop mechanics.