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
Florian BRUNIAUX
fd17414abb
docs: add AI productivity research, trust calibration, and exploration workflow
...
## New Content
### Trust & Verification (ultimate-guide.md)
- Section 1.7 "Trust Calibration: When and How Much to Verify" (~155 lines)
- Research-backed stats (ACM, Veracode, CodeRabbit, Cortex.io)
- Verification spectrum by code type
- Solo vs Team strategies with workflow diagrams
- "Prove It Works" checklist
- New pitfall: "Trust AI output without proportional verification"
- CLAUDE.md size guideline: 4-8KB optimal, >16K degrades coherence
### AI Productivity (learning-with-ai.md)
- Section "The Reality of AI Productivity" (~55 lines)
- Productivity curve phases (Wow Effect → Targeted Gains → Plateau)
- High-gain vs low/negative-gain task categorization
- Team success factors
- Productivity trajectory table by pattern (Dependent/Avoidant/Augmented)
- 5 new sources (GitHub, McKinsey, Stack Overflow, Uplevel, DORA)
### Session Limits (architecture.md)
- "Session Degradation Limits" section
- Turn limits (15-25), token thresholds (80-100K)
- Success rates by scope (1-3 files: ~85%, 8+ files: ~40%)
### Exploration Workflow
- NEW: guide/workflows/exploration-workflow.md
- Anti-anchoring prompts, 3-5 approaches pattern
- iterative-refinement.md: Script Generation Workflow (3-7 iteration pattern)
- anchor-catalog.md: Anti-Anchoring Techniques, Exploration/Iteration Prompts
### Reference Updates
- adoption-approaches.md: Empirical data section
- reference.yaml: New deep_dive entries, updated line numbers
Sources: MetalBear engineering blog, arXiv studies, Addy Osmani (Jan 2026)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 19:16:33 +01:00
