# oridecon

> Async-first DI container, Application lifecycle, modules, providers, config, and the Result type.

Machine index for **oridecon** only. Rules: https://docs.oridecon.dev/agents.md · Catalog: https://docs.oridecon.dev/llms.txt · Slices: https://docs.oridecon.dev/llms/index.txt · Skill: https://docs.oridecon.dev/SKILL.md

## Package

- Name: `oridecon`
- Group: Foundation — Application, container, providers, modules, config, Result.
- Docs: https://docs.oridecon.dev/packages/foundation/oridecon/
- Source (branch `dev`): https://github.com/dbtinoy-/oridecon/tree/dev/core/oridecon
- This slice: https://docs.oridecon.dev/llms/oridecon.txt
- Install: `uv add oridecon`

## Boundaries

- Extensions import only `oridecon` and `oridecon-contracts` — never each other.
- Shared types live in `oridecon-contracts`. Do not invent a second copy here.
- Constructor injection. `register()` binds, `boot()` resolves.
- Domain failures are `Result[T, E]`. Infrastructure failures raise.
- One tree: `domains/` (not `models/`), app-root `di/` for `*_provider.py`.

## Docs in this package

- [Core (oridecon)](https://docs.oridecon.dev/packages/foundation/oridecon/): Core framework: container, DI, registry, config, logging
- [API Reference](https://docs.oridecon.dev/packages/foundation/oridecon/api/): Complete API reference for the oridecon package.
- [Architecture](https://docs.oridecon.dev/packages/foundation/oridecon/docs/architecture/): Architecture for oridecon
- [Configuration](https://docs.oridecon.dev/packages/foundation/oridecon/docs/configuration/): Configuration for oridecon
- [Guide](https://docs.oridecon.dev/packages/foundation/oridecon/docs/guide/): Guide for oridecon
- [How-To Guides](https://docs.oridecon.dev/packages/foundation/oridecon/docs/howtos/): How-To Guides for oridecon
- [Plugins (oridecon.plugins)](https://docs.oridecon.dev/packages/foundation/oridecon/docs/plugins/): Plugins (oridecon.plugins) guide and reference for the oridecon package in the Oridecon framework.
- [Quickstart](https://docs.oridecon.dev/packages/foundation/oridecon/docs/quickstart/): Quickstart for oridecon
- [Security](https://docs.oridecon.dev/packages/foundation/oridecon/docs/security/): Security for oridecon
- [Troubleshooting](https://docs.oridecon.dev/packages/foundation/oridecon/docs/troubleshooting/): Troubleshooting for oridecon

## See also

- Playbook: https://docs.oridecon.dev/getting-started/for-coding-agents/
- Fail vs fix: https://docs.oridecon.dev/getting-started/common-mistakes/
- Group hub: https://docs.oridecon.dev/packages/foundation/
- Skill: https://docs.oridecon.dev/SKILL.md
- Rules (do not skip): https://docs.oridecon.dev/agents.md