# Be Framework

> Objects don't DO things — they BECOME things.

Be Framework is a PHP framework for ontological programming. Procedural programming asked **HOW**, OOP asked **WHAT**, Being-oriented programming asks **WHETHER** — can it even exist? Types are existence conditions — invalid states are structurally inexpressible. Metamorphosis replaces procedural action.

## Core Concepts

- **Immanence + Transcendence → New Immanence**: Every transformation follows this formula. `#[Input]` carries what the object is; `#[Inject]` brings external power; public properties express the new existence.
- **Self-Organization**: Objects declare their own destiny via `#[Be]`. No external orchestrators or service layers needed.
- **Semantic Variables**: Variable names carry meaning and constraints. `$email` must be a valid email to exist. Define once, automatically applied everywhere.
- **Reason Layer**: Gathers the complete tool set for an existence to come into being, into a single object.
- **Type IS Capability**: Different types have different methods. An `EmergencyCase` can `assignER()`; an `ObservationCase` cannot.

## Documentation

- [Overview](https://be-framework.github.io/manuals/1.0/en/01-overview.html): From Doing to Being
- [Getting Started](https://be-framework.github.io/manuals/1.0/en/getting-started.html): Quick start guide
- [Tutorial](https://be-framework.github.io/manuals/1.0/en/tutorial.html): Emergency Triage example
- [Input Classes](https://be-framework.github.io/manuals/1.0/en/02-input-classes.html): Starting points (pure immanence)
- [Being Classes](https://be-framework.github.io/manuals/1.0/en/03-being-classes.html): Intermediate transformations
- [Final Objects](https://be-framework.github.io/manuals/1.0/en/04-final-objects.html): Destinations and $been
- [Becoming](https://be-framework.github.io/manuals/1.0/en/04a-becoming.html): Triggering metamorphosis
- [Metamorphosis](https://be-framework.github.io/manuals/1.0/en/05-metamorphosis.html): Patterns — linear, branching, nested
- [Semantic Variables](https://be-framework.github.io/manuals/1.0/en/06-semantic-variables.html): Names as meaning and constraints
- [Reason Layer](https://be-framework.github.io/manuals/1.0/en/08-reason-layer.html): Raison d'etre of existence
- [Semantic Exceptions](https://be-framework.github.io/manuals/1.0/en/09-error-handling.html): Meaningful failures
- [Demos](https://be-framework.github.io/manuals/1.0/en/demos.html): Working code examples
- [FAQ](https://be-framework.github.io/manuals/1.0/en/faq.html): Common questions

## Full Documentation

For complete API reference and code examples: [llms-full.txt](https://be-framework.github.io/llms-full.txt)

## Repository

- Framework: https://github.com/be-framework/be-framework
- App Skeleton: https://github.com/be-framework/app
- Demos: https://github.com/be-framework/demos
- Claude Code Skills: https://github.com/be-framework/skills