create-universal-ai-context 2.0.0

package/templates/handlebars/antigravity.hbs

@@ -0,0 +1,337 @@
+{{!--
+  Google Antigravity Template
+  Generates multiple files for .agent/ directory:
+  - rules/*.md - Workspace rules by category
+  - workflows/*.md - On-demand /commands
+  - skills/*.md - Modular capabilities
+--}}
+
+{{!-- ============================================================ --}}
+{{!-- RULES: Main Project Identity                                  --}}
+{{!-- ============================================================ --}}
+{{{fileStart "rules/identity.md"}}}
+<!-- Auto-generated by AI Context Engineering v{{metadata.generator_version}} -->
+<!-- Generated: {{metadata.timestamp}} -->
+
+# {{project.name}} - Project Identity
+
+## Overview
+
+- **Name:** {{project.name}}
+- **Description:** {{project.description}}
+- **Tech Stack:** {{join project.tech_stack ", "}}
+- **Primary Language:** {{project.primary_language}}
+
+## Quick Commands
+
+{{#each commands}}
+- **{{@key}}:** `{{this}}`
+{{/each}}
+
+## Architecture
+
+**Pattern:** {{architecture.pattern}}
+
+{{#if architecture.layers}}
+**Layers:**
+{{#each architecture.layers}}
+- `{{path}}` - {{purpose}}
+{{/each}}
+{{/if}}
+
+## Key Entry Points
+
+{{#each key_files.entry_points}}
+- `{{this}}`
+{{/each}}
+
+{{#if environment.required}}
+## Environment Variables
+
+**Required:**
+{{#each environment.required}}
+- `{{this}}`
+{{/each}}
+
+{{#if environment.optional}}
+**Optional:**
+{{#each environment.optional}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+{{/if}}
+{{{fileEnd}}}
+
+{{!-- ============================================================ --}}
+{{!-- RULES: Architecture Details                                   --}}
+{{!-- ============================================================ --}}
+{{{fileStart "rules/architecture.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# Architecture Rules for {{project.name}}
+
+## Pattern: {{architecture.pattern}}
+
+{{#each architecture.layers}}
+### Layer: {{name}}
+
+**Path:** `{{path}}`
+**Purpose:** {{purpose}}
+
+{{/each}}
+
+## Key Files by Category
+
+{{#if key_files.entry_points}}
+### Entry Points
+{{#each key_files.entry_points}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.api_routes}}
+### API Routes
+{{#each key_files.api_routes}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.config}}
+### Configuration
+{{#each key_files.config}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+{{{fileEnd}}}
+
+{{!-- ============================================================ --}}
+{{!-- RULES: Gotchas (Critical Issues)                              --}}
+{{!-- ============================================================ --}}
+{{{fileStart "rules/gotchas.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# Critical Gotchas for {{project.name}}
+
+These are known issues and pitfalls. Review before making changes.
+
+{{#if gotchas}}
+{{#each gotchas}}
+## {{id}}: {{title}}
+
+**Severity:** {{severity}}
+
+**Symptom:** {{symptom}}
+
+**Fix:**
+```
+{{fix}}
+```
+
+---
+
+{{/each}}
+{{else}}
+*No gotchas documented yet. Add as discovered.*
+{{/if}}
+{{{fileEnd}}}
+
+{{!-- ============================================================ --}}
+{{!-- RULES: Constraints                                            --}}
+{{!-- ============================================================ --}}
+{{{fileStart "rules/constraints.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# Critical Constraints for {{project.name}}
+
+These rules MUST be followed. Violations may cause production issues.
+
+{{#if critical_constraints}}
+{{#each critical_constraints}}
+{{@index}}. {{this}}
+{{/each}}
+{{else}}
+*No constraints documented yet. Add critical rules as identified.*
+{{/if}}
+
+## Summary
+
+- Total Constraints: {{length critical_constraints}}
+- Gotchas: {{length gotchas}}
+- Workflows: {{length workflows}}
+{{{fileEnd}}}
+
+{{!-- ============================================================ --}}
+{{!-- RULES: Workflows Summary                                      --}}
+{{!-- ============================================================ --}}
+{{{fileStart "rules/workflows.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# Available Workflows for {{project.name}}
+
+{{#if workflows}}
+{{#each workflows}}
+## {{name}}
+
+**Category:** {{category}} | **Complexity:** {{complexity}}
+
+{{description}}
+
+{{#if entry_points}}
+**Entry Points:**
+{{#each (first entry_points 5)}}
+- `{{endpoint}}` - {{file}}:{{line}}
+{{/each}}
+{{/if}}
+
+---
+
+{{/each}}
+{{else}}
+*No workflows discovered. Run AI analysis to populate.*
+{{/if}}
+{{{fileEnd}}}
+
+{{!-- ============================================================ --}}
+{{!-- WORKFLOWS: Command Files                                      --}}
+{{!-- ============================================================ --}}
+
+{{{fileStart "workflows/run.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# /run - Start Development Server
+
+## Command
+```bash
+{{commands.dev}}
+```
+
+## Description
+Starts the {{project.name}} development server.
+
+## Prerequisites
+- All dependencies installed
+- Environment variables configured
+
+## Related
+- See `rules/identity.md` for full command list
+{{{fileEnd}}}
+
+{{{fileStart "workflows/test.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# /test - Run Test Suite
+
+## Command
+```bash
+{{commands.test}}
+```
+
+## Description
+Runs the test suite for {{project.name}}.
+
+## Tips
+- Run before committing changes
+- Check test coverage reports
+{{{fileEnd}}}
+
+{{{fileStart "workflows/build.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# /build - Build Project
+
+## Command
+```bash
+{{commands.build}}
+```
+
+## Description
+Builds {{project.name}} for production.
+{{{fileEnd}}}
+
+{{!-- ============================================================ --}}
+{{!-- SKILLS: Modular Capabilities                                  --}}
+{{!-- ============================================================ --}}
+
+{{{fileStart "skills/debugging.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# Debugging Skill for {{project.name}}
+
+## When to Use
+Activate this skill when debugging issues in {{project.name}}.
+
+{{#if gotchas}}
+## Known Issues
+
+{{#each gotchas}}
+### {{id}}: {{title}}
+
+**Severity:** {{severity}}
+
+**Symptom:** {{symptom}}
+
+**Quick Fix:**
+```
+{{truncate fix 200}}
+```
+
+{{/each}}
+{{/if}}
+
+## Debug Commands
+
+```bash
+# Start dev server
+{{commands.dev}}
+
+# Run tests
+{{commands.test}}
+```
+
+## Tips
+
+- Check application logs for errors
+- Review stack traces carefully
+- Verify environment configuration
+{{{fileEnd}}}
+
+{{{fileStart "skills/implementation.md"}}}
+<!-- Auto-generated by AI Context Engineering -->
+
+# Implementation Skill for {{project.name}}
+
+## When to Use
+Activate this skill when implementing new features in {{project.name}}.
+
+## Architecture Overview
+
+**Pattern:** {{architecture.pattern}}
+
+{{#if architecture.layers}}
+**Layers:**
+{{#each architecture.layers}}
+- `{{path}}` - {{purpose}}
+{{/each}}
+{{/if}}
+
+## Code Standards
+
+1. Follow existing patterns in the codebase
+2. Add tests for new functionality
+3. Update documentation as needed
+4. Review gotchas before modifying critical areas
+
+## Key Files to Reference
+
+{{#each key_files.entry_points}}
+- `{{this}}`
+{{/each}}
+
+{{#if critical_constraints}}
+## Constraints to Follow
+
+{{#each critical_constraints}}
+- {{this}}
+{{/each}}
+{{/if}}
+{{{fileEnd}}}

package/templates/handlebars/claude.hbs

@@ -0,0 +1,184 @@
+{{!-- Claude/Universal AI Context Template --}}
+{{> header}}
+
+# AI_CONTEXT.md - {{project.name}}
+
+This file provides guidance to AI coding assistants when working with this repository.
+
+---
+
+## Project Identity
+
+**Platform:** {{project.description}}
+**Tech Stack:** {{join project.tech_stack ", "}}
+**Primary Language:** {{project.primary_language}}
+**Status:** Development
+
+---
+
+## Essential Commands
+
+### Development
+```bash
+{{commands.install}}
+{{commands.dev}}
+```
+
+### Testing
+```bash
+{{commands.test}}
+```
+
+### Build
+```bash
+{{commands.build}}
+```
+
+---
+
+## Architecture
+
+**Pattern:** {{architecture.pattern}}
+
+{{#if architecture.layers}}
+### Layers
+
+| Layer | Path | Purpose |
+|-------|------|---------|
+{{#each architecture.layers}}
+| {{name}} | `{{path}}` | {{purpose}} |
+{{/each}}
+{{/if}}
+
+---
+
+## Key Files
+
+{{#if key_files.entry_points}}
+### Entry Points
+{{#each key_files.entry_points}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.api_routes}}
+### API Routes
+{{#each key_files.api_routes}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.config}}
+### Configuration
+{{#each key_files.config}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+---
+
+## Workflows
+
+{{#if workflows}}
+{{#each workflows}}
+### {{name}}
+
+**Category:** {{category}} | **Complexity:** {{complexity}}
+
+{{description}}
+
+{{#if entry_points}}
+**Entry Points:**
+{{#each entry_points}}
+- `{{endpoint}}` - {{file}}:{{line}} ({{method}})
+{{/each}}
+{{/if}}
+
+{{#if files}}
+**Files:**
+{{#each (first files 5)}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+---
+
+{{/each}}
+{{else}}
+*No workflows discovered. Run AI analysis to populate.*
+{{/if}}
+
+---
+
+## Navigation Rules
+
+### High-Level Task
+1. Start: [.ai-context/context/WORKFLOW_INDEX.md](./.ai-context/context/WORKFLOW_INDEX.md)
+2. Load relevant workflow
+3. Implement with context
+
+### Feature Development
+1. /rpi-research - Explore codebase
+2. /rpi-plan - Create blueprint
+3. /rpi-implement - Execute with tests
+
+---
+
+## Documentation System
+
+**Navigation:** 3-level chain (AI_CONTEXT.md → Category → Domain → Detail)
+**Validation:** Run /verify-docs-current after modifications
+**RPI Workflow:** /rpi-research → /rpi-plan → /rpi-implement
+
+See: [.ai-context/RPI_WORKFLOW_PLAN.md](./.ai-context/RPI_WORKFLOW_PLAN.md)
+
+---
+
+{{#if gotchas}}
+## Critical Gotchas
+
+{{> gotcha-list}}
+{{/if}}
+
+---
+
+{{#if critical_constraints}}
+## Critical Constraints
+
+{{#each critical_constraints}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+{{#if environment.required}}
+## Environment Variables
+
+**Required:**
+{{#each environment.required}}
+- `{{this}}`
+{{/each}}
+
+{{#if environment.optional}}
+**Optional:**
+{{#each environment.optional}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+{{/if}}
+
+---
+
+## AI Tools Configuration
+
+This context is optimized for:
+- **Claude Code** - Full context reading (this file)
+- **GitHub Copilot** - See `.github/copilot-instructions.md`
+- **Cline** - See `.clinerules`
+- **Antigravity** - See `.agent/` directory
+
+---
+
+*Auto-generated by AI Context Engineering v{{metadata.generator_version}}*
+*Regenerate with: `npx create-ai-context generate`*

package/templates/handlebars/cline.hbs

@@ -0,0 +1,63 @@
+{{!-- Cline Rules Template - Compact format for Cline VS Code extension --}}
+# {{project.name}} - Cline Rules
+# Generated: {{metadata.timestamp}}
+
+[identity]
+name={{project.name}}
+description={{project.description}}
+stack={{join project.tech_stack ", "}}
+lang={{project.primary_language}}
+
+[architecture]
+pattern={{architecture.pattern}}
+{{#each architecture.layers}}
+layer.{{@index}}={{name}}={{path}}
+{{/each}}
+
+[entry_points]
+{{#each key_files.entry_points}}
+{{@index}}={{this}}
+{{/each}}
+
+[commands]
+{{#each commands}}
+{{@key}}={{this}}
+{{/each}}
+
+{{#if workflows}}
+[workflows]
+{{#each workflows}}
+{{slugify name}}={{category}}/{{complexity}}
+{{/each}}
+{{/if}}
+
+{{#if gotchas}}
+[gotchas]
+{{#each gotchas}}
+{{id}}={{severity}} | {{title}}
+{{/each}}
+{{/if}}
+
+{{#if critical_constraints}}
+[constraints]
+{{#each critical_constraints}}
+{{@index}}={{this}}
+{{/each}}
+{{/if}}
+
+{{#if environment.required}}
+[env.required]
+{{#each environment.required}}
+{{@index}}={{this}}
+{{/each}}
+{{/if}}
+
+{{#if environment.optional}}
+[env.optional]
+{{#each environment.optional}}
+{{@index}}={{this}}
+{{/each}}
+{{/if}}
+
+# Auto-generated by AI Context Engineering v{{metadata.generator_version}}
+# Regenerate: npx create-ai-context generate --ai cline

package/templates/handlebars/copilot.hbs

@@ -0,0 +1,131 @@
+{{!-- GitHub Copilot Instructions Template --}}
+{{> header}}
+
+# {{project.name}} - Copilot Instructions
+
+## Project Identity
+
+- **Name:** {{project.name}}
+- **Description:** {{project.description}}
+- **Tech Stack:** {{join project.tech_stack ", "}}
+- **Primary Language:** {{project.primary_language}}
+
+---
+
+## Architecture
+
+**Pattern:** {{architecture.pattern}}
+
+{{#if architecture.layers}}
+**Layers:**
+{{#each architecture.layers}}
+- `{{path}}` - {{purpose}}
+{{/each}}
+{{/if}}
+
+---
+
+## Key Files
+
+{{#if key_files.entry_points}}
+### Entry Points
+{{#each key_files.entry_points}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.api_routes}}
+### API Routes
+{{#each key_files.api_routes}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.config}}
+### Configuration
+{{#each key_files.config}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+---
+
+## Commands
+
+| Command | Script |
+|---------|--------|
+{{#each commands}}
+| {{@key}} | `{{this}}` |
+{{/each}}
+
+---
+
+{{#if workflows}}
+## Relevant Workflows
+
+{{#each workflows}}
+### {{name}}
+
+**Category:** {{category}} | **Complexity:** {{complexity}}
+
+{{description}}
+
+{{#if entry_points}}
+**Entry Points:**
+{{#each entry_points}}
+- `{{endpoint}}` - {{file}}:{{line}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+---
+
+{{#if gotchas}}
+## Critical Gotchas
+
+{{#each gotchas}}
+### {{id}}: {{title}}
+
+**Severity:** {{severity}}
+
+{{symptom}}
+
+**Fix:** {{fix}}
+
+{{/each}}
+{{/if}}
+
+---
+
+{{#if critical_constraints}}
+## Critical Constraints
+
+{{#each critical_constraints}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+{{#if environment.required}}
+## Environment Variables
+
+**Required:**
+{{#each environment.required}}
+- `{{this}}`
+{{/each}}
+
+{{#if environment.optional}}
+**Optional:**
+{{#each environment.optional}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+{{/if}}
+
+---
+
+*Auto-generated by AI Context Engineering v{{metadata.generator_version}}*
+*Regenerate with: `npx create-ai-context generate --ai copilot`*

package/templates/handlebars/partials/gotcha-list.hbs

@@ -0,0 +1,11 @@
+{{!-- Reusable gotcha list partial --}}
+{{#each gotchas}}
+### {{id}}: {{title}}
+
+**Severity:** {{severity}}
+
+{{symptom}}
+
+**Fix:** {{truncate fix 100}}
+
+{{/each}}

package/templates/handlebars/partials/header.hbs

@@ -0,0 +1,3 @@
+{{!-- Reusable header partial --}}
+{{{metadata.header}}}
+<!-- Generated: {{metadata.timestamp}} | Version: {{metadata.generator_version}} -->