@grubtech/integration-agent/README.md

One-command installer that sets up the complete Grubtech Integration Agent (MCP server + AI agent personas) for Claude Code to help developers build restaurant and POS integrations.

# Grubtech Integration Agent

## What This Is

This is an easy setup tool for connecting your restaurant system with Grubtech. Just run one simple command, and it installs an AI helper inside your Claude Code app that answers questions and writes code for you.

## What You Can Do With This

- **Ask questions** about Grubtech and get instant answers
- **Get code examples** in TypeScript, Python, Java, or cURL
- **Build integrations faster** with AI-powered help
- **Search documentation** without opening a browser

## Who Should Use This

- Restaurant and POS developers
- Delivery platform engineers
- Anyone building integrations with Grubtech
- Technical teams at cloud kitchens

No prior Grubtech experience needed!

## How to Install

Go to your project directory, open your terminal and run this single command:

```bash
npx @grubtech/integration-agent init
```

That's it! Then restart Claude Code and start asking questions.

## What Features This Supports

**AI Chat Assistant**
- Ask any question about Grubtech APIs
- Get instant answers without searching docs
- Works directly inside Claude Code

**Code Generation**
- Authentication code
- Menu synchronization
- Order receiving from Grubtech
- Order status updates
- Item availability management

**Three AI Helpers**
- **Developer Agent**: For writing code and technical implementation
- **Business Analyst Agent**: For planning projects and gathering requirements
- **Integration Assistant Agent**: For technical support and answering API questions

**Documentation Search**
- Find information from Grubtech docs instantly
- No need to browse websites
- Works with natural language questions

## How to Use the AI Agents in Claude Code

**IMPORTANT:** The three AI helper agents are exclusive to Claude Code and will not work with other AI tools or IDEs.

After installation, you can activate any of the three specialized agents using slash commands:

### 1. Business Analyst Agent
**Command:** `/grubtech-ba`

**Use this for:**
- Planning new integrations
- Gathering requirements
- Creating technical specifications
- Understanding integration workflows
- Documenting your project

**Example:**
```
/grubtech-ba
I need to integrate our POS system with Grubtech. Help me understand what we need to build.
```

### 2. Developer Agent
**Command:** `/grubtech-dev`

**Use this for:**
- Writing production-ready code
- Implementing API integrations
- Building webhook handlers
- Creating authentication flows
- Technical implementation tasks

**Example:**
```
/grubtech-dev
Generate TypeScript code to receive orders from Grubtech and update our POS system.
```

### 3. Integration Assistant Agent
**Command:** `/grubtech-assistant`

**Use this for:**
- Answering API questions
- Troubleshooting integration issues
- Understanding endpoint documentation
- Getting technical support
- Clarifying API behavior

**Example:**
```
/grubtech-assistant
How do I update the order status when our kitchen accepts an order?
```

### General Tips
- Each agent has access to the full Grubtech documentation
- You can switch between agents at any time
- Agents will search docs and provide code examples automatically
- All agents work only within Claude Code - they cannot be used in other AI tools

## Example Usage

**You ask:**
```
How do I authenticate with Grubtech?
```

**AI responds with:**
Complete working code ready to use in your project.

**You ask:**
```
Help me build a menu sync integration
```

**AI responds with:**
Step-by-step guidance and code examples.

## What Grubtech Is

Grubtech is a restaurant technology platform for online ordering, menu management, and kitchen operations. If you're connecting your system to Grubtech, this tool makes the job easier.

**Learn more:**
- Website: https://www.grubtech.com
- Documentation: https://docs.grubtech.io
- Support: support@grubtech.com

## Getting Help

Just ask questions inside Claude Code after installation, or contact Grubtech support at support@grubtech.com

---

© 2025 Grubtech. All rights reserved.