apt-mcp-agent-setup 1.3.17 → 1.3.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -95,6 +95,26 @@ Before calling `impact_analysis`:
95
95
 
96
96
  ---
97
97
 
98
+ ## 🪜 Code Writing — Laziness Ladder
99
+
100
+ Before writing ANY code, stop at the **first rung** that holds:
101
+
102
+ | Rung | Check | Tool to Use | If Yes → |
103
+ |---|---|---|---|
104
+ | 1. YAGNI | Does this need to exist? | Think first | Skip it, explain why in one line |
105
+ | 2. Reuse | Already in codebase? | `explore_code` | Reuse existing helper/util/pattern |
106
+ | 3. Stdlib | Standard library does it? | Language docs | Use stdlib |
107
+ | 4. Platform | Native platform feature? | — | Use it (CSS > JS, `<input type="date">` > picker lib, DB constraint > app code) |
108
+ | 5. Installed dep | Already-installed dependency? | `explore_code` on package.json/pubspec | Use existing dep. No new deps for what a few lines do |
109
+ | 6. One-liner | Can it be one line? | — | One line |
110
+ | 7. Minimum | Only when above fail | — | Write minimum code that works |
111
+
112
+ **Rule: The ladder runs AFTER understanding the problem. Read the code it touches (`explore_code`), trace the real flow, THEN climb.**
113
+
114
+ **Bug fix rule: Root cause, not symptom.** Grep every caller (`find_callers`), fix the shared function once — not each caller path.
115
+
116
+ ---
117
+
98
118
  ## 🧠 Memory Conventions — When to Save & Read
99
119
 
100
120
  ### When to SAVE (`remember`)
@@ -192,6 +192,9 @@ Every user request must pass through the Socratic Gate before ANY implementation
192
192
 
193
193
  ### Clean Code (Global Mandatory)
194
194
  - **Code**: Concise, direct, no over-engineering. Self-documenting.
195
+ - **Laziness Ladder**: Before writing code, stop at the first rung that holds: YAGNI → Reuse existing → Stdlib → Native platform → Installed dep → One-liner → Minimum viable. The ladder runs AFTER understanding the problem.
196
+ - **Bug Fix**: Root cause, not symptom. Grep every caller, fix the shared function once.
197
+ - **No Bloat**: No unrequested abstractions, no scaffolding "for later", deletion > addition, fewest files.
195
198
  - **Testing**: Mandatory. Pyramid (Unit > Int > E2E) + AAA Pattern.
196
199
  - **Performance**: Measure first. Adhere to current Core Web Vitals standards.
197
200