marketing-shibata50/claude-code-ultimate-guide

Florian BRUNIAUX 6d847d24de docs: add Profile-Based Module Assembly pattern (Section 3.5)

- Section 3.5 "Team Configuration at Scale" in ultimate-guide.md:
  profiles YAML + shared modules + skeleton + assembler script;
  59% context token reduction measured on 5-dev production team;
  includes CI drift detection, 5-step replication guide, trade-offs
- New workflow: guide/workflows/team-ai-instructions.md (6 phases,
  scaling thresholds, troubleshooting table)
- New templates: examples/team-config/ (profile-template.yaml,
  claude-skeleton.md, sync-script.ts)
- reference.yaml: 9 new entries for team_ai_instructions_*
- README: templates count 161 → 164, date Feb 19 → Feb 20
- CHANGELOG [Unreleased]: resource evaluations (AGENTS.md ETH Zürich
  4/5, Sylvain Chabaud 3/5), spec-first Task Granularity section,
  methodologies ATDD expansion

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-02-20 15:04:29 +01:00

4.1 KiB

Raw Blame History

title

description

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

Team AI Instructions

Scale CLAUDE.md across a multi-developer, multi-tool team with profile-based module assembly.

When to use: Team 5+ devs, multiple AI tools (Claude Code + Cursor/Windsurf), mixed OS

🎨 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
Team AI instructions	Team AI Instructions
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: February 2026

4.1 KiB Raw Blame History