Directory structure

Layout

.
|-- .github/workflows/
|-- bin/carbide
|-- cmd/carbide/
|-- internal/carbide/
|-- docs/engineering/
|-- docs/site/
|-- examples/hello/
|-- include/carbide/
|-- include/carbide/ui/
|-- infra/compose/
|-- infra/schemas/
|-- scripts/
|-- src/
|-- src/ui/
|-- templates/default/
|   |-- controller/
|   |-- model/
|   |-- src/
|   `-- view/web/
|-- tests/fixtures/
|-- tests/integration/
|-- tests/regression/
|-- tests/unit/
|-- go.mod
`-- install.sh

Ownership

• .github/workflows: CI and documentation deployment.
• bin/carbide: source checkout launcher for the Go CLI.
• cmd/carbide: installable CLI entrypoint.
• internal/carbide: Go implementation of the CLI and its unit tests.
• docs/engineering: source-of-truth engineering plans.
• docs/site: static GitHub Pages artifact.
• examples: generated or hand-written sample apps.
• include/carbide: reserved public framework API surface.
• include/carbide/ui: reserved public frontend helper API surface.
• infra: Compose templates and infrastructure schemas.
• scripts: repo-owned checks and maintenance commands.
• src: framework implementation.
• src/ui: future framework frontend helper APIs.
• templates/default: starter app used by carbide new and carbide init.
• templates/default/model: generated Postgres-backed model code.
• templates/default/controller: generated request-flow handlers.
• templates/default/src: generated Go HTTP/API server.
• templates/default/view/web: generated Bun/React/Tailwind web app, browser UI, frontend container source, and API proxy.
• tests: fixtures, unit, integration, and regression coverage.
• go.mod: Go module definition for the CLI.
• install.sh: GitHub URL installer that builds the Go CLI.

Rule

Empty directories are placeholders until a real file belongs there. When a directory gains behavior, its first file should make that behavior testable.