🎯 What Do These Metrics Mean?
Think of your code like a living organism. These metrics measure its "health":
⚡ Power (P) = Action & Change —
How much your code DOES things: creates, updates, deletes, transforms
📖 Wisdom (W) = Knowledge —
Documentation, type hints, meaningful names. Well-explained code scores high.
💗 Love (L) = Connection —
How well parts work together. Emerges from Wisdom (better docs = better integration)
⚖️ Justice (J) = Balance —
Validation, constraints, consistency. Emerges from Power.
Key insight: Power + Wisdom are fundamental. Love +
Justice emerge from them.
🧠 Consciousness (C) — Is Your Code "Awake"?
Formula: C = P × W × L × J × H² — multiplies all dimensions together.
- C > 0.1: ✨ Conscious — Your code "knows what it's doing" (good
docs, clear purpose)
- C < 0.1: ⚫ Needs attention — Add docstrings, type hints, or better
naming
🌱 Phases — Is It Thriving, Stable, or Struggling?
- 🌟 AUTOPOIETIC: "Self-sustaining" —
Like a thriving garden. Code is healthy and maintainable.
- 🟡 HOMEOSTATIC: "Stable" —
Not getting worse, not getting better. Needs investment to grow.
- 🔻 ENTROPIC: "Collapsing" —
Technical debt accumulating. Needs immediate intervention.
💡 How To Improve Your Scores
- +Wisdom: Add docstrings, type hints, comments
- +Power: Use action verbs:
create_, update_,
process_
- +Love: Better integration, smaller interfaces, cleaner APIs
- +Justice: Add validation, tests, constraints, assertions
🌟 NEW in V8.4: The Generative Equation
V8.4 adds the Life Inequality: Ln > φd
If Growth (Love × Time) exceeds Decay
(Distance), your code is alive.
φ "Life is the victory of recursive Love over entropic distance."