Skip to main content

Intelligence Functions

What's the difference between intelligence and agency?

Intelligence is what a system IS. Agency is what it CREATES. One is a feature. The other is an outcome. Every Mycelium capability that matters — alignment scoring, yield calculation, confidence gating, recommendation — lives here.


The Job

When a venture needs smart decisions, pattern detection, or recommendation logic, help it access pure, portable functions that produce outcomes — not features that require infrastructure.

Trigger EventCurrent FailureDesired Progress
New venture needs decision logicRebuilds from scratch or copies brittle codeImports from shared function library
Framework migration (Next → whatever)Intelligence logic entangled with infrastructureFunctions survive migration untouched
Licensing opportunityValue locked inside one appExtractable, licensable, portable
Quality auditLogic scattered across services, untestable in isolationPure functions, tested independently, zero infrastructure deps

The Strategic Insight

What Gets CommoditisedWhat Compounds
UI (generated, pattern-based)Intelligence — real-world value creation
Plumbing (infrastructure, wiring)Intelligence — hard to copy
Specs (templates, conventions)Intelligence — zero infra, portable

The 80% that's generated doesn't matter. The 20% that's human-written and outcome-driven IS the moat.

What Belongs Here

Pure functions with zero infrastructure dependencies:

  • Alignment calculators — IDEAL vs REALITY gap scoring (Time + Mind)
  • Yield formulas — shipped value / invested hours (Dreamineering Yield)
  • Confidence scoring — how sure is the system about a decision (Workflow Engine)
  • Deviation detection — patterns that signal drift from intention
  • Recommendation engines — what to do next, based on what happened
  • Commissioning algorithms — progressive maturity scoring (Commissioning)

The rule: If it has a database import, it doesn't belong here. If it survives being extracted to a standalone package, it does.

Feature / Function / Outcome

#FeatureFunctionOutcomeState
1Pure function libraryPortable decision logic with no infra depsAny venture imports and uses immediatelyGap
2Alignment CalculatorScore IDEAL vs REALITY gapUsers see how close attention matches intentionGap
3Yield FormulaCalculate shipped artifacts / invested hoursSingle number proves whether the work is workingGap
4Confidence ScorerQuantify certainty of automated decisionsHumans intervene only when confidence is lowGap
5Deviation DetectorFlag when behaviour drifts from stated intentionCourse correction before it compoundsGap
6Recommendation EngineSuggest next action from patternsUsers act on insight, not guessworkGap

Commissioning

ComponentSchemaAPIUITestsStatus
Pure function libraryPendingPendingN/APending0%
Alignment CalculatorPendingPendingN/APending0%
Yield FormulaPendingPendingN/APending0%
Confidence ScorerPendingPendingN/APending0%
Deviation DetectorPendingPendingN/APending0%

Risks + Kill Signal

RiskMitigation
Premature extraction — pulling functions out before they're stableExtract only after a function is used by 2+ capabilities with tests passing
Over-abstraction — making it so generic it's uselessEach function must serve a concrete JTBD, not a theoretical pattern
Infra leaks in — database references sneak into "pure" functionsCI gate: intelligence layer builds with zero external dependencies

Kill signal: If functions exist but no venture imports them (they rebuild instead), the abstraction is wrong. Rewrite or kill.


Mycelium Capability

Intelligence Functions are the foundation layer. Every other capability depends on them:

Currently Growing In: All mushroom caps — this is platform infrastructure, not venture-specific.

Context