- 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
108 lines
3.4 KiB
Markdown
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)
|