> **Navigation**: [Home](../index.md) > Guides

# Guides

Step-by-step tutorials and examples for ONEX development.

## Available Guides

| Guide | Description |
|-------|-------------|
| [2-Way Registration](registration-example.md) | Complete ONEX example walkthrough demonstrating all four node archetypes |
| [Handler Authoring](HANDLER_AUTHORING_GUIDE.md) | How to create a new handler for an existing node: classification properties, no-publish constraint, contract YAML registration, namespace allowlisting, and a complete Postgres-reading example |
| [MCP Integration](MCP_INTEGRATION_GUIDE.md) | How to expose ONEX node operations as MCP tools for AI agents: tool registration, schema generation, skip_server testing, and the envelope interface |
| [Infisical Secrets](INFISICAL_SECRETS_GUIDE.md) | How to retrieve secrets at runtime via HandlerInfisical: path convention, bootstrap sequence, adding new secrets to the seed script, and local development without Infisical |

## Guide Philosophy

These guides are designed to:
- Walk through complete, working examples
- Demonstrate ONEX patterns in context
- Show how all four node archetypes work together
- Provide copy-paste starting points

## Related Documentation

- [Quick Start](../getting-started/quickstart.md) - Get running in 5 minutes
- [Architecture Overview](../architecture/overview.md) - System design
- [Node Archetypes](../reference/node-archetypes.md) - Node type reference
- [Patterns](../patterns/README.md) - Implementation patterns
