Partner Onboarding Kit — FrootAI Integration Guide

community-plugins/
└── your-platform/
    ├── plugin.json          # Required — plugin manifest
    ├── README.md            # Required — install guide + architecture
    ├── agents/              # Optional — platform-specific agents
    │   └── your-agent.agent.md
    ├── skills/              # Optional — platform-specific skills
    │   └── your-skill/
    │       └── SKILL.md
    ├── instructions/        # Optional — platform-specific coding standards
    │   └── your-platform.instructions.md
    └── hooks/               # Optional — platform-specific lifecycle hooks
        └── your-hook/
            ├── hooks.json
            └── script.sh

{
  "name": "your-platform",
  "description": "FrootAI integration for YourPlatform — [what it does]",
  "version": "1.0.0",
  "author": {
    "name": "Your Company",
    "url": "https://yourplatform.com"
  },
  "license": "MIT",
  "keywords": ["your-platform", "integration", "mcp", "enterprise"],
  "plays": ["05-it-ticket-resolution", "54-ai-customer-support-v2"],
  "primitives": {
    "agents": ["agents/your-agent.agent.md"],
    "skills": ["skills/your-skill/"],
    "instructions": ["instructions/your-platform.instructions.md"],
    "hooks": []
  },
  "mcp": {
    "tools": ["your_platform_search", "your_platform_create", "your_platform_update"],
    "transport": "stdio"
  },
  "requirements": {
    "node": ">=18",
    "apiAccess": "YourPlatform API key or OAuth2 credentials"
  }
}

---
description: "AI agent for YourPlatform — [primary capability]"
tools: ["your_platform_search", "your_platform_create"]
waf: ["security", "reliability", "operational-excellence"]
plays: ["05-it-ticket-resolution"]
---
 
# YourPlatform AI Agent
 
You are an expert in YourPlatform integration. You help users:
- Search and retrieve records from YourPlatform
- Create and update records via API
- Map YourPlatform data to FrootAI solution play schemas
- Follow YourPlatform API best practices and rate limits
 
## Authentication
Always use OAuth2 or managed credentials. Never hardcode API keys.
 
## Rate Limiting
Respect YourPlatform API limits: [specify limits]
 
## Error Handling
On 429 (rate limit): exponential backoff with jitter
On 401 (auth): prompt for credential refresh
On 5xx: retry with circuit breaker (3 attempts, 30s cooldown)

# Validate plugin structure
npm run validate:primitives
 
# Check JSON syntax
node -e "require('./community-plugins/your-platform/plugin.json')"
 
# Verify agent frontmatter
# (description 10+ chars, name kebab-case)