> ## Documentation Index
> Fetch the complete documentation index at: https://prism.ntecdev.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ADR-3: Lesson scope promotion (L→G) via candidate/promote pipeline

> Add an L→G promotion pipeline. When a project-scope lesson's embedding matches a project-scope lesson from a different phase (or different project) above a simi

<Info>**Status:** `proposed` · **ADR-3** · Filed 2026-04-17</Info>

## Decision

Add an L→G promotion pipeline. When a project-scope lesson's embedding matches a project-scope lesson from a different phase (or different project) above a similarity threshold, auto-create a global candidate via the existing global\_fact\_candidates table. Human promotes or rejects.

## Rationale

The L→G promotion is already implicit in the data: L9 'idempotency via composite key check before insert is the Prism idiom' is structurally identical to Phase 0 config-write patterns but still tagged L-scope. Promotion currently happens in Frank's head. Phase 3 already built the candidate/promote/reject plumbing for memory — reuse it for lessons. This turns the Global Lessons Catalog into an emergent artifact rather than a curated list.

## Alternatives Considered

Introduce an explicit lesson-promotion verb (prism\_promote\_lesson). Keep manual scope assignment forever. Auto-promote only with human confirmation via prism\_ask.