@chanaka_nakandala/integration-personas 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +72 -82
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,114 +1,104 @@
1
- # Grubtech Agent Personas
1
+ # Grubtech Integration Personas
2
2
 
3
- **Claude Code agent personas for Grubtech API integrations**
3
+ ## What This Is
4
4
 
5
- This package contains YAML configuration files that customize Claude's behavior for Grubtech API integration tasks.
6
-
7
- ## What's Included
8
-
9
- ### 1. Developer Agent (`developer-agent.yaml`)
10
- **Technical, code-first responses**
11
-
12
- - Generates production-ready code in TypeScript, Python, Java, or cURL
13
- - Provides API specifications and technical details
14
- - Helps debug API errors with specific solutions
15
- - Follows language best practices, SOLID principles, and design patterns
16
-
17
- **When to use:** You're ready to write integration code
18
-
19
- ### 2. BA Agent (`ba-agent.yaml`)
20
- **Planning, requirements, documentation**
21
-
22
- - Conducts comprehensive requirement elicitation
23
- - Asks discovery questions (integration type, tech stack, hosting, team)
24
- - Generates complete project requirement documents with Mermaid diagrams
25
- - Provides process guidance and go-live checklists
26
-
27
- **When to use:** You're starting a new integration project
28
-
29
- ## Installation
30
-
31
- **You don't need to install this package directly!**
32
-
33
- This package is automatically installed when you run:
5
+ 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.
34
6
 
7
+ **Note:** You don't install this directly. Use the main installer instead:
35
8
  ```bash
36
9
  npx @chanaka_nakandala/integration-agent init
37
10
  ```
38
11
 
39
- The installer will:
40
- 1. Download these YAML files
41
- 2. Copy them to `~/.claude/agents/`
42
- 3. Make them available in Claude Code's persona menu
12
+ ## What This Does
43
13
 
44
- ## Manual Installation
14
+ Provides two different AI personalities for Claude Code:
45
15
 
46
- If you want to install manually:
16
+ **Developer Agent**
17
+ - Writes code for you
18
+ - Answers technical questions
19
+ - Helps fix errors
20
+ - Gives you working examples
47
21
 
48
- 1. Download this package:
49
- ```bash
50
- npm install @chanaka_nakandala/agent-personas
51
- ```
22
+ **Business Analyst Agent**
23
+ - Helps plan your project
24
+ - Asks questions to understand your needs
25
+ - Creates requirement documents
26
+ - Makes diagrams showing how things work
52
27
 
53
- 2. Copy YAML files to Claude's agents directory:
54
- ```bash
55
- # Linux/macOS
56
- cp node_modules/@chanaka_nakandala/agent-personas/*.yaml ~/.claude/agents/
57
-
58
- # Windows
59
- copy node_modules\@chanaka_nakandala\agent-personas\*.yaml %USERPROFILE%\.claude\agents\
60
- ```
28
+ ## What Features This Supports
61
29
 
62
- 3. Restart Claude Code
30
+ **Developer Agent Features:**
31
+ - Generates code in TypeScript, Python, Java, or cURL
32
+ - Creates authentication examples
33
+ - Builds menu sync code
34
+ - Makes order receiving webhooks
35
+ - Writes status update code
36
+ - Handles item availability
63
37
 
64
- 4. Select persona from the personas menu
38
+ **Business Analyst Agent Features:**
39
+ - Asks about your restaurant system
40
+ - Finds out what you need to build
41
+ - Creates project plans
42
+ - Makes architecture diagrams
43
+ - Writes requirement documents
44
+ - Provides go-live checklists
65
45
 
66
- ## Usage
46
+ ## How to Use
67
47
 
68
- After installation, select an agent persona in Claude Code:
48
+ After installing, you'll see two options in Claude Code:
69
49
 
70
- ### Start with BA Agent
50
+ **Step 1: Use BA Agent First (For Planning)**
51
+ Select "Grubtech Integration BA" and ask:
71
52
  ```
72
- "Help me plan my restaurant POS integration with Grubtech"
53
+ Help me plan my integration with Grubtech
73
54
  ```
74
55
 
75
- The BA Agent will:
76
- - Ask discovery questions about your system
77
- - Create a requirements document
78
- - Provide architecture diagrams
79
- - Hand off to Developer Agent
56
+ The AI will ask you questions and create a plan.
80
57
 
81
- ### Then use Developer Agent
58
+ **Step 2: Use Developer Agent Next (For Coding)**
59
+ Select "Grubtech Integration Developer" and ask:
82
60
  ```
83
- "I have the requirements document. Generate TypeScript authentication code"
61
+ Generate code to authenticate with Grubtech
84
62
  ```
85
63
 
86
- The Developer Agent will:
87
- - Generate production-ready code
88
- - Include error handling and logging
89
- - Follow best practices
90
- - Provide implementation guidance
64
+ The AI will write the code for you.
65
+
66
+ ## What's Included
67
+
68
+ Two configuration files:
69
+ - `developer-agent.yaml` - Settings for the code-writing personality
70
+ - `ba-agent.yaml` - Settings for the planning personality
71
+
72
+ These files tell Claude how to behave when helping you.
73
+
74
+ ## How It Works
91
75
 
92
- ## Files
76
+ 1. The installer copies these files to your computer
77
+ 2. Claude Code reads them and creates two AI personalities
78
+ 3. You pick which personality to use
79
+ 4. Claude helps you based on that personality
93
80
 
94
- - `developer-agent.yaml` - Developer Agent configuration (20.8 kB)
95
- - `ba-agent.yaml` - BA Agent configuration (23.4 kB)
81
+ ## Getting Help
96
82
 
97
- ## Part of Grubtech Integration Agent
83
+ You shouldn't need to interact with this package directly. If the AI personalities aren't showing up:
98
84
 
99
- This package is part of the Grubtech Integration Agent toolkit:
85
+ 1. Try reinstalling: `npx @chanaka_nakandala/integration-agent init`
86
+ 2. Restart Claude Code
87
+ 3. Look for the personas menu in Claude Code
88
+ 4. Contact Grubtech support: support@grubtech.io
100
89
 
101
- - **@chanaka_nakandala/integration-agent** - Installer (use this!)
102
- - **@chanaka_nakandala/mcp-server** - MCP server
103
- - **@chanaka_nakandala/agent-personas** - Agent personas (this package)
104
- - **@chanaka_nakandala/agent-core** - Shared types
90
+ ## Related Packages
105
91
 
106
- ## Links
92
+ This is part of the Grubtech Integration Agent system:
93
+ - `@chanaka_nakandala/integration-agent` - Main installer (use this!)
94
+ - `@chanaka_nakandala/integration-mcp-server` - Background engine
95
+ - `@chanaka_nakandala/integration-personas` - This package
96
+ - `@chanaka_nakandala/integration-core` - Shared code
107
97
 
108
- - **Grubtech Website:** https://www.grubtech.com
109
- - **API Documentation:** https://docs.grubtech.io
110
- - **Support:** support@grubtech.io
98
+ **Learn more:**
99
+ - Grubtech Website: https://www.grubtech.com
100
+ - API Documentation: https://docs.grubtech.io
111
101
 
112
- ## License
102
+ ---
113
103
 
114
- MIT © Grubtech
104
+ © 2025 Grubtech. All rights reserved.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@chanaka_nakandala/integration-personas",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "YAML configuration files for Claude Code agent personas (Developer Agent and BA Agent) that customize AI behavior for Grubtech integrations.",
5
5
  "type": "module",
6
6
  "files": [