fe28f89574
New: interactive configurator at cc.bruniaux.com/context/ that generates a personalized CLAUDE.md starter kit based on team size, stack, and current setup. Multi-step flow (profile, current state, stack, results) with maturity scoring (Level 1-5), copy-to-clipboard artifacts, localStorage persistence. Guide content: - guide/core/context-engineering.md (1,188 lines, 8 sections): context budget, 150-instruction ceiling, modular architecture, team assembly, ACE pipeline, quality measurement, context reduction techniques - examples/context-engineering/ (10 templates): assembler.ts, profile-template.yaml, skeleton-template.md, canary-check.sh, ci-drift-check.yml, eval-questions.yaml, context-budget-calculator.sh, rules/knowledge-feeding.md, rules/update-loop-retro.md - tools/context-audit-prompt.md (543 lines): 8-dimension scoring /100 Navigation: guide/README.md, machine-readable/reference.yaml (24 new entries) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
82 lines
4.2 KiB
YAML
82 lines
4.2 KiB
YAML
# Developer Profile Template
|
|
# Customize and save as: .claude/profiles/<your-name>.yaml
|
|
# Run: ts-node assembler.ts --profile .claude/profiles/<your-name>.yaml
|
|
#
|
|
# This profile drives context assembly: it selects which shared modules to include,
|
|
# sets preferences that can be referenced by modules, and allows per-developer overrides
|
|
# without touching the shared module files.
|
|
#
|
|
# Naming convention: use lowercase, no spaces. Example: alice.yaml, bob-ml.yaml
|
|
|
|
profile:
|
|
name: "developer-name" # Used in assembled CLAUDE.md header
|
|
role: "fullstack" # frontend | backend | fullstack | devops | ml
|
|
seniority: "mid" # junior | mid | senior | staff
|
|
tools:
|
|
primary_lang: "typescript" # typescript | python | rust | go | java | kotlin
|
|
frontend: "react" # react | vue | angular | svelte | none
|
|
backend: "node" # node | fastapi | actix | gin | spring | rails
|
|
database: "postgres" # postgres | mysql | mongodb | redis | sqlite
|
|
cloud: "aws" # aws | gcp | azure | none
|
|
test_framework: "vitest" # vitest | jest | pytest | go-test | cargo-test
|
|
style:
|
|
verbosity: "concise" # verbose | concise | minimal
|
|
# verbose: include rationale in explanations, add inline comments liberally
|
|
# concise: explain when not obvious, comment only complex logic
|
|
# minimal: no unsolicited explanation, comments only on public APIs
|
|
comment_style: "inline" # none | inline | jsdoc
|
|
# none: no comments generated
|
|
# inline: short // comments on complex lines
|
|
# jsdoc: full JSDoc/docstring blocks on all public functions
|
|
test_coverage: "required" # none | optional | required
|
|
# none: no tests generated unless explicitly asked
|
|
# optional: generate tests on request or for complex logic
|
|
# required: always generate tests alongside new functions
|
|
|
|
# Modules are markdown files in .claude/modules/ that contain focused rule sets.
|
|
# The assembler concatenates them in order to build the final CLAUDE.md.
|
|
# Use subdirectories to organize by domain (e.g., frontend/, backend/, shared/).
|
|
modules:
|
|
include:
|
|
# Core — always include these
|
|
- shared/core-rules.md # General coding standards
|
|
- shared/git-conventions.md # Commit format, branch naming, PR requirements
|
|
- shared/security-rules.md # Input validation, secret handling, dependency policy
|
|
|
|
# Role-specific — uncomment what applies
|
|
# Frontend
|
|
# - frontend/react-patterns.md # Component structure, hooks, state management
|
|
# - frontend/accessibility.md # WCAG requirements, ARIA patterns
|
|
# - frontend/css-conventions.md # CSS modules, utility classes, design tokens
|
|
|
|
# Backend
|
|
# - backend/api-design.md # REST conventions, error formats, versioning
|
|
# - backend/database-patterns.md # Query patterns, migrations, indexing
|
|
# - backend/auth-patterns.md # JWT, OAuth, session management
|
|
|
|
# DevOps
|
|
# - devops/ci-cd.md # Pipeline conventions, deployment gates
|
|
# - devops/docker-patterns.md # Dockerfile standards, compose conventions
|
|
# - devops/observability.md # Logging format, metric naming, tracing
|
|
|
|
# ML
|
|
# - ml/model-evaluation.md # Evaluation methodology, bias checks
|
|
# - ml/experiment-tracking.md # MLflow/W&B conventions, artifact naming
|
|
# - ml/data-pipeline.md # Data validation, transformation patterns
|
|
|
|
exclude:
|
|
[]
|
|
# Explicitly exclude modules from the base set (e.g., if shared/security-rules.md
|
|
# has a section that conflicts with your team's approach):
|
|
# - shared/security-rules.md
|
|
|
|
overrides:
|
|
# Per-developer additions — appended after all modules as a "Personal Rules" section.
|
|
# Keep these minimal: shared knowledge belongs in shared modules, not personal overrides.
|
|
# Good use cases: personal debugging preferences, tooling shortcuts, IDE-specific notes.
|
|
custom_rules:
|
|
[]
|
|
# Examples:
|
|
# - "Always run `pnpm typecheck` before declaring a TypeScript task complete"
|
|
# - "Use zod for all external input validation, not manual type guards"
|
|
# - "When unsure about a regex, use a named capture group and add a comment"
|