# Agent-HTML Docs

This directory contains project documentation grouped by ownership boundary.

## Product

- [Product blueprint](./blueprint/index.md): product purpose, north star, principles, and product boundary.

## Development

- [Architecture](./development/architecture.md): module ownership, dependency direction, and structural change rules.
- [Deployment](./development/deployment.md): example website build and Cloudflare Pages deployment rules.
- [Runtime interactions](./development/runtime-interactions.md): runtime gesture, hit-testing, and scroll-aware interaction rules.

## Design

- [Design standards](./design/README.md): frontend design system, layout, component, and token rules.
- [Design system narrative](./design/DESIGN.md): operating-shell visual and interaction philosophy.
- [UI code structure](./design/code-structure.md): directory roles, styling source of truth, and review rules.

## References

- [Reference notes](./ref/): external and background reference material.
