# Cloudhal: Contributing and internals

- [Contributor docs](https://cloudhal.dev/docs/contributing.md): Architecture guide and package-by-package walkthrough will be added as packages land (Sprint 2+).
- [Cloudhal Studio design system](https://cloudhal.dev/docs/design/design.md): Verified sources: kumo-ui.com (installation, components-vs-blocks, blocks, component docs, registry), the Kumo repository (sidebar.tsx, blocks, the docs app shell), the kumo-design skill, Cloudflare dashboard…
- [Agent-built sites: gap analysis](https://cloudhal.dev/docs/design/agent-built-sites-gap-analysis.md): What stops Claude, Codex or any MCP agent from building a modern, interactive, well-structured site end to end on Cloudhal, and what to build next. Collected 2026-10-15.
- [Focus mode for the body editor — research and decision](https://cloudhal.dev/docs/design/body-focus-mode.md): The owner asked for a focus button in Studio's body editor (2026-10-17). Sources at the end.
- [Carousels and sliders: research and decisions](https://cloudhal.dev/docs/design/carousels.md): Research for RFC-0027 (a carousel for generated UI and theme hero areas). Sources at the end.
- [Icons on public sites: research and decisions](https://cloudhal.dev/docs/design/icons.md): Research for the next RFC (icons in themes and surfaces). Studio already uses Phosphor through Kumo; public sites have almost none: hand-drawn SVGs for the menu, caret and close buttons, and social links as text.
- [Image presentation: placeholders and fit — research and decisions](https://cloudhal.dev/docs/design/images.md): Research for the next RFC (images that load gracefully and fit any frame). Sources at the end.
- [Kumo upstream notes (not filed)](https://cloudhal.dev/docs/design/kumo-upstream-notes.md): Issue texts for gaps Cloudhal found in Kumo 2.14.0 (the latest release on 2026-10-12) while making Studio speak Turkish. Nothing here has been filed: the maintainer decides what to send, and when.
- [Site chrome and overlays: R&D report](https://cloudhal.dev/docs/design/site-chrome-and-overlays.md): Where we are.
- [Starter themes: references and gaps](https://cloudhal.dev/docs/design/starter-references.md): Research for strengthening starters/blog (and a possible newsroom starter) before the first public demo. Collected 2026-10-15. Visitor-facing sites use the theme system, not Kumo; DESIGN.md does not apply here.
- [Code structure and size rules](https://cloudhal.dev/docs/engineering/code-structure.md): Status: binding for new code from 2026-10-17. Enforced by pnpm size:check (part of pnpm check and CI), Biome complexity warnings and the clippy lints in Cargo.toml.
- [Cloudhal threat model (alpha)](https://cloudhal.dev/docs/security/threat-model.md): Cloudhal lets AI agents change websites. The central security promise: an agent can only do what its scopes allow, every change is recorded and reversible, and nothing goes live without a person.