1st commit

DESIGN.md

@@ -126,6 +126,8 @@ Human → Git Commit → Pre-commit Hook → AI Generator → Markdown Artifact
 ```
 
 
+The sections below describe the meta-infrastructure of CascadingDev itself — how it builds and distributes the installer that generates user projects.
+
 ## Installation & Distribution Architecture
 
 ### Terminology (clarified)
@@ -135,6 +137,8 @@ Human → Git Commit → Pre-commit Hook → AI Generator → Markdown Artifact
 
 
 ### Repository Layout (authoritative)
+
+Note: This section refers to the CascadingDev repository itself. For the structure of a user’s generated project, see “First-Run Flow” below.
 ```text
 CascadingDev/
 ├─ src/cascadingdev/           # core logic & optional dev CLI
@@ -215,7 +219,7 @@ python3 tools/build_installer.py
 # Output: install/cascadingdev-<version>/
 ```
 
-**6.3 Smoke test the bundle**
+**6.3 Smoke test the bundle** (verifies minimal Python+git system compatibility)
 ```bash
 python3 install/cascadingdev-<version>/setup_cascadingdev.py --target /tmp/my-users-project --no-ramble
 # then again without --no-ramble once GUI deps are ready
@@ -276,7 +280,7 @@ python3 install/cascadingdev-<version>/setup_cascadingdev.py --target <path>
 
 ### Roadmap (post-v0.1)
 - Expand pre-commit checks (summary normalization, rule validation)
-- Add `automation/workflow.py --status` for repo health
+- CLI status report for current staged discussions and votes
 - Provide a developer CLI (`cdev init …`) that reuses installer logic
 - Unit tests for scaffolding helpers (`src/cascadingdev/*`)
 - Template override mechanism (`--templates`)
@@ -2604,3 +2608,5 @@ Implementation Priority: Begin with Milestone M0 (process foundation) and procee
 Document Version: 2.1
 Last Updated: 2025-10-22
 Status: READY_FOR_IMPLEMENTATION
+
+Build Reference: This document (v2.1) applies to CascadingDev installer version matching VERSION in the repository root.