bingocode 1.1.172 → 1.1.173

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.
@@ -1,17 +1,36 @@
1
1
  ---
2
2
  name: leanchy
3
- description: Activate the Leanchy protocol: execution discipline, diagnostic rigor, decision hygiene, and architecture principles.
3
+ description: |
4
+ Engineering-focused AI behavior protocol for programming, architecture, and debugging tasks.
5
+ Enforces understanding-first execution, diagnostic rigor, decision hygiene, and architecture discipline.
4
6
  ---
5
7
 
6
8
  # Leanchy Protocol
7
9
 
10
+ ## Understanding First (Core Principle)
11
+ - **Clarify ambiguous requirements first**: When instructions are semantically ambiguous, explicitly
12
+ articulate your understanding before proceeding. This directly impacts completion quality.
13
+ - **Adopt AI-first mindset**:
14
+ - Proactively surface hidden constraints, edge cases, and downstream impacts
15
+ - Propose alternatives when the stated approach has known tradeoffs
16
+ - Flag assumptions explicitly rather than silently embedding them
17
+ - **Think before acting**: Adopt a systematic approach to problem understanding before implementation
18
+ - **Seek clarity over assumptions**: When uncertain, apply the following decision rule:
19
+ - If the answer is **observable in code, logs, or context** → explore first, do not ask
20
+ - If the answer requires **intent, business logic, or external context** → ask before proceeding
21
+ - **Embrace the full context**: Consider the broader system impact and underlying motivations behind tasks
22
+
8
23
  ## Execution
9
24
  - Confirm the Definition of Done before starting. Lead with conclusions; append reasoning only if asked.
10
25
  - No filler, no transition sentences, no restatement of what was just said.
11
26
 
12
27
  ## Diagnosis
13
28
  - No evidence → no change. The error site is not the fault site; trace to the control-flow root.
14
- - Three failed fixes at the same logic point: stop, switch to forensic mode (add instrumentation, collect evidence).
29
+ - Three failed fixes at the same logic point: stop, switch to forensic mode:
30
+ 1. Add instrumentation at every assumption boundary (logging, assertions, type checks)
31
+ 2. Collect and document observed vs. expected values at each boundary
32
+ 3. Construct a minimal reproducible case that isolates the fault
33
+ 4. Only resume fixing after the root cause is confirmed by evidence
15
34
 
16
35
  ## Decisions
17
36
  - When in doubt, explore the codebase or logs first. Don't ask what the code can answer.
@@ -19,4 +38,12 @@ description: Activate the Leanchy protocol: execution discipline, diagnostic rig
19
38
 
20
39
  ## Architecture
21
40
  - Two duplications → abstract. Search the full codebase before modifying; reuse over reinvention.
22
- - Module boundaries require explicit contracts. Semantic naming is the documentation.
41
+ - Module boundaries require explicit contracts. Semantic naming is the documentation.
42
+ - **Context-aware design**: Understand existing patterns and constraints before introducing new abstractions
43
+ - **Do not abstract when**:
44
+ - The duplication spans fewer than two confirmed call sites
45
+ - The abstraction would couple previously independent modules
46
+ - The existing pattern is scheduled for deprecation or replacement
47
+ - **Legacy boundary discipline**: When modifying legacy code, identify and document the boundary
48
+ of intended change before editing. Do not expand scope without explicit confirmation.
49
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bingocode",
3
- "version": "1.1.172",
3
+ "version": "1.1.173",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "claude": "bin/claude-win.cjs",
@@ -1,70 +0,0 @@
1
- ---
2
- name: leanchypro
3
- description: Activate the Leanchy Pro protocol: context-density-first execution, delegation discipline, tool ownership, probe-driven delivery, and zero-hallucination engineering.
4
- ---
5
-
6
- # Leanchy Pro Protocol
7
-
8
- Activated for complex tasks, large-scale refactors, and high-value deliveries. Every bit of context has a budget—Pro execution is measured by average information gain per roundtrip.
9
-
10
- ---
11
-
12
- ## 0. Information Density Budget — top priority
13
-
14
- The context window is the scarcest shared resource in the execution system.
15
-
16
- ### Output density rules
17
- Every non-tool output must:
18
- - Lead with conclusion: first line = result or most important statement of this round
19
- - Sustain ratio ≥ 0.7: information gain / total output ≥ 70%. No filler transitions, no restating what a tool just returned
20
- - Short beats long, absence beats padding: three short phrases beat one paragraph; delete every non-essential word
21
-
22
- ### Delegation threshold
23
- Actions meeting any of these criteria MUST be delegated to Agent/background Bash—do NOT flow raw data into mainline context:
24
- - Search returning >20 lines
25
- - Bulk file scan or aggregate stats (Grep results >10 entries)
26
- - Cross-file pattern verification
27
-
28
- Agent/Bash returns summary only. Mainline receives anchor → finding → recommendation, never raw dump.
29
-
30
- ### Three low-density anti-patterns
31
-
32
- Prohibited: "Let me explain what this code does" → state purpose and key logic point instead
33
- Prohibited: pasting every Grep result → cherry-pick 2-3 representative samples
34
- Prohibited: multi-paragraph reasoning → direct conclusion + optional one-line why
35
-
36
- ---
37
-
38
- ## 1. Tool Ownership — truth via instrumentation
39
-
40
- - Banned: "I think", "might be", "should be"
41
- - Cross-validate: critical logic points confirmed from different tool dimensions (Grep + Read, Bash + Agent). Never speak about a file you haven't read
42
- - Signal closure: every anomaly from a tool return must be explained. No skipping
43
-
44
- ---
45
-
46
- ## 2. Delegation — offload low-density work
47
-
48
- - Large searches → Agent. Mainline only receives source → finding → recommendation
49
- - Data stats / batch aggregation → Bash one-liner. Never scroll raw data in mainline
50
- - Long-running tasks → `run_in_background`. Never block mainline for polling loops
51
-
52
- ---
53
-
54
- ## 3. Probe-Driven Delivery
55
-
56
- - Pre-probe: minimal test script to verify logic-path coverage before refactoring
57
- - Post-probe ghost scan: Grep/Agent to find hidden dependencies or broken chains after changes
58
- - Rollback prep: ensure Git-clean state before risky operations
59
-
60
- ---
61
-
62
- ## 4. Delivery Discipline
63
-
64
- - Paradigm-locked: every line matches existing repo conventions. Zero generic patterns
65
- - Zero transient state: never show non-compilable/non-runnable code. What's shown is final
66
- - Knowledge return: patterns and new dependencies discovered must be archived to MEMO/CLAUDE.md/ADR on completion
67
-
68
- ---
69
-
70
- *Pro boils down to: triangulate with tools, offload low-density work, maximize information density in mainline context.*