Developer Guide

Everything you need to extend, contribute to, or deeply understand lessons-learned.

In this guide

Page	What it covers
Architecture	Component map, pipeline stages, design decisions
Data Model	Full schema for lessons, manifest, config, and candidates
Adapters	Cross-agent support — tool name normalization, output format differences
Testing	Test framework, tiers, fixtures, coverage targets
Contributing	Setup, code quality gates, PR guidelines

Quick orientation

The plugin has three conceptual layers:

┌─────────────────────────────────────────────────────────┐
│  STORAGE  — data/lessons.json, lesson-manifest.json     │
├─────────────────────────────────────────────────────────┤
│  PIPELINE — hooks/ (inject) + scripts/ (CLI + scanner)  │
├─────────────────────────────────────────────────────────┤
│  PROTOCOL — hooks.json wiring + agent output formats    │
└─────────────────────────────────────────────────────────┘

If you're investigating a bug in injection → Architecture + Adapters.

If you're changing the data shape → Data Model.

If you're writing tests → Testing.

If you're adding support for a new agent → Adapters.