principle-encode-lessons-in-structure git:20260908.ec65ed5A

Immutable. This exact content never changes and is served at /api/v1/blob/d7b2b6594f136ae4.

---
name: principle-encode-lessons-in-structure
description: Turn recurring guidance into a type, lint, test, metadata flag, generator, runtime check, or skill so the system carries the lesson. Use when when the same corrective instruction appears more than once.
---
# Encode Lessons in Structure

## Trigger

When the same corrective instruction appears more than once.

## Rule

Turn recurring guidance into a type, lint, test, metadata flag, generator, runtime check, or skill so the system carries the lesson.

## Application

1. Name the concrete decision this principle changes.
2. Apply the rule to that decision, not as a decorative citation.
3. Prefer evidence from the current repository/runtime over generic preference.
4. If the principle conflicts with an explicit user constraint, keep the constraint and state the tradeoff.