docs(agents): add Laziness Ladder guardrail#56
Merged
Conversation
…eness and External Libraries
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Adds a "Laziness Ladder" — a six-rung decision gate that agents must clear before writing any code. The ladder encodes the YAGNI / prefer-existing-solutions instinct in an explicit, ordered checklist: does it need to exist? stdlib? platform? installed dep? one-liner? only then write. It also bridges two principles that could feel contradictory: the new Laziness Ladder (skip what isn't needed) and the existing Completeness rule (fully finish what you've decided to build). A new paragraph under Completeness makes the sequencing explicit so agents don't use one as an excuse to violate the other.
Summary
### Laziness Ladder (Before Writing Code)subsection under Guardrails, with 6 ordered rungs and a "Lazy, not negligent" carve-out for trust boundaries, security, a11y, and explicitly requested workCompleteness Is Cheapclarifying that the ladder decides whether to build; Completeness decides how thoroughly — sequential, not opposedExternal Librariesintro replaced with a back-reference to rungs 2–4 of the ladder instead of restating the same principle in isolationTest Plan