9c5d030b11
Add vertical separation pattern (planner/implementer) as complement to horizontal scaling (Boris pattern). ## Changes **Main guide (ultimate-guide.md)**: - New Section 9.17.1: "Alternative Pattern: Dual-Instance Planning" (~350 lines) - When to use (solo devs, spec-heavy, $100-200/month) - Setup instructions (2 Claude instances, Plans/ directory) - Complete workflow (5 phases: planning, review, implementation, verification, archive) - Comparison table (Boris horizontal vs Jon vertical scaling) - Cost analysis (2 instances vs correction loops) - Agent-ready plan best practices - Limitations and tips **Workflow file (workflows/dual-instance-planning.md)**: - Full workflow guide (~750 lines) - Complete example (JWT auth implementation) - Plan template (ready to copy-paste) - Cost breakdown and decision matrix - Troubleshooting and bash aliases **References updated**: - machine-readable/reference.yaml: 15 new entries - dual_instance_planning, dual_instance_workflow, etc. - Line numbers, source attribution, metadata - guide/workflows/plan-driven.md: Link in See Also section - README.md: Update evaluation count (46 → 47) **Evaluation documented**: - docs/resource-evaluations/jon-williams-dual-instance-pattern.md - Full methodology (fetch, analyze, challenge, fact-check) - Score progression (2-3/5 → 4/5 after technical-writer challenge) - Gap analysis, comparison, integration rationale ## Source LinkedIn post by Jon Williams (Product Designer, UK) Date: 2026-02-03 URL: https://www.linkedin.com/posts/thatjonwilliams_ive-been-using-cursor-for-six-months-now-activity-7424481861802033153-k8bu Context: Transition from Cursor (6 months) to Claude Code with Opus 4.5 Pattern: Vertical separation (Claude Zero: planning/review, Claude One: implementation) Distinction: Orthogonal to Boris pattern (vertical vs horizontal scaling) ## Stats - Lines added: ~1,400 - Files modified: 4 - Files created: 2 (workflow + evaluation) - References added: 15 (reference.yaml) - Evaluation score: 4/5 (High Value) - Integration time: ~2.5 hours Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| design-to-code.md | ||
| dual-instance-planning.md | ||
| exploration-workflow.md | ||
| iterative-refinement.md | ||
| pdf-generation.md | ||
| plan-driven.md | ||
| README.md | ||
| search-tools-mastery.md | ||
| skeleton-projects.md | ||
| spec-first.md | ||
| task-management.md | ||
| tdd-with-claude.md | ||
| tts-setup.md | ||
Claude Code Workflows
Step-by-step guides for common development patterns with Claude Code.
🔍 Search & Discovery
Search Tools Mastery ⭐ NEW
Master the art of code search by combining rg, grepai, Serena & ast-grep
Learn when to use each tool, how to combine them for maximum efficiency, and real-world workflows including:
- Exploring unknown codebases
- Large-scale refactoring
- Security audits
- Framework migrations
- Performance optimization
Key Topics:
- Quick decision matrix
- Complete feature comparison
- 5 combined workflows
- Performance benchmarks
- Common pitfalls
- Tool selection cheatsheet
🎯 Development Workflows
Plan-Driven Development
Structure complex tasks with planning mode before execution.
When to use: Multi-step features, architectural changes, uncertainty about approach
TDD with Claude
Test-Driven Development workflow: write tests first, implement after.
When to use: Critical functionality, regression prevention, API design
Spec-First Development
Write specifications before code for better requirements clarity.
When to use: Team collaboration, complex features, documentation-first projects
Iterative Refinement
Improve code through multiple refinement cycles.
When to use: Quality improvements, performance optimization, code cleanup
Skeleton Projects ⭐ NEW
Use existing battle-tested repositories as scaffolding for new projects.
When to use: Starting new projects, standardizing team patterns, rapid prototyping from proven foundations
🎨 Design & Content
Design to Code
Convert design mockups (Figma, wireframes) into working code.
When to use: Frontend development, UI implementation, design system work
PDF Generation
Generate professional PDFs using Quarto/Typst with Claude Code.
When to use: Reports, documentation, whitepapers, technical documents
TTS Setup
Configure Text-to-Speech for Claude Code responses (Agent Vibes integration).
When to use: Audio feedback, accessibility, hands-free coding
🔬 Code Exploration
Exploration Workflow
Systematically explore and understand unfamiliar codebases.
When to use: New projects, legacy code, documentation gaps
Related: See Search Tools Mastery for advanced multi-tool exploration strategies.
Quick Selection Guide
| Your Situation | Recommended Workflow |
|---|---|
| New to codebase | Exploration Workflow + Search Tools Mastery |
| Complex feature | Plan-Driven or Spec-First |
| Need reliability | TDD with Claude |
| Large refactoring | Search Tools Mastery |
| UI implementation | Design to Code |
| Code quality | Iterative Refinement |
| New project from template | Skeleton Projects |
| Documentation | PDF Generation |
| Audio feedback | TTS Setup |
Contributing
New workflow ideas? Open an issue or PR in the main repository.
Workflow Template Structure:
- Title & Purpose
- When to Use
- Prerequisites
- Step-by-Step Guide
- Real-World Examples
- Common Pitfalls
- Related Workflows
Last updated: January 2026