diff --git a/docs/biomimicry-positioning.md b/docs/biomimicry-positioning.md new file mode 100644 index 0000000..3a31e7c --- /dev/null +++ b/docs/biomimicry-positioning.md @@ -0,0 +1,45 @@ +# Biomimicry Positioning + +## Thesis + +fable-agent uses biological metaphors only when they map to verifiable engineering primitives: + +```text +immune system → layered security gates +nervous system → receipt/event observability +biological computation → adaptive, event-driven evaluation +``` + +The product claim stays narrow: fable-agent is not a new organism or orchestrator; it is an agentic attestation layer that records proof, risk, and deploy readiness. + +## External validation signals + +| Signal | Pattern | fable-agent mapping | Source | +|---|---|---|---| +| BioDefense | Immune-system-inspired defense-in-depth for LLM agents | 5-layer verification: safety gate → AST/glyph scanners → build/test/docs → attestation → guarded deploy | [BioDefense gist](https://gist.github.com/andreschauer/e0f958c2a279062559ae8306f946b43d) | +| Agent Nervous System / agent observability | Tool traces, spans, eval gates, release enforcement | Receipt consumers and `.runs//channel.jsonl` events | [Braintrust agent observability guide](https://www.braintrust.dev/articles/agent-observability-complete-guide-2026) | +| SNNs for finance | Biologically inspired temporal/event processing in markets | Event receipts and benchmark set graders over vibes | [arXiv:2512.05868](https://arxiv.org/abs/2512.05868) | + +## Architecture analogy + +| Biological layer | Engineering layer | Current fable-agent primitive | +|---|---|---| +| Innate immune response | Fast input triage | `plinius safety`, content safety gate, adaptive reframing detection | +| Pattern recognition receptors | Structural threat detection | AST capability scanner, glyph/covert-channel scanner | +| Adaptive immunity | Learned risk memory | receipts, hallucination detections, RSI verification receipts | +| Nervous system | Runtime telemetry | channel events, typed receipts, attestations | +| Motor reflex | Controlled action | guarded `8099/deploy via git-proxy` decision path | + +## Boundaries + +- Do not claim biological novelty; claim engineering convergence. +- Do not claim generic self-healing until non-canary degraded repair is proven. +- Do not treat memory as proof; receipts remain the trust primitive. +- Current guarded deploy path is `8099/deploy via git-proxy`; `8098 deploy-webhook` is legacy infrastructure context, not the decision primitive. + +## Product line + +```text +Biological systems survive by sensing, verifying, remembering, and acting through constrained channels. +fable-agent applies that pattern to agent work: scan, verify, attest, and only then deploy. +```