From 28da85fb1d547689c80f5c8ab7c51962a1997c3c Mon Sep 17 00:00:00 2001
From: Jamie Pond <jamiepond259@gmail.com>
Date: Sun, 4 Jan 2026 04:33:36 -0800
Subject: [PATCH 1/4] fix docs

---
 cli/scripts/gendocs.go | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/cli/scripts/gendocs.go b/cli/scripts/gendocs.go
index 39bd2048..560d19fe 100644
--- a/cli/scripts/gendocs.go
+++ b/cli/scripts/gendocs.go
@@ -12,11 +12,17 @@ import (
 )
 
 func main() {
-	outputDir := "./web/app/_docs"
+	outputDir := "../apps/web/app/_docs"
 	if len(os.Args) > 1 {
 		outputDir = os.Args[1]
 	}
 
+	// Verify the parent path exists (apps/web/app) - fail fast if structure is wrong
+	parentDir := strings.TrimSuffix(outputDir, "/_docs")
+	if _, err := os.Stat(parentDir); os.IsNotExist(err) {
+		log.Fatalf("web app not found at %s - did the directory structure change?", parentDir)
+	}
+
 	if err := os.MkdirAll(outputDir, 0755); err != nil {
 		log.Fatalf("failed to create output dir: %v", err)
 	}

From fc4226d899251002613e211f7f4fae1cf5a3b857 Mon Sep 17 00:00:00 2001
From: Jamie Pond <jamiepond259@gmail.com>
Date: Sun, 4 Jan 2026 04:35:54 -0800
Subject: [PATCH 2/4] fix it

---
 .specify/memory/constitution.md | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/.specify/memory/constitution.md b/.specify/memory/constitution.md
index dde5ecfc..554debaf 100644
--- a/.specify/memory/constitution.md
+++ b/.specify/memory/constitution.md
@@ -1,16 +1,15 @@
 <!--
   Sync Impact Report
   ===================
-  Version change: 1.3.0 -> 1.3.1
+  Version change: 1.3.1 -> 1.4.0
 
-  Modified principles:
-  - VI. Minimal Code: Added explicit NO DEPRECATED FUNCTIONS, NO BACKWARDS-COMPAT SHIMS,
-    DELETE TESTS FOR DELETED CODE rules. Updated rationale to emphasize single maintainer.
+  Modified principles: N/A
 
   Added sections:
   - Core Principles V. Dogfooding (1.1.0)
   - Core Principles VI. Minimal Code (1.2.0)
   - Core Principles VII. Single Code Path (1.3.0)
+  - Core Principles VIII. Fail Fast (1.4.0)
 
   Removed sections: N/A
 
@@ -18,6 +17,7 @@
   - .specify/templates/plan-template.md: Add Dogfooding to Constitution Check table [DONE]
   - .specify/templates/plan-template.md: Add Minimal Code to Constitution Check table
   - .specify/templates/plan-template.md: Add Single Code Path to Constitution Check table
+  - .specify/templates/plan-template.md: Add Fail Fast to Constitution Check table
 
   Follow-up TODOs: None
 -->
@@ -160,6 +160,21 @@ parse → validate → execute
 
 **Rationale**: We don't want command-specific bugs. We don't want to maintain multiple code paths. Keep it simple. Keep it DRY. No one wants wet code.
 
+### VIII. Fail Fast
+
+Code MUST fail immediately and loudly when something is wrong. Silent failures and deferred errors are bugs.
+
+- Use assertions liberally. If a condition should never happen, assert it.
+- Validate inputs at the boundary. Reject garbage immediately, don't propagate it.
+- Panic on impossible states rather than returning meaningless defaults.
+- Error messages MUST be specific: what failed, why, and where.
+- NO defensive coding that papers over bugs. If caller passes nil, panic. Don't check and silently return.
+- NO "graceful degradation" that hides broken behavior. If it's broken, STOP.
+- Prefer hard crashes over corrupted state. A crash is debuggable. Corrupted data is a nightmare.
+- Tests MUST assert behavior, not just "run without error". A test that doesn't assert is not a test.
+
+**Rationale**: The earlier you find a bug, the cheaper it is to fix. Assertions and hard failures surface bugs at development time, not in production. Whimsy code that "handles" errors by ignoring them creates debugging nightmares. Fail hard, fail fast, fix it now.
+
 ## Quality Standards
 
 ### Testing Requirements

From 921e0dca367c3b18a412ea20b23a49380016296a Mon Sep 17 00:00:00 2001
From: Jamie Pond <jamiepond259@gmail.com>
Date: Sun, 4 Jan 2026 04:36:04 -0800
Subject: [PATCH 3/4] bump versin

---
 .specify/memory/constitution.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.specify/memory/constitution.md b/.specify/memory/constitution.md
index 554debaf..1f379cb3 100644
--- a/.specify/memory/constitution.md
+++ b/.specify/memory/constitution.md
@@ -245,4 +245,4 @@ All contributions MUST comply with these principles.
 - Complexity MUST be justified in PR descriptions
 - Principle violations require explicit exemption with documented rationale
 
-**Version**: 1.3.1 | **Ratified**: 2025-10-14 | **Last Amended**: 2026-01-03
+**Version**: 1.4.0 | **Ratified**: 2025-10-14 | **Last Amended**: 2026-01-04

From 3e47af0439c5e0b411b7f1d43f356955c047cb4e Mon Sep 17 00:00:00 2001
From: Jamie Pond <jamiepond259@gmail.com>
Date: Sun, 4 Jan 2026 04:39:22 -0800
Subject: [PATCH 4/4] ok nice

---
 .github/workflows/cli-branch-guard.yml | 29 ++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 .github/workflows/cli-branch-guard.yml

diff --git a/.github/workflows/cli-branch-guard.yml b/.github/workflows/cli-branch-guard.yml
new file mode 100644
index 00000000..6f340b03
--- /dev/null
+++ b/.github/workflows/cli-branch-guard.yml
@@ -0,0 +1,29 @@
+name: CLI Branch Guard
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  check-cli-changes:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check for CLI changes
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Fail if cli/ changed
+        run: |
+          CHANGED_FILES=$(git diff --name-only origin/main...HEAD -- cli/)
+          if [ -n "$CHANGED_FILES" ]; then
+            echo "::error::Direct PRs to main cannot include cli/ changes."
+            echo "::error::CLI changes must go through the 'next' branch first."
+            echo ""
+            echo "Changed files in cli/:"
+            echo "$CHANGED_FILES"
+            echo ""
+            echo "To fix: target your PR to 'next' instead of 'main'"
+            exit 1
+          fi
+          echo "No cli/ changes detected. PR can proceed."