Extending the Framework

VibeReady’s AI framework is self-extending. Use skill-builder and rule-builder to add domain-specific skills and rules without manually editing framework files.

Currently supported in Claude Code only. Other AI tools can use the created skills and rules but cannot run the builder skills.

---

When to Extend

Extend When	Example
You repeat a multi-step workflow	Invoice generation, user onboarding
Your domain has specific patterns	Healthcare compliance, e-commerce catalog
A scoped rule would prevent recurring mistakes	Payment processing, email templates
You want AI to follow a consistent process	Data import pipelines, report generation

---

Creating a Custom Skill

Use skill-builder to generate a new Agent Skill with proper structure:

"Use the skill-builder skill to create a skill for e-commerce product creation."

What it does:

1. Creates docs/ai-context/skills/{name}/SKILL.md with frontmatter, gates, and checklist
2. Creates docs/ai-context/skills/{name}/references/ with relevant templates
3. Updates the skills list in AGENTS.md
4. Runs validation to confirm everything is wired up

What you get:

docs/ai-context/skills/create-product/
├── SKILL.md          # Gate-based workflow with pre-flight checkpoint
└── references/       # Domain-specific templates and checklists

The generated skill follows the same agentskills.io standard as all built-in skills — meaning it works across Claude Code, Cursor, Windsurf, and other compatible tools.

---

Creating a Scoped Rule

Use rule-builder to generate a new scoped rule that auto-loads when editing matching files:

"Use the rule-builder skill to create a rule for payment processing patterns."

What it does:

1. Creates docs/ai-context/rules/{name}.md with glob patterns, principles, and anti-patterns
2. Updates stack-manifest.md if the rule is technology-specific
3. Runs make ai-setup to generate per-tool rule files

What you get:

A rule that auto-loads whenever the AI edits files matching your globs. For example, a payments rule with globs: ["src/services/billing*.ts", "src/app/api/billing/**"] loads automatically when those files are touched.

---

Example: Vertical-Specific Extension

For an e-commerce project, you might create:

Type	Name	Purpose
Skill	create-product	Multi-step workflow for adding products with variants, pricing, inventory
Skill	order-flow	Order processing with payment, fulfillment, notifications
Rule	e-commerce	Patterns for cart logic, inventory checks, price calculations

1. "Use the skill-builder skill to create a skill for product catalog management."
2. "Use the skill-builder skill to create a skill for order processing."
3. "Use the rule-builder skill to create a rule for e-commerce patterns."
4. Run: make ai-setup

After this, any AI tool editing product or order files will automatically load your domain patterns.

---

Validation

After creating skills or rules, verify everything is connected:

make validate-ai     # Confirms new skills are detected
make ai-setup        # Regenerates per-tool rules

---

Next Steps:

• Learn about agents: Advanced Agents
• See all skills: Prompt Library
• Swap technologies: Stack Customization