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>
This commit is contained in:
Florian BRUNIAUX 2026-02-20 15:04:29 +01:00
parent 146d15e958
commit 6d847d24de
14 changed files with 1528 additions and 14 deletions

View file

@ -41,6 +41,16 @@ deep_dive:
rules_code_quality_review: "examples/rules/code-quality-review.md"
rules_test_review: "examples/rules/test-review.md"
rules_performance_review: "examples/rules/performance-review.md"
# Team Configuration at Scale (Profile-Based Module Assembly)
team_ai_instructions_section: "guide/ultimate-guide.md#35-team-configuration-at-scale"
team_ai_instructions_workflow: "guide/workflows/team-ai-instructions.md"
team_ai_instructions_profile_template: "examples/team-config/profile-template.yaml"
team_ai_instructions_skeleton: "examples/team-config/claude-skeleton.md"
team_ai_instructions_sync_script: "examples/team-config/sync-script.ts"
team_ai_instructions_pattern: "profiles YAML + shared modules + skeleton + assembler script"
team_ai_instructions_problem: "N devs × M tools × P OS = fragmented AI instructions"
team_ai_instructions_token_savings: "59% context token reduction (measured, 5-dev team)"
team_ai_instructions_threshold: "Team 5+ devs with multiple AI tools"
# Known Issues & Critical Bugs (verified community reports)
known_issues: "guide/known-issues.md"
known_issues_github_bug: "guide/known-issues.md:16" # GitHub auto-creation bug
@ -716,6 +726,9 @@ deep_dive:
spec_osmani_source: "https://addyosmani.com/blog/good-spec/"
spec_osmani_evaluation: "docs/resource-evaluations/addy-osmani-good-spec.md"
spec_osmani_score: "4/5"
spec_task_granularity: "guide/workflows/spec-first.md:62" # Vertical slices + PRD checklist (Allan Hill, Feb 2026)
spec_prd_checklist: "guide/workflows/spec-first.md:70" # 6-dimension PRD quality checklist
atdd_with_agents: "guide/methodologies.md:180" # ATDD + Gherkin for agentic workflows
commands_table: 10213
shortcuts_table: 10246
troubleshooting: 10372