✂️ The Sovereign Cull & Prune Decision Matrix

“त्यक्त्वा कर्मफलासङ्गं नित्यतृप्तो निराश्रयः।
कर्मण्यभिप्रवृत्तोऽपि नैव किञ्चित्करोति सः॥”
Having abandoned attachment to the fruits of action, always satisfied and relying on nothing, though engaged in action, one does nothing at all.
— श्रीमद्भगवद्गीता (Bhagavad Gītā 4.20)

Architectural Pruning Philosophy

A truly universal web framework must be infinitely expandable while simultaneously being effortlessly prunable. When an autonomous coding agent or human craftsman is commissioned to build a specific website, keeping unneeded showcase pages or heavy visual primitives can create unnecessary noise.

This matrix provides deterministic guidance on what to keep, what to customize, and what to safely delete across the 34 Supreme Craft Primitives and core routes.

---

Safety Rating Classification

• 🔴 IMMUTABLE CORE: Critical system infrastructure. Never delete or rename these files. Doing so will break static compilation or violate Cloudflare Pages edge purity.
• 🟡 OPTIONAL / CULLABLE: Modular components, showcase pages, or luxury primitives that can be safely deleted if your design brief does not require them.
• 🟢 REPLACEABLE: Content files designed specifically to be overwritten or swapped for client copy.

---

The Master Matrix

1. Configuration & Engine Core

File / Folder	Role	Safety Rating	Rules & Guidance
src/config/site.config.ts	Single Source of Truth	🔴 IMMUTABLE	Update brand, colors, navigation, and schemas. Never delete.
src/layouts/Layout.astro	Root HTML Shell & Head	🔴 IMMUTABLE	Manages fonts, SEO, OpenGraph, JSON-LD, Lenis, and theme restoration.
src/styles/global.css	Tailwind v4 Stylesheet	🔴 IMMUTABLE	Houses @theme, OKLCH CSS variables, and utility overrides.
astro.config.mjs	Astro Build Config	🔴 IMMUTABLE	Enforces static output (output: 'static').
public/_headers	Cloudflare Security & Cache	🔴 IMMUTABLE	HSTS, CSP, and immutable /_astro/* caching.
public/_routes.json	Cloudflare Workers Bypass	🔴 IMMUTABLE	Must contain "exclude": ["/*"] to prevent runtime Worker billing.
scripts/audit-cloudflare-static.js	10-Gate Purity Audit	🔴 IMMUTABLE	CI/CD verification script.
scripts/fork.js	Scaffolding Engine	🔴 IMMUTABLE	Autonomous CLI fork utility.

---

2. The 34 Supreme Craft Primitives (src/components/craft/)

BOB-Astro includes 34 production-grade craft primitives. When pruning, observe the distinction between core foundational primitives and specialized visual or conversion tools:

Primitive	Category	Safety Rating	Guidance
SmoothScroll.astro	Motion	🔴 CORE CRAFT	Powers Lenis 1.3 smooth scrolling. Keep for 60fps kinetic feel.
NoiseOverlay.astro	Texture	🔴 CORE CRAFT	Procedural SVG fractal noise. Provides tactile physical texture.
ThemePaletteSwitcher.astro	Theming	🔴 CORE CRAFT	Client-side OKLCH palette switcher with zero FOUC.
BadgePill.astro	UI Tag	🔴 CORE CRAFT	Pulsing status indicator pill. Used throughout all headers and cards.
SpotlightCard.astro	Surface	🔴 CORE CRAFT	Radial pointer spotlight container with specular border highlight.
ScrollProgressBar.astro	Motion	🟡 CULLABLE	Viewport top progress bar for long articles and blogs.
FloatingBackToTop.astro	Motion	🟡 CULLABLE	Radial SVG scroll meter with smooth return to top.
MaskedReveal.astro	Typography	🟡 CULLABLE	Accessible staggered word reveal with zero layout shift.
ClipImageReveal.astro	Media	🟡 CULLABLE	Curtain and circular clip-path reveals for imagery.
TiltCard.astro	Micro-Interaction	🟡 CULLABLE	3D perspective tilt on pointer hover.
Card.astro	Surface	🟡 CULLABLE	General-purpose bordered container with subtle sheen.
ContainerLines.astro	Layout	🟡 CULLABLE	Vertical alignment grid lines with mini corner markers.
CornerDiagonals.astro	Surface	🟡 CULLABLE	Chamfered geometric corners for buttons and cards.
SignatureCanvas.astro	3D / Canvas	🟡 CULLABLE	Interactive Fibonacci particle field ($\phi=1.618$).
OklchLab.astro	Canvas / Tool	🟡 CULLABLE	Interactive color space synthesizer with real-time sliders.
ProjectShowcase.astro	Portfolio	🟡 CULLABLE	Full-width agency case study showcase module.
CustomCursor.astro	Pointer	🟡 CULLABLE	Trailing halo pointer with magnetizing hover behavior.
Shimmer.astro	Animation	🟡 CULLABLE	Subtle light sweep effect across premium CTA surfaces.
TextScramble.astro	Typography	🟡 CULLABLE	Matrix-style character scrambling effect on viewport entrance.
CountUp.astro	Typography	🟡 CULLABLE	Smooth numeric increment animation for statistics and metrics.
NumberDetail.astro	Typography	🟡 CULLABLE	Monospace decorative numeric badges (01, 02, 03).
SectionHeader.astro	Layout	🟡 CULLABLE	Standardized section title with subtitle and metadata pill.
Accordion.astro	Component	🟡 CULLABLE	FAQ accordion with Schema.org JSON-LD structured data.
Tabs.astro	Component	🟡 CULLABLE	Accessible tabbed switcher for features or categories.
Breadcrumb.astro	Navigation	🟡 CULLABLE	Schema.org BreadcrumbList with Google Rich Snippets support.
Pagination.astro	Navigation	🟡 CULLABLE	Bidirectional pagination controls for blogs and catalogs.
Divider.astro	Layout	🟡 CULLABLE	Styled hairline divider with optional center diamond or dot.
DrawerModal.astro	Modal	🟡 CULLABLE	60fps sliding slide-over drawer (ideal for shopping cart).
Toast.astro	Feedback	🟡 CULLABLE	Transient notification toast with auto-dismiss.
CommandPalette.astro	Navigation	🟡 CULLABLE	Raycast-grade ⌘K modal with fuzzy search indexing.
KeyboardShortcutsModal.astro	Feedback	🟡 CULLABLE	Emil Kowalski / Linear shortcut modal (?).
AccessibilityModal.astro	Accessibility	🟡 CULLABLE	Alt+A contrast, motion, and font preference controller.
AudioHaptics.astro	Audio	🟡 CULLABLE	Emil Kowalski Web Audio tactile micro-clicks with 432Hz resonance.
TelemetryHud.astro	Telemetry	🟡 CULLABLE	Alt+T performance overlay (FPS, memory, viewport).
PricingTable.astro	Conversion	🟡 CULLABLE	SaaS pricing matrix with annual/monthly billing toggle.
TerminalWindow.astro	Code Preview	🟡 CULLABLE	Tactical CLI preview window with copy buttons.

Note on Gate 8 Resilience:
The 10-Gate Purity Audit (npm run test:static) dynamically checks craft primitives. As long as the 5 core primitives (SmoothScroll, NoiseOverlay, ThemePaletteSwitcher, BadgePill, SpotlightCard) remain intact, Gate 8 will pass!

---

3. Pages & Routes (src/pages/)

Route	Role	Safety Rating	Guidance
src/pages/index.astro	Homepage	🟢 REPLACEABLE	Retain shell; customize hero, bento grid, and editorial chapters.
src/pages/styleguide.astro	34-Craft Workbench	🟡 OPTIONAL	Safe to delete on production client sites.
src/pages/architecture.astro	Architecture Blueprint	🟡 OPTIONAL	Safe to delete if client site does not need technical explainer.
src/pages/changelog.astro	Release Ledger	🟡 OPTIONAL	Safe to delete if client site does not track software releases.
src/pages/docs/	Documentation Hub	🟡 OPTIONAL	Safe to delete if client site does not require documentation manuals.
src/pages/api/health.ts	Static Health Telemetry	🔴 IMMUTABLE	Pre-rendered JSON diagnostic artifact used by monitoring tools.
src/pages/api/manifest.ts	Substrate Manifest	🔴 IMMUTABLE	Pre-rendered JSON description of platform capabilities.
src/pages/api/catalog.ts	Craft Catalog JSON	🔴 IMMUTABLE	Statically pre-rendered catalog of active primitives.

---

4. Tailored Pruning Recipes for the 4 Builder Archetypes

📚 Recipe 1: 10,000-Page Content Blog & Digital Garden

Goal: Maximum reading comfort, blazing search, zero server cost.

1. Keep:
   • ScrollProgressBar.astro, FloatingBackToTop.astro, Breadcrumb.astro, Pagination.astro, CommandPalette.astro, Divider.astro.
2. Prune:

   rm src/pages/styleguide.astro src/pages/architecture.astro
   rm src/components/craft/PricingTable.astro
   rm src/components/craft/OklchLab.astro

3. Expand:
   • Create src/pages/blog/[...slug].astro querying getCollection('blog').
   • Update src/config/site.config.ts navigation to point to /blog.

---

🛍️ Recipe 2: Decoupled Headless E-Commerce Storefront

Goal: High conversion, silky cart drawer, tactile feedback, product showcases.

1. Keep:
   • DrawerModal.astro (Slide-over Cart Drawer), Toast.astro (Cart Notification), SpotlightCard.astro, TiltCard.astro, ClipImageReveal.astro, AudioHaptics.astro, PricingTable.astro (Variant Matrix), Breadcrumb.astro.
2. Prune:

   rm src/pages/architecture.astro src/pages/changelog.astro
   rm src/components/craft/TerminalWindow.astro
   rm src/components/craft/TelemetryHud.astro

3. Expand:
   • Create src/pages/products/[id].astro for product detail pages.
   • Wire DrawerModal.astro with local storage or Medusa v2 / Shopify cart SDK.

---

🚀 Recipe 3: High-Ticket SaaS & Startup Platform

Goal: Enterprise trust, clear conversion funnel, schema rich snippets, agent discoverability.

1. Keep:
   • PricingTable.astro, Accordion.astro (FAQ with JSON-LD), TerminalWindow.astro, CommandPalette.astro, AudioHaptics.astro, BadgePill.astro, SpotlightCard.astro.
2. Prune:

   rm src/pages/styleguide.astro
   rm src/components/craft/ProjectShowcase.astro

3. Expand:
   • Add feature matrix comparisons in src/pages/index.astro.
   • Update /llms.txt and /llms-full.txt with company-specific API or product documentation.

---

🎨 Recipe 4: Luxury Editorial & Creative Agency Flagship

Goal: Awwwards Site of the Year contender, kinetic physics, bespoke art direction.

1. Keep:
   • All 34 Primitives! Specially highlight: SmoothScroll.astro (Lenis 1.3), SignatureCanvas.astro ($\phi=1.618$), ClipImageReveal.astro, ProjectShowcase.astro, CustomCursor.astro, NoiseOverlay.astro, MaskedReveal.astro.
2. Prune:
   • Delete only technical documentation if not needed:

   rm -rf src/pages/docs src/content/docs

3. Expand:
   • Elevate case studies in ProjectShowcase.astro with full-bleed editorial imagery and typography.

---

5. Verification After Pruning

After pruning any components or routes, always execute:

# Verify TypeScript and Astro types
npm run check

# Verify Cloudflare Static Edge Purity (all 10 gates)
npm run test:static

# Compile clean static output
npm run build

Your pruned project will remain 100% compliant with Cloudflare Pages zero-cost static edge delivery.