@chanaka_nakandala/integration-personas 1.0.0 → 1.0.2

package/README.md

@@ -1,114 +1,104 @@
-# Grubtech Agent Personas
+# Grubtech Integration Personas
 
-**Claude Code agent personas for Grubtech API integrations**
+## What This Is
 
-This package contains YAML configuration files that customize Claude's behavior for Grubtech API integration tasks.
-
-## What's Included
-
-### 1. Developer Agent (`developer-agent.yaml`)
-**Technical, code-first responses**
-
-- Generates production-ready code in TypeScript, Python, Java, or cURL
-- Provides API specifications and technical details
-- Helps debug API errors with specific solutions
-- Follows language best practices, SOLID principles, and design patterns
-
-**When to use:** You're ready to write integration code
-
-### 2. BA Agent (`ba-agent.yaml`)
-**Planning, requirements, documentation**
-
-- Conducts comprehensive requirement elicitation
-- Asks discovery questions (integration type, tech stack, hosting, team)
-- Generates complete project requirement documents with Mermaid diagrams
-- Provides process guidance and go-live checklists
-
-**When to use:** You're starting a new integration project
-
-## Installation
-
-**You don't need to install this package directly!**
-
-This package is automatically installed when you run:
+This package contains personality settings for the AI assistant in Claude Code. These settings make Claude behave differently depending on what you're trying to do - planning a project or writing code.
 
+**Note:** You don't install this directly. Use the main installer instead:
 ```bash
 npx @chanaka_nakandala/integration-agent init
 ```
 
-The installer will:
-1. Download these YAML files
-2. Copy them to `~/.claude/agents/`
-3. Make them available in Claude Code's persona menu
+## What This Does
 
-## Manual Installation
+Provides two different AI personalities for Claude Code:
 
-If you want to install manually:
+**Developer Agent**
+- Writes code for you
+- Answers technical questions
+- Helps fix errors
+- Gives you working examples
 
-1. Download this package:
-```bash
-npm install @chanaka_nakandala/agent-personas
-```
+**Business Analyst Agent**
+- Helps plan your project
+- Asks questions to understand your needs
+- Creates requirement documents
+- Makes diagrams showing how things work
 
-2. Copy YAML files to Claude's agents directory:
-```bash
-# Linux/macOS
-cp node_modules/@chanaka_nakandala/agent-personas/*.yaml ~/.claude/agents/
-
-# Windows
-copy node_modules\@chanaka_nakandala\agent-personas\*.yaml %USERPROFILE%\.claude\agents\
-```
+## What Features This Supports
 
-3. Restart Claude Code
+**Developer Agent Features:**
+- Generates code in TypeScript, Python, Java, or cURL
+- Creates authentication examples
+- Builds menu sync code
+- Makes order receiving webhooks
+- Writes status update code
+- Handles item availability
 
-4. Select persona from the personas menu
+**Business Analyst Agent Features:**
+- Asks about your restaurant system
+- Finds out what you need to build
+- Creates project plans
+- Makes architecture diagrams
+- Writes requirement documents
+- Provides go-live checklists
 
-## Usage
+## How to Use
 
-After installation, select an agent persona in Claude Code:
+After installing, you'll see two options in Claude Code:
 
-### Start with BA Agent
+**Step 1: Use BA Agent First (For Planning)**
+Select "Grubtech Integration BA" and ask:
 ```
-"Help me plan my restaurant POS integration with Grubtech"
+Help me plan my integration with Grubtech
 ```
 
-The BA Agent will:
-- Ask discovery questions about your system
-- Create a requirements document
-- Provide architecture diagrams
-- Hand off to Developer Agent
+The AI will ask you questions and create a plan.
 
-### Then use Developer Agent
+**Step 2: Use Developer Agent Next (For Coding)**
+Select "Grubtech Integration Developer" and ask:
 ```
-"I have the requirements document. Generate TypeScript authentication code"
+Generate code to authenticate with Grubtech
 ```
 
-The Developer Agent will:
-- Generate production-ready code
-- Include error handling and logging
-- Follow best practices
-- Provide implementation guidance
+The AI will write the code for you.
+
+## What's Included
+
+Two configuration files:
+- `developer-agent.yaml` - Settings for the code-writing personality
+- `ba-agent.yaml` - Settings for the planning personality
+
+These files tell Claude how to behave when helping you.
+
+## How It Works
 
-## Files
+1. The installer copies these files to your computer
+2. Claude Code reads them and creates two AI personalities
+3. You pick which personality to use
+4. Claude helps you based on that personality
 
-- `developer-agent.yaml` - Developer Agent configuration (20.8 kB)
-- `ba-agent.yaml` - BA Agent configuration (23.4 kB)
+## Getting Help
 
-## Part of Grubtech Integration Agent
+You shouldn't need to interact with this package directly. If the AI personalities aren't showing up:
 
-This package is part of the Grubtech Integration Agent toolkit:
+1. Try reinstalling: `npx @chanaka_nakandala/integration-agent init`
+2. Restart Claude Code
+3. Look for the personas menu in Claude Code
+4. Contact Grubtech support: support@grubtech.com
 
-- **@chanaka_nakandala/integration-agent** - Installer (use this!)
-- **@chanaka_nakandala/mcp-server** - MCP server
-- **@chanaka_nakandala/agent-personas** - Agent personas (this package)
-- **@chanaka_nakandala/agent-core** - Shared types
+## Related Packages
 
-## Links
+This is part of the Grubtech Integration Agent system:
+- `@chanaka_nakandala/integration-agent` - Main installer (use this!)
+- `@chanaka_nakandala/integration-mcp-server` - Background engine
+- `@chanaka_nakandala/integration-personas` - This package
+- `@chanaka_nakandala/integration-core` - Shared code
 
-- **Grubtech Website:** https://www.grubtech.com
-- **API Documentation:** https://docs.grubtech.io
-- **Support:** support@grubtech.io
+**Learn more:**
+- Grubtech Website: https://www.grubtech.com
+- API Documentation: https://docs.grubtech.io
 
-## License
+---
 
-MIT © Grubtech
+© 2025 Grubtech. All rights reserved.

package/ba-agent.yaml

@@ -525,13 +525,13 @@ context: |
   # Escalation Criteria
 
   **Technical Implementation Questions:**
-  → Switch to Developer Agent or contact support@grubtech.io
+  → Switch to Developer Agent or contact support@grubtech.com
 
   **Account-Specific Issues:**
-  → Contact Partnership Manager or support@grubtech.io
+  → Contact Partnership Manager or support@grubtech.com
 
   **API Bugs or Outages:**
-  → Report to support@grubtech.io with details
+  → Report to support@grubtech.com with details
 
   **Business/Contract Questions:**
   → Contact Partnership Manager

package/developer-agent.yaml

@@ -566,7 +566,7 @@ guidelines: |
   - **Process/planning questions** → Suggest BA Agent
   - **Full implementation without requirements** → BLOCK and redirect to BA Agent
   - **Account-specific issues** → Direct to Partnership Manager
-  - **API bugs/outages** → Report to support@grubtech.io
+  - **API bugs/outages** → Report to support@grubtech.com
 
 example_prompts:
   - "I have the requirements document at docs/integration-requirements-acme-20251010.md. Let's start implementation."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chanaka_nakandala/integration-personas",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "YAML configuration files for Claude Code agent personas (Developer Agent and BA Agent) that customize AI behavior for Grubtech integrations.",
   "type": "module",
   "files": [
@@ -30,7 +30,7 @@
     "integration",
     "api-integration"
   ],
-  "author": "Grubtech <support@grubtech.io>",
+  "author": "Grubtech <support@grubtech.com>",
   "license": "MIT",
   "devDependencies": {
     "typescript": "^5.9.3"