🤖 Autonomous Agent Forking Protocol

“योगस्थः कुरु कर्माणि सङ्गं त्यक्त्वा धनञ्जय।
सिद्ध्यसिद्ध्योः समो भूत्वा समत्वं योग उच्यते॥”
Perform your duty poised in yoga, abandoning all attachment to success or failure. Such equanimity is called yoga.
— श्रीमद्भगवद्गीता (Bhagavad Gītā 2.48)

Overview

BOB-Astro is engineered as an agent-native substrate. When an autonomous AI coding agent (such as Claude Code, Cursor, Devin, Codex, or Antigravity) is commanded to build a high-end digital experience, cloning and adapting this repository compresses 40–60 hours of senior frontend architecture into under 5 minutes while reducing LLM token burn by over 98%.

---

The 5-Minute Rebrand Workflow

Option A: The Autonomous Scaffolding Script (One-Shot)

The repository includes a dedicated CLI scaffolding utility at scripts/fork.js. An agent or human developer can execute it in non-interactive mode:

npm run fork -- \
  --name "KRONOS DYNAMICS" \
  --tagline "Autonomous Orbital Computing Infrastructure" \
  --author "Kronos Global Ltd" \
  --url "https://kronos.pages.dev" \
  --palette emerald \
  --detach-git

This single command:

1. Replaces brand references and copy in src/config/site.config.ts.
2. Sets the default OKLCH palette to Cyber Emerald (oklch(0.78 0.17 150)).
3. Wipes the upstream .git history and creates a fresh git init virgin commit.
4. Executes npm run check and npm run test:static to verify that all 10 gates pass.

---

Option B: The Single-File Manual Protocol

If the agent prefers direct file edits, only one file requires modification:

📁 src/config/site.config.ts:

export const siteConfig: SiteConfig = {
  brand: {
    name: 'MY BRAND',
    ticker: 'BRAND//2026',
    tagline: 'Precision Web Experience',
    badge: '100% STATIC EDGE',
    domain: 'https://my-brand.pages.dev',
    // ...
  },
  theme: {
    palette: {
      accentPrimary: 'oklch(0.78 0.17 150)', // Pick your brand OKLCH hue
      // ...
    }
  }
};

Because of the Zero-Hardcoding Policy, modifying site.config.ts cascades instantly to:

• <head> OpenGraph tags, JSON-LD schemas, page <title>
• Header logo, ticker text, navigation links, and mega-menus
• Homepage hero badge, headline, metrics, and CTA buttons
• Footer copyright, dispatch newsletter, and legal text
• CSS theme variables on <html>

---

Agent Adaptation Across the 4 Builder Archetypes

After the initial rebrand, the AI agent can tailor the codebase to match the client’s specific archetype using The Sovereign Cull & Prune Decision Matrix:

1. 📚 High-Scale 10k Content Blog:

   • Keep: ScrollProgressBar, FloatingBackToTop, Breadcrumb, Pagination, CommandPalette.
   • Action: Create src/pages/blog/[...slug].astro wired to Astro 7 Content Collections.
   • Benefit: 10,000+ pages statically compiled with $0 Cloudflare hosting costs.

2. 🛍️ Decoupled Headless E-Commerce:

   • Keep: DrawerModal (Slide-over Cart), Toast, SpotlightCard, TiltCard, ClipImageReveal, AudioHaptics, PricingTable.
   • Action: Wire cart state to Medusa v2, Shopify Storefront API, or Stripe Checkout.
   • Benefit: Sub-15ms TTFB product catalog with zero server cold start.

3. 🚀 High-Ticket SaaS & Startup Platform:

   • Keep: PricingTable (Annual/Monthly toggle), Accordion (FAQ with Schema.org JSON-LD), TerminalWindow, CommandPalette, AudioHaptics.
   • Action: Replace pricing tiers and FAQ questions with client offerings.
   • Benefit: High conversion rate, Google Rich Snippets, machine-readable agent context (/llms.txt).

4. 🎨 Luxury Creative Agency Flagship:

   • Keep: All 34 Craft Primitives, especially SmoothScroll (Lenis 1.3), SignatureCanvas ($\phi=1.618$), ClipImageReveal, ProjectShowcase, CustomCursor, NoiseOverlay.
   • Action: Load high-resolution photography and fine-tune OKLCH brand hue.
   • Benefit: Awwwards 8.0+ craft scoring out-of-the-box.

---

Verifying the Virgin Clone

Always run the full verification suite before pushing to production:

# 1. Type & Schema Diagnostics (Must report 0 errors)
npm run check

# 2. 10-Gate Static Edge Purity Audit
npm run test:static

# 3. End-to-End Headless Browser Regression Suite
npm run test:e2e

# 4. Compile static edge artifacts to dist/
npm run build

---

Cloudflare Pages Edge Deployment

Push the new repository to GitHub or GitLab, or deploy directly via Wrangler:

npm run deploy

Deployment characteristics:

• Build Output Directory: dist
• Build Command: npm run build
• Node.js Compatibility: >= 18.20.8 (Node 20+ recommended)
• Edge Model: 100% Pure Static Edge (0 Workers invocations, 0 cold start, unlimited free-tier traffic).