# Mahaut

Mahaut is a lightweight PHP 8 framework and promo/documentation site.

Primary purpose:
- Show the framework value proposition.
- Document routing, controllers, request lifecycle, middleware, examples, and project structure.
- Help AI coding agents understand the framework quickly.

Core flow:
public/index.php -> Core\Bootstrap -> app/routes.php -> Core\Router -> middleware -> controller -> view.

Important URLs:
- / - product overview
- /docs - documentation index
- /getting-started - installation and first route
- /routing - routing syntax
- /examples - copyable examples
- /agents - AI agent guide

Important files:
- /llms-full.txt - extended AI-readable context
- /ai-index.json - machine-readable site and framework map
- /sitemap.xml - crawlable page list

Principles:
- Mahaut can work with or without a database.
- No database is used for the promo site.
- Keep the framework small and explicit.
- Avoid unnecessary dependencies.
- Do not commit secrets.