docs: align architecture diagrams with current ADRs

.claudeignore

@@ -18,6 +18,11 @@ dist/
 *.log
 logs/
 
+# Environment
+.env
+.env.*
+!.env.example
+
 # NCrunch
 *.ncrunchsolution
 *.ncrunchproject

.dockerignore

@@ -10,6 +10,8 @@
 **/.ncrunch_*
 **/*.ncrunchsolution*
 **/*.user
+# Intentionally excluded for API runtime image context size.
+# If Dockerfile build stages later need these paths, revisit this block.
 docs
 tests
 frontend

.gitignore

@@ -22,8 +22,8 @@ dist/
 
 # Environment
 .env
-.env.local
-.env*.local
+.env.*
+!.env.example
 
 # Logs
 *.log

CLAUDE.md

@@ -78,6 +78,7 @@ Stack, versions, and ADRs are owned by [`docs/TECH_STACK.md`](docs/TECH_STACK.md
 - Zero build warnings and zero test failures.
 - Docs in the same PR as code (see [agent-checklist](docs/playbooks/agent-checklist.md)).
 - No new TODO/FIXME/placeholder/stub code.
+- For visual artifact changes (`docs/diagrams/`, `docs/wireframes/`, `docs/use-cases/**` `.excalidraw`/`.svg`): run [`docs/playbooks/visual-artifact-checklist.md`](docs/playbooks/visual-artifact-checklist.md) before commit.
 
 **When blocked:** state blocker → cite constraint → 2–3 options → wait. Never self-unblock on P0.
 
@@ -187,7 +188,7 @@ Add navigation back-links per [docs/README.md](docs/README.md) (playbooks, use-c
 
 **Per PR before merge:** PR description = Summary + Linked spec + Requirements only (no CI status, no commit list — Checks tab covers that). Run `./scripts/check-doc-drift.sh` before push when `src/`, `tests/`, or `docs/use-cases/` change — the script enforces use-case-docs same-PR, new-handler tests, the no-new `TODO`/`FIXME`/`stub` rule, and new raw-SQL call review (cross-module guard).
 
-Diagrams/wireframes: regenerate `.svg` in same PR when source `.excalidraw` changes.
+Diagrams/wireframes: regenerate `.svg` in same PR when source `.excalidraw` changes. Agents must pass [`docs/playbooks/visual-artifact-checklist.md`](docs/playbooks/visual-artifact-checklist.md) before commit.
 
 ---
 
@@ -206,6 +207,7 @@ Diagrams/wireframes: regenerate `.svg` in same PR when source `.excalidraw` chan
 | [TECH_STACK.md](docs/TECH_STACK.md) | Libraries + ADRs |
 | [PROGRESS.md](docs/PROGRESS.md) | Module layer status |
 | [WORKAROUNDS.md](docs/WORKAROUNDS.md) | Intentional rule violations + cleanup triggers (**read when touching legacy or shipping a known shortcut**) |
+| [docs/playbooks/visual-artifact-checklist.md](docs/playbooks/visual-artifact-checklist.md) | **Required when changing diagrams/wireframes/use-case visuals** |
 | [Architecture tests README](tests/Architecture/Axis.Architecture.Tests/README.md) | What's mechanically enforced + how to add a new rule |
 | [docs/use-cases/](docs/use-cases/README.md) | Features + ACs |
 

README.md

@@ -0,0 +1,35 @@
+# Axis
+
+Axis is a multi-tenant low-code SaaS platform for building data-driven workflow applications without end-user coding.
+
+At a high level, teams can model data, design workflows, collect inputs with forms, and expose experiences through UI pages.
+
+## Quick links
+
+- Documentation hub: [docs/README.md](./docs/README.md)
+- Product vision: [docs/PRODUCT_VISION.md](./docs/PRODUCT_VISION.md)
+- Architecture: [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)
+- Tech stack and ADRs: [docs/TECH_STACK.md](./docs/TECH_STACK.md)
+- Use cases and implementation progress: [docs/use-cases/README.md](./docs/use-cases/README.md)
+- Contribution guide: [CONTRIBUTING.md](./CONTRIBUTING.md)
+- Agent/workflow rules: [CLAUDE.md](./CLAUDE.md)
+
+## Quick start (local dev)
+
+Prerequisite: Docker + Compose v2.
+
+From repo root:
+
+```bash
+docker compose up -d
+```
+
+Then open:
+
+- Web app: <http://localhost:3000>
+- API: <http://localhost:5280>
+- API health: <http://localhost:5280/health>
+
+For full local-dev operations, ports, troubleshooting, and observability profile, see:
+[docs/playbooks/local-dev.md](./docs/playbooks/local-dev.md)
+

docs/README.md

@@ -25,6 +25,7 @@
 | [Testing](./playbooks/testing.md) | Test isolation, naming, file layout, mocking rules — .NET and frontend |
 | [Frontend](./playbooks/frontend.md) | TanStack Query patterns, TypeScript discipline, routing, component design |
 | [Wireframe kit](./playbooks/wireframes.md) | Component kit template rules — section builder anatomy, ID prefixes, offsets |
+| [Visual artifact checklist](./playbooks/visual-artifact-checklist.md) | Required review checklist for diagrams/wireframes/use-case visuals before commit |
 | [Docs style](./playbooks/docs-style.md) | Anti-patterns for `.md` files — single-owner rule, size budgets, when to create vs absorb |
 
 ---