docs: add RPI workflow, changelog fragments, smart-suggest hook + LLM variance

- guide/workflows/rpi.md (new): Research → Plan → Implement, 3-phase pattern
  with explicit GO gates, slash command templates, worked example
- guide/workflows/changelog-fragments.md (new): per-PR YAML fragment enforcement,
  3-layer system (CLAUDE.md rule + UserPromptSubmit hook + CI gate)
- examples/hooks/bash/smart-suggest.sh (new): UserPromptSubmit behavioral coach,
  3-tier priority (enforcement/discovery/contextual), ROI logging
- guide/core/known-issues.md: LLM Day-to-Day Performance Variance section,
  4 root causes (probabilistic inference, MoE routing, infra, context sensitivity)
- guide/workflows/README.md: added RPI entry + quick selection row
- machine-readable/reference.yaml: added entries for changelog_fragments, smart_suggest
- CHANGELOG.md: [Unreleased] entries for all 4 new items
- IDEAS.md: prompt-caching MCP plugin research note (testing in progress)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-03-13 16:22:57 +01:00
parent 13efb5a774
commit b6ce1ef72f
8 changed files with 1251 additions and 0 deletions

View file

@ -106,6 +106,13 @@ deep_dive:
rpi_phase3_implement: "guide/workflows/rpi.md:237" # Step-gate pattern + failure protocol
rpi_slash_commands: "guide/workflows/rpi.md:281" # /rpi:research /rpi:plan /rpi:implement templates
rpi_vs_other_workflows: "guide/workflows/rpi.md:391" # Comparison table: RPI vs dual-instance vs spec-first
# Changelog Fragments Workflow
changelog_fragments_workflow: "guide/workflows/changelog-fragments.md" # Per-PR YAML fragments, 3-layer enforcement
changelog_fragments_claude_rule: "guide/workflows/changelog-fragments.md:26" # CLAUDE.md rule for autonomous fragment creation
changelog_fragments_hook: "guide/workflows/changelog-fragments.md:88" # UserPromptSubmit 3-tier hook (enforcement/discovery/contextual)
changelog_fragments_ci: "guide/workflows/changelog-fragments.md:169" # Independent CI migration check job
# Smart-Suggest Hook
smart_suggest_hook: "examples/hooks/bash/smart-suggest.sh" # UserPromptSubmit behavioral coach, 3-tier priority, ROI logging
# Template Installation
install_templates_script: "scripts/install-templates.sh"
# Session management