Florian BRUNIAUX
89084c89ec
docs: integrate Anthropic 2026 Agentic Coding Trends Report
...
Integration strategy: diffusion transversale (~450 lines across 5 files)
instead of monolithic Section 9.21 (rejected after technical-writer review).
Evaluation: 4/5 score (high value, but lacks concrete code examples)
Source: https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf
Changes:
1. Created evaluation report (docs/resource-evaluations/)
- Summary, gap analysis, challenge results, fact-check
- Justification: validation industrie, benchmarks, anti-patterns
2. Modified guide/ultimate-guide.md (3 insertions, ~270 lines)
- Section 9 intro: Industry context encadré with adoption data
- Section 9.17 Multi-Instance: ROI benchmarks ($500-1K/month validation)
- Section 9.11: Enterprise Anti-Patterns section (5 detailed patterns)
3. Modified guide/workflows/agent-teams.md (~80 lines)
- Industry adoption data with case studies
- Timeline: 3-6 months, success rates by phase
- Real-world performance metrics (Fountain 50%, Rakuten 7h, TELUS 500K hours)
4. Modified machine-readable/reference.yaml (~40 lines)
- Added agentic_trends_2026_* metadata section
- Research data, case studies, benchmarks, anti-patterns references
5. Modified README.md (~8 lines)
- Added "Research & Industry Reports" section
- Link to Anthropic report with evaluation details
Stats validated: 60% AI usage, 0-20% full delegation, 67% more PRs/day,
27% new work, 7 case studies (Fountain, Rakuten, CRED, TELUS, Legora, Zapier, Augment).
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-09 17:18:52 +01:00
Florian BRUNIAUX
191ff42741
release: v3.23.4 - Agent Anti-Patterns & Scope-Focused Refactoring
...
Major conceptual refactoring based on Dex Horty's principle:
"Subagents are not for anthropomorphizing roles, they are for controlling context"
### Added (1 new section)
- Agent Anti-Patterns section (§9.17, line 3662)
- Wrong vs Right table (anthropomorphizing vs context control)
- When to use agents (context isolation, parallel processing, scope limitation)
- When NOT to use agents (fake teams, roleplaying, mimicking org structure)
### Changed (18 files, 200+ lines)
- Section rename: "Split-Role Sub-Agents" → "Scope-Focused Agents"
- Agent definitions: "Specialized role" → "Context isolation tool"
- 8 custom agent examples refactored (guide + examples/agents/)
- 10+ prompt examples with explicit scope boundaries
- 4 workflow files updated (agent-teams, TDD, iterative refinement)
- Terminology replacements:
* "Specialized agents" → "Scope-focused agents"
* "Expert personas" → "Context boundaries"
* "Multi-domain expertise" → "Multi-scope analysis"
### Fixed
- Methodologies: Clarification note for BMAD role-based naming
Breaking change: Conceptual shift from role-based to scope-based agent usage.
All examples now demonstrate context isolation instead of persona simulation.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-09 10:29:59 +01:00
Florian BRUNIAUX
9805b615c5
docs: correct Agent Teams architecture + add session handoff template
...
## Agent Teams Architecture Corrections
Based on official sources (Addy Osmani blog, Feb 2026):
**Major changes**:
- Add mailbox system documentation (peer-to-peer messaging)
- Correct communication model: not only team lead synthesis
- Update diagrams to show peer-to-peer arrows
- Clarify context isolation vs message sharing
- Add 7 sections with source attribution
- Add documentation update note (2026-02-09)
**Key correction**: Agents communicate via mailbox system (direct
peer-to-peer + team lead synthesis), not only hierarchical reporting.
**Files modified**:
- guide/workflows/agent-teams.md (+72 -19): 7 major corrections
- CHANGELOG.md: Document session handoff template addition
- guide/architecture.md: Architecture clarifications
- guide/ultimate-guide.md: Cross-references updates
**Sources**:
- https://addyosmani.com/blog/claude-code-agent-teams/
- Perplexity research (sonar-reasoning-pro, Feb 2026)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-09 09:23:41 +01:00
Florian BRUNIAUX
b48d95c024
feat: add agent/skill quality audit tooling + Grenier evaluation
...
AUDIT TOOLING (3 templates):
- Command: /audit-agents-skills (quick project audits)
- 16-criteria framework (Identity 3x, Prompt 2x, Validation 1x, Design 2x)
- Weighted scoring: 32 pts (agents/skills), 20 pts (commands)
- Production grading (A-F, 80% threshold)
- Fix mode with actionable suggestions
- Skill: audit-agents-skills (advanced audits)
- 3 modes: Quick (top-5), Full (all 16), Comparative (vs templates)
- JSON + Markdown output for CI/CD
- Scoring grids: criteria.yaml (externalized for reuse)
EVALUATION:
- Grenier agent/skill quality (3/5 - Moderate Value)
- Gap: 29.5% deploy without evaluation (LangChang 2026)
- Integration: Created audit command + skill + criteria
- Industry context: 18% cite agent bugs as top challenge
DOCUMENTATION:
- Guide refs: 2 strategic call-outs (after Agent/Skill validation)
- CHANGELOG: New "Added" section + evaluation details
- README: Templates 106→107, Evaluations 49→24 (count corrections)
- reference.yaml: 10 new audit entries + updated counts
SYNC:
- Landing index.html: Templates 107, Evals 24, Quiz 257
- Landing examples/index.html: Templates 107
FILES: 14 changed, 4148 insertions (+1250 lines new audit content)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-07 15:40:18 +01:00
