feat(directives): scavenge sweep 2/5 (docs/reports/2026-05-11 + 2026-06-01): 2 directives
Lifted: - profile_first_optimize_second: profile and measure the actual bottleneck before any architectural change (RAG init, not AI SDKs, was the bottleneck) - surface_gaps_at_discovery_not_checkpoint: surface scope gaps and architectural deviations the moment they are discovered, not at a checkpoint (the 'all good!' footnote pattern is bad UX)
This commit is contained in:
@@ -0,0 +1,9 @@
|
||||
# profile_first_optimize_second
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted from `docs/reports/2026-05-11/ai_decoupling_revert_report.md` §"Lessons Learned". The agent decoupled the AI client SDK imports from the main GUI under the assumption that the heavy SDKs caused startup latency; profiling later showed RAG initialization was the actual 5+ second bottleneck. The decoupling work was reverted; the lazy RAG import fix landed instead. The principle generalizes: do not reach for an architectural change until profiling has named the specific bottleneck.
|
||||
**Source:** `docs/reports/2026-05-11/ai_decoupling_revert_report.md:116-121`
|
||||
|
||||
---
|
||||
**Lifted:** 2026-07-03 (scavenge sweep batch 2/5: docs/reports/2026-05-11 + 2026-06-01)
|
||||
@@ -0,0 +1 @@
|
||||
# Profile and measure the actual bottleneck before attempting any architectural change to address it
|
||||
@@ -0,0 +1,9 @@
|
||||
# surface_gaps_at_discovery_not_checkpoint
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted from `docs/reports/2026-06-01/...` references and the explicit "Lessons (Tech Lead Process)" section in `qwen_llama_grok_followup_audit_20260611.md` and "Lessons Learned" in `qwen_llama_grok_followup_session_end_20260611.md`. The Tech Lead completed Phase 1 with a "all good!" checkpoint that hid a deferred-vendor scope gap; the user pushed back: "did you find something that the spec/plan didn't cover and not report it properly?". The correct pattern is to report scope issues immediately when discovered, not buried in a commit body or footnote.
|
||||
**Source:** `docs/reports/2026-06-08/qwen_llama_grok_followup_audit_20260611.md` §"Lessons (Tech Lead Process)" + `docs/reports/2026-06-08/qwen_llama_grok_followup_session_end_20260611.md` §"Lessons Learned (Session-Wide)" item 3
|
||||
|
||||
---
|
||||
**Lifted:** 2026-07-03 (scavenge sweep batch 2/5: docs/reports/2026-05-11 + 2026-06-01)
|
||||
@@ -0,0 +1 @@
|
||||
# Surface scope gaps and architectural deviations the moment they are discovered, not buried in a checkpoint commit
|
||||
Reference in New Issue
Block a user