# AI Ops Templates

A curated repository of templates, rules, snippets, and presets for AI-assisted development across all Abundance client projects.

## Purpose

This repository provides structured context that enables AI agents (like Cursor's Composer) to:
- Build features 10x faster with accurate brand/style context
- Follow established patterns without re-explanation
- Maintain consistency across all client projects
- Self-update context to prevent drift

## Structure

```
ai-ops-templates/
├── templates/           # Schema.org JSON-LD templates
│   ├── schema-product.json
│   ├── schema-event.json
│   ├── schema-local-business.json
│   └── schema-faq.json
├── rules/               # Development rules and guidelines
│   ├── tailwind-brand.json
│   ├── ui-fixes.json
│   ├── seo-rules.md
│   ├── common-fixes.md
│   └── ai-decision-guide.md
├── snippets/            # Reusable code components
│   ├── add-internal-link.tsx
│   ├── alt-text-placeholder.go
│   ├── breadcrumb.tsx
│   ├── vendor-card.tsx
│   ├── schema-inject.ts
│   └── deploy-webhook.sh
├── schemas/             # JSON schemas for validation
│   ├── ai-cli.schema.json
│   └── ai-context.schema.json
├── presets/             # Client brand presets
│   ├── slc-bride.json
│   └── default.json
├── context/             # Context tracking
│   ├── CHANGELOG.md
│   └── last-sync.json
├── skill-templates/     # Templates for client SKILL.md files
│   └── client-skill.template.md
└── .cursor/rules/       # Cursor-specific rules
    └── ai-context-update.md
```

## Usage

### For AI Agents

1. Read `.ai-context.json` in the project root first
2. Reference `presets/<client>.json` for brand rules
3. Use `snippets/` for component patterns
4. Check `rules/ai-decision-guide.md` for tool selection
5. Update context after making changes (see `.cursor/rules/ai-context-update.md`)

### For Humans

1. Copy `presets/default.json` to create new client presets
2. Use `skill-templates/client-skill.template.md` for new client SKILL.md files
3. Update `CHANGELOG.md` when making changes
4. Run `context/last-sync.json` updates via the MCP tool

## Per-Project Setup

Each client project needs:

1. **`.ai-cli.json`** - Project configuration (use `schemas/ai-cli.schema.json`)
2. **`.ai-context.json`** - Context manifest (use `schemas/ai-context.schema.json`)
3. **`.cursor/skills/{client}/SKILL.md`** - Client-specific skill file

## Self-Update Protocol

This repository uses a self-update protocol to prevent context drift. See `.cursor/rules/ai-context-update.md` for details.

Key triggers for updates:
- New feature added
- Brand changes
- New API endpoints
- Database schema changes
- Bug fixes that reveal patterns

## Adding New Clients

1. Create preset: `presets/{client-slug}.json`
2. Create skill file: `.cursor/skills/{client-slug}/SKILL.md`
3. Add to project: `.ai-cli.json` and `.ai-context.json`
4. Update this README if needed

## Repository URL

```
https://git.abundancepartners.app/abundance/ai-ops-templates
```

Raw file access:
```
https://git.abundancepartners.app/abundance/ai-ops-templates/raw/main/{path}
```

## Version

- **Version**: 1.0.0
- **Last Updated**: 2026-03-06
- **Maintained By**: AI Agent (auto-updated)