ai-ops-templates/README.md
DMleadgen 3cb8d3cb3f Initial commit: AI Ops Templates repository
- Schema.org JSON-LD templates (product, event, local-business, faq)
- Brand, UI, SEO, and decision guide rules
- Working code snippets (vendor-card, schema-inject, deploy-webhook)
- JSON schemas for project config validation
- Client presets (slc-bride, default)
- Self-update protocol with changelog tracking

Made-with: Cursor
2026-03-06 16:03:31 -07:00

108 lines
3.4 KiB
Markdown

# 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)