lesson-cluster

Lesson Cluster

Purpose

Apply references/lesson-taxonomy.md deterministically so lessons are grouped, ranked and cited before prose is drafted.

When to use

After asset-identify, before sanitize-check, for every closeout knowledge harvest.

When NOT to Use

• Raw sources still need normalization - use artifact-assemble.
• Assets need reuse scoring or completeness checks - use asset-identify.
• The user asks whether a lesson may be shared or reused - use sanitize-check.
• The user asks for the final knowledge-record narrative - use knowledge-record.

Inputs

asset_shortlist.json with decision_log and retrospective_inputs carried from artifact-assemble.

Steps

1. Run scripts/lesson_cluster.py --input asset_shortlist.json --out lessons_clustered.json.
2. Quote cluster ids, categories, priority scores, evidence ids and citations verbatim.
3. Do not polish any lesson that sanitize-check later flags for personal data or confidentiality.
4. Pass named-person and blame signals through to the Govern step.
5. If the engine exits non-zero (exit 2 prints lesson_cluster: input error: ...; nothing written, including when asset_shortlist.json was edited after asset-identify), stop and report the error; never create clusters manually.

Tools

Run scripts/lesson_cluster.py with the shell tool and read its JSON output with the file-read tool. No connector writes or outbound actions.

Output format

lessons_clustered.json with lesson_clusters[], evidence citations, sensitivity signals and provenance. The engine copies every input key forward and adds (one cluster shown; clusters are sorted by priority_score, highest first):

{
  "lesson_clusters": [{ "cluster_id": "", "category": "<lesson-taxonomy category or unclassified>",
    "priority_score": 0, "review_candidate": false, "evidence_ids": [], "evidence_citations": [],
    "summary_seed": "", "sensitivity_signals": [], "confidence": 0.0,
    "source": "engine:lesson_cluster", "citation": "lesson-taxonomy.md #..." }],
  "provenance": { "engines": ["asset_identify/<engine version>", "lesson_cluster/<engine version>"] }
}