BASE 🧬

The official Antigravity starter template — pre-configured agent skills, strict guardrails, and battle-tested workflows for production-grade full-stack development.

---

✨ What is BASE?

• Dozens of Expert Skills (categorized for full-stack excellence):
  • Architecture: Brainstorming, persistent multi-session Planning, Context Engineering
  • Database: Deep Prisma Expertise, PostgreSQL Design, Migration Safety Guardrails
  • Frontend: Tailwind Design Systems, Radix UI, Shadcn, Taste Engine + Anti-Slop Guard
  • Reliability: TDD Enforcer, Systematic Debugging, WCAG 2.2 Accessibility Audits, Playwright E2E & Visual QA
  • Operations: Terraform IaC, Changelog Automation, Git Worktree Isolation
• GStack-powered Continuous Checkpoints (mandatory trajectory persistence)
• 10x Product Strategy (structured opportunity discovery & prioritization)
• Adversarial Content Factory (4-skill article production pipeline: Dialectic Research + Red Team review)
• Closed-Loop Documentation Health: RAG-based drift detection + link integrity audits.
• Agent Self-Improvement Meta Layer: Autonomous self-evolution loop (Audit → Propose → Verify → PR) using Mastra.
• Agent-Native CI/CD Orchestration: Automated matrix workflows + OpenTelemetry metrics.
• UI/UX Pro Max (161 color palettes, 99 UX guidelines, and 10 tech stacks)
• Taste Engine + Anti-Slop Guard (opt-in advanced personalization & quality)

Clone this repo into any new project (or fork it) and your Antigravity agents will immediately operate with professional structure, extreme safety, and high-velocity design intelligence.

---

🚀 Quick Start

1. Fork or clone this repository:

   git clone https://github.com/JackSmack1971/BASE.git my-new-project
   cd my-new-project

2. Open in Antigravity (or Cursor/VS Code with Antigravity).

3. Start using the new GStack features:

   • context-save [message] — manual checkpoint
   • checkpoint-status — see trajectory health
   • (Opt-in) Enable Taste Engine & Anti-Slop in .antigravity-local.md

---

🏛️ Monorepo Architecture

BASE is now a high-velocity Turborepo Monorepo, ensuring modularity, shared configuration, and lightning-fast builds across frontend and backend services.

• Command Central: Use npx turbo run <task> to execute across all packages.
• Packages: Internal utilities and shared configurations live in packages/.
• Apps: Deployable services (Frontend/Backend) live in apps/.
• Caching: Local and Remote caching enabled for sub-100ms developer iteration.

---

📚 Documentation Health (RAG-Integrated)

We've implemented a closed-loop documentation maintenance system using @repo/rag-utils. It projectively prevents "Documentation Rot" through automated CI gates.

• Link Integrity: Automated validation of all Markdown links (internal and external).
• Semantic Drift: RAG-based scoring to detect when code and documentation diverge conceptually.
• Audit Task: npx turbo run docs-rot-audit triggers a full health scan.
• Indexing: npx turbo run index-rag generates embeddings for expert skill discovery.

---

🛡️ Core Safety (Mandatory)

Continuous Checkpoints — Never lose hours of work again

Automatically saves mental model + Git patch before any destructive operation.

• Commands: context-save [msg], context-restore [id|latest], checkpoint-status
• Storage: Local .agents/checkpoints/ + hidden checkpoint/* branch
• Enforced in every session via _master.md

---

🧪 Skill Testing (Automated BDD)

All core skill scripts are now backed by a deterministic ShellSpec (Bash BDD) testing framework. This ensures that expert intelligence remains reliable across different environments.

• Requirement: All new or modified skill scripts must include a corresponding ShellSpec test suite in the spec/ directory.
• Run Tests (Windows): Use the native PowerShell wrapper:

  .\tests\test-skills.ps1

• Infrastructure: Uses ShellSpec for Bash unit testing with full mocking of git, date, and filesystem operations.

---

🎨 Advanced Intelligence (Opt-in)

Taste Engine

Learns your personal aesthetic preferences (fonts, colors, layout density, design style) across sessions.

• Enable: enable_taste_engine: true in .antigravity-local.md
• Commands: synchronize-taste approve/reject …, apply-style-tokens

Anti-Slop Guard

Automatically flags and prevents generic AI design patterns (indigo drift, uniform radii, SaaS clichés, etc.).

• Enable: enable_anti_slop_guard: true in .antigravity-local.md
• Triggers on all .tsx, .jsx, .css files

---

📁 Project Structure

BASE/
├── apps/                    # Deployable applications (Next.js, Express, etc.)
├── packages/                # Shared utilities & RAG tools (@repo/rag-utils)
├── .agents/                 # Core agent intelligence
│   ├── rules/               # Global + domain rules
│   ├── skills/              # Expert scripts (checkpoint-manager, etc.)
├── docs/                    # Global project documentation
├── turbo.json               # Monorepo orchestration config
├── AGENTS.md                # Master routing + persona
└── README.md

---

🔥 Key Skills & Workflows

• agent-self-improvement-meta → Autonomous self-healing PR loop using Mastra
• documentation-rot-guard → Semantic drift & link integrity enforcement
• ci-cd-orchestrator → Agent-native matrixed delivery pipeline
• opentelemetry-expert → Tracing + metrics + self-diagnostic spans
• checkpoint-manager → GStack-style trajectory persistence
• agent-browser → Professional browser automation & Slack control
• design-review → Senior designer audits & atomic UI fixes
• context-compact → Phase-based trajectory summarization & state preservation
• taste-engine → Personalized design intelligence
• anti-slop-guard → Aesthetic quality enforcement
• playwright-visual-regression → Next.js visual QA & self-healing E2E
• db-migration, tdd-enforcer, security-audit, frontend-verify, etc.

---

🛠️ How to Extend

1. Add new skills in .agents/skills/
2. Add new rules in .agents/rules/
3. Update routing in AGENTS.md
4. (Optional) Train your Taste Engine with synchronize-taste

All changes stay compliant with moderate modularity and non-negotiable safety guardrails.

---

📜 License

MIT © JackSmack1971

🤝 Contributing

Contributions that improve safety, add high-value skills, or tighten GStack integrations are welcome.

---

Made for Antigravity • April 2026 Playbook with GStack Integration