Grubtech Integration Personas

Three specialized AI agents for Claude Code to help you build Grubtech API integrations.

What This Is

Agent personas that customize Claude Code's behavior for different integration tasks. Each agent has comprehensive knowledge of Grubtech APIs and uses documentation search tools to provide accurate, fact-based guidance.

Installation:

npx @grubtech/integration-agent init

The Three Agents

👨‍💼 Business Analyst (/grubtech-ba)

Plans and documents your integration project.

What it does:

• Asks questions about your restaurant/POS system
• Creates technical requirements documents
• Generates architecture and data flow diagrams
• Provides integration checklists

Use for:

• Starting new integration projects
• Planning integration scope
• Understanding which Grubtech APIs you need
• Creating documentation for developers

Example:

/grubtech-ba
"Help me plan a menu synchronization integration"

👨‍💻 Developer (/grubtech-dev)

Generates production-ready code for your integration.

What it does:

• Writes code in TypeScript, Python, Java, or cURL
• Implements authentication (OAuth 2.0, API Key)
• Creates webhook handlers
• Builds API clients
• Includes error handling and logging

Use for:

• Implementing code after requirements are defined
• Building webhook endpoints
• Creating API integration clients
• Debugging code issues

Example:

/grubtech-dev
"Generate TypeScript code for OAuth authentication"

🛠️ Integration Assistant (/grubtech-assistant)

Provides technical support and answers API questions.

What it does:

• Answers technical questions about Grubtech APIs
• Provides architecture recommendations
• Explains integration patterns
• Troubleshoots integration issues
• Clarifies API documentation

Use for:

• Quick technical questions during development
• Understanding API behavior
• Architecture decisions
• Troubleshooting problems

Example:

/grubtech-assistant
"How does webhook signature validation work?"

How to Use

Step 1: Planning

/grubtech-ba
"I need to integrate my POS with Grubtech for menu sync and orders"

→ Creates requirements document

Step 2: Implementation

/grubtech-dev
"Generate code for the requirements"

→ Generates production-ready code

Step 3: Support

/grubtech-assistant
"How do I test the OAuth flow?"

→ Provides technical guidance

What's Included

Agent Files: (installed to .claude/agents/)

• Business Analyst agent
• Developer agent
• Integration Assistant agent

Slash Commands: (installed to .claude/commands/)

• /grubtech-ba - Business Analyst
• /grubtech-dev - Developer
• /grubtech-assistant - Integration Assistant

Key Features

All agents have:

• Complete Grubtech API knowledge (100+ documentation pages)
• Documentation search capability (14,000+ chunks)
• Anti-hallucination protocol (only fact-based answers)
• Source URL citations from docs.grubtech.io

All agents follow:

• ✅ Search documentation before answering
• ✅ Provide only information from official docs
• ✅ Cite source URLs
• ❌ No pricing or timeline discussions
• ❌ No made-up endpoints or payloads

Related Packages

• @grubtech/integration-agent - Main installer
• @grubtech/integration-mcp-server - Documentation search server
• @grubtech/integration-personas - This package
• @grubtech/integration-core - Shared utilities

Support: [email protected] Documentation: https://docs.grubtech.io Website: https://www.grubtech.com

© 2025 Grubtech. All rights reserved.