npm package: @grubtech/integration-personas
Description: Agent personas and slash commands for Claude Code to help with Grubtech API integration (Business Analyst, Developer, and Integration Assistant agents).
Author: Grubtech
Latest version: 1.0.7

# 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:**
```bash
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:** support@grubtech.com
**Documentation:** https://docs.grubtech.io
**Website:** https://www.grubtech.com

© 2025 Grubtech. All rights reserved.