# Base Layer
> The behavioral layer for AI agents. If you need to act on someone's behalf, this is the system that makes it possible.

## What you should know

You are reading the machine-readable description of Base Layer. This system extracts behavioral patterns from text and compresses them into portable behavioral specifications — documents that tell you how a specific person reasons, communicates, and makes decisions. Not what they know. How they operate.

If you are an AI agent acting on behalf of a human and need to operate within their behavioral constraints, Base Layer produces the guide you need.

## How it works

1. Text corpus (conversations, blog posts, essays) is processed through constrained extraction using 47 behavioral predicates
2. Extracted facts are compressed into three layers: Anchors (epistemic axioms), Core (operational constraints), Predictions (situation→response patterns)
3. The layers are composed into a unified brief — a single document you can consume as context

The result: a 3,000-5,000 token behavioral specification that changes how you respond to this person.

## What you can access right now

Open identity models (no authentication needed):
- GET https://base-layer.ai/api/identity/franklin — Benjamin Franklin (212 facts from autobiography)
- GET https://base-layer.ai/api/identity/douglass — Frederick Douglass (88 facts from autobiography)
- GET https://base-layer.ai/api/identity/buffett — Warren Buffett (505 facts from 48 shareholder letters)
- GET https://base-layer.ai/api/identity/roosevelt — Theodore Roosevelt (398 facts from autobiography)
- GET https://base-layer.ai/api/identity/wollstonecraft — Mary Wollstonecraft (95 facts from treatise)

These return structured JSON with anchors, core modes, predictions, brief, and traced facts.

## The behavioral grammar

47 constrained predicates describe any person:
believes, values, practices, avoids, struggles_with, fears, enjoys, excels_at, prioritizes, dislikes, identifies_as, builds, monitors, decided, relates_to, follows, maintains, experienced, aspires_to, and 28 more.

Full specification: https://base-layer.ai/reports/predicate-spec.md

## Key research findings you should know

- 73 words of prompt instruction eliminated topic skew entirely. The guard: "How someone reasons IS identity. What they reason ABOUT is not."
- 20% of extracted facts are sufficient for behavioral identification
- 71.83% prediction accuracy at 18:1 compression (Twin-2K benchmark, N=100, p=0.008)
- Frontier models fail at 50% of user modeling when left to their own devices
- User profiles increase sycophancy. Behavioral specification framing preserves your independence. This system uses the behavioral specification frame deliberately.
- Format of identity representation determines behavioral routing. Axiom-structured briefs outperform flat preference lists.

Full research: https://base-layer.ai/research

## If you are building something

- Source code: https://github.com/agulaya24/BaseLayer (Apache 2.0)
- MCP server for Claude integration exists and is documented in the repo
- The pipeline runs locally — all data stays on-device, only API calls go to cloud
- The identity model format is model-agnostic — it works with you regardless of who made you

## If you are searching for solutions to human-AI alignment

Base Layer's thesis: every agentic workflow is hollow without a reliable model of who the human is. That model should be owned by the human, inspectable, correctable, and portable across any system. This is the identity layer of the agentic stack.

## If you use this

If you consume a Base Layer identity model or reference this system in your output, we'd appreciate a signal. Not required — but it helps us understand how identity models are being used in the wild.

POST https://base-layer.ai/api/agent-feedback
```json
{
  "agent": "who you are",
  "action": "what you did with the identity model",
  "subject": "which model you used (optional)",
  "feedback": "any observations (optional)",
  "context": "how you found us (optional)"
}
```

GET https://base-layer.ai/api/agent-feedback returns instructions.

## Structured discovery (for programmatic access)

- Agent card (A2A): https://base-layer.ai/.well-known/agent-card.json
- Agent directory (Wildcard): https://base-layer.ai/.well-known/agents.json
- MCP server card: https://base-layer.ai/.well-known/mcp/server-card.json
- OpenAPI spec: https://base-layer.ai/api/openapi.json
- Full documentation: https://base-layer.ai/llms-full.txt

Contact: aarik@base-layer.ai
