marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-code-ultimate-guide/machine-readable
History
Florian BRUNIAUX 9c5d030b11 docs: add dual-instance planning pattern (Jon Williams) 
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>
2026-02-04 10:38:10 +01:00
..
claude-code-releases.yaml docs: update Claude Code releases to v2.1.31 2026-02-04 09:59:39 +01:00
cowork-reference.yaml docs: complete Cowork documentation v1.0 (Phase 2) 2026-01-20 11:23:43 +01:00
llms.txt feat: add ecosystem positioning, install script & new commands 2026-01-19 08:42:33 +01:00
README.md refactor: restructure repo into thematic directories v3.1.0 2026-01-13 15:30:02 +01:00
reference.yaml docs: add dual-instance planning pattern (Jon Williams) 2026-02-04 10:38:10 +01:00

README.md

Machine-Readable References

Files optimized for LLM/AI consumption.

Contents

File Description Tokens
reference.yaml Structured index with line numbers for deep dives ~2K
llms.txt Standard LLM context file for repository indexation ~1.5K

Usage

Give Claude Code instant expertise

# Paste into any AI assistant
curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/machine-readable/reference.yaml

Reference in Claude Code

@machine-readable/reference.yaml

Add to system prompts

Include the YAML content in your AI assistant's system prompt for Claude Code expertise.

Back to main README