Cite the rule, do not copy it
A meaning change produces a complete list of code that needs a new review.
Why
Agents leave old rule text in comments, tests, and tool descriptions after the source changes.
Installation
Terminal
npx --yes @principle-driven/[email protected] add cite-dont-copyThe CLI uses your prefix, assigns the next local number, and updates your agent index. CLI installation guide ↗
The Markdown preview uses the catalog token. Your installed file uses its local token.
# PDD-05 — Cite the rule, do not copy it
Token: PDD-05
Version: v1
## Rule
When code depends on a principle, cite its versioned token. State only the local fact that the code needs.
Do not copy the full principle into comments. The principle file remains the authority.
### Exceptions
Commit messages and merged review threads are history. They do not need citation reviews.
## Rationale
Copied rule text can remain after its source changes. A pinned citation keeps the rule in one place and exposes dependent code for review.
## History
- v1 (2026-08-24): Published to prevent copied rule text and unversioned citations from hiding dependencies after meaning changes.