Lessons Digest

This is the always-read lessons layer: a short distillation of the entries this project has paid for more than once.

The full corpus is .aidlc/guidance/lessons.md — every lesson from every completed instance, in full, registered as an on-demand layer. Read it when a phase has a reason to: you are touching a mechanism a past instance got wrong, a gate keeps failing for reasons nobody can name, or you are running consolidation. It is not read on entry because it grows by design — up to three lessons per instance — and an always-read file that only grows is a tax on every future session.

This digest is lossy on purpose. It is not a summary of the corpus and does not replace it. Nothing here is a directive: lessons are historical observations, and one may describe code that has since been rewritten. Check the source before acting on an entry that names a file, a function, or a flag.

Entries

No entries yet. This file is a stub until the first consolidation run fills it.

The aidlc-retrospective skill regenerates the entries below this heading when it runs in consolidation mode, keeping the whole file small enough to stay resident. What it leaves out is confirmed edit by edit — a digest is a lossy read of a safety mechanism, so omissions are agreed, never silent.