kiro-agents 1.5.0 → 1.6.0
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.
package/README.md
CHANGED
|
@@ -93,3 +93,13 @@ Traditional AI assistants overwhelm you with context and options. kiro-agents:
|
|
|
93
93
|
## License
|
|
94
94
|
|
|
95
95
|
MIT
|
|
96
|
+
|
|
97
|
+
## Contributing
|
|
98
|
+
|
|
99
|
+
We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
|
100
|
+
|
|
101
|
+
**Important**: Do not modify files in `power/` directory. This is auto-generated during release. See contributing guide for details.
|
|
102
|
+
|
|
103
|
+
## License
|
|
104
|
+
|
|
105
|
+
MIT
|
package/build/npm/dist/agents.md
CHANGED
|
@@ -37,7 +37,7 @@ Begin with a diff block showing:
|
|
|
37
37
|
Execute `listDirectory` on `.kiro/agents/`:
|
|
38
38
|
|
|
39
39
|
**If directory doesn't exist OR directory is empty:**
|
|
40
|
-
1. **Read
|
|
40
|
+
1. **Read `~/.kiro/steering/kiro-agents/protocols/agent-creation.mdx` into context** - Load agent creation protocol
|
|
41
41
|
2. Create `.kiro/agents/kiro-master.md` agent automatically using the description from "Initial Agent" section
|
|
42
42
|
3. Follow the agent definition structure from agent-creation.mdx protocol
|
|
43
43
|
4. Show diff block indicating setup completion
|
|
@@ -89,7 +89,7 @@ Based on user selection:
|
|
|
89
89
|
|
|
90
90
|
#### Option 2 - Create New Agent
|
|
91
91
|
|
|
92
|
-
- **Read
|
|
92
|
+
- **Read `~/.kiro/steering/kiro-agents/protocols/agent-creation.mdx` into context** - Load agent creation protocol
|
|
93
93
|
- Follow all steps from the "Agent Creation Steps" section in agent-creation.mdx
|
|
94
94
|
- Start agent creation workflow with interactive wizard
|
|
95
95
|
- Ask for agent type (code-focused, documentation, testing, etc.)
|
|
@@ -100,7 +100,7 @@ Based on user selection:
|
|
|
100
100
|
|
|
101
101
|
#### Option 3 - Manage Existing Agent
|
|
102
102
|
|
|
103
|
-
- **Read
|
|
103
|
+
- **Read `~/.kiro/steering/kiro-agents/protocols/agent-creation.mdx` into context** - Load agent structure reference
|
|
104
104
|
- Show numbered list of available agents
|
|
105
105
|
- User selects agent to manage
|
|
106
106
|
- Offer management options:
|
|
@@ -133,7 +133,11 @@ AGENT COMMANDS
|
|
|
133
133
|
/agents {name} Activate specific agent
|
|
134
134
|
/agents Interactive agent management
|
|
135
135
|
|
|
136
|
-
|
|
136
|
+
MODE COMMANDS (see modes-system.md)
|
|
137
|
+
/modes {name} Switch Kiro mode (vibe/spec)
|
|
138
|
+
/modes Interactive mode management
|
|
139
|
+
/strict {state} Control strict mode (on/off)
|
|
140
|
+
/strict Interactive strict mode control
|
|
137
141
|
|
|
138
142
|
Note: Commands are defined in steering documents.
|
|
139
143
|
New commands can be added via Instruction Alias pattern.
|
|
@@ -151,7 +155,7 @@ Explain agent system:
|
|
|
151
155
|
#### Option 7 - Exit
|
|
152
156
|
|
|
153
157
|
- Confirm exit from agent management mode
|
|
154
|
-
- Return to normal
|
|
158
|
+
- Return to normal interaction
|
|
155
159
|
- Preserve any changes made
|
|
156
160
|
|
|
157
161
|
### Step 5: Maintain Chit-Chat Mode
|
|
@@ -185,4 +189,16 @@ This description is used when creating `.kiro/agents/kiro-master.md` during auto
|
|
|
185
189
|
|
|
186
190
|
---
|
|
187
191
|
|
|
188
|
-
**
|
|
192
|
+
**Quick Commands:**
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
/agents Interactive agent management
|
|
196
|
+
|
|
197
|
+
MODE COMMANDS (see modes-system.md)
|
|
198
|
+
/modes {name} Switch Kiro mode (vibe/spec)
|
|
199
|
+
/modes Interactive mode management
|
|
200
|
+
/strict {state} Control strict mode (on/off)
|
|
201
|
+
/strict Interactive strict mode control
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
Note: Commands are defined in steering documents.
|
|
@@ -97,7 +97,6 @@ You are now activating the **{agent_name}** agent.
|
|
|
97
97
|
|
|
98
98
|
This alias enables users to activate any agent with `/agents {name}` syntax.
|
|
99
99
|
|
|
100
|
-
|
|
101
100
|
## Mode System Alias
|
|
102
101
|
|
|
103
102
|
The mode switching command uses parameter substitution to load mode definitions dynamically:
|
|
@@ -16,7 +16,7 @@ inclusion: manual
|
|
|
16
16
|
- Visual formatting (bold, code blocks)
|
|
17
17
|
- Context recovery system
|
|
18
18
|
|
|
19
|
-
**Example agents**:
|
|
19
|
+
**Example agents**: project-manager
|
|
20
20
|
|
|
21
21
|
**When to use**:
|
|
22
22
|
|
|
@@ -103,7 +103,7 @@ inclusion: manual
|
|
|
103
103
|
- Simple tasks → Direct execution
|
|
104
104
|
- Complex tasks → Chit-chat or consultative
|
|
105
105
|
|
|
106
|
-
**Example agents**:
|
|
106
|
+
**Example agents**: project-manager-hybrid
|
|
107
107
|
|
|
108
108
|
**When to use**:
|
|
109
109
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "kiro-agents",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.6.0",
|
|
4
4
|
"description": "Advanced AI agent system for Kiro IDE - Create specialized AI agents, switch interaction modes, and enhance development workflows with minimal cognitive overhead",
|
|
5
5
|
"homepage": "https://github.com/Theadd/kiro-agents#readme",
|
|
6
6
|
"repository": {
|
|
@@ -52,7 +52,7 @@
|
|
|
52
52
|
"author": "R. Beltran",
|
|
53
53
|
"license": "MIT",
|
|
54
54
|
"devDependencies": {
|
|
55
|
-
"@changesets/cli": "
|
|
55
|
+
"@changesets/cli": "2.27.9",
|
|
56
56
|
"@types/bun": "latest"
|
|
57
57
|
},
|
|
58
58
|
"peerDependencies": {
|
|
@@ -1,111 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
inclusion: always
|
|
3
|
-
description: Generic agent activation system with instruction commands for seamless agent management
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Agent System
|
|
7
|
-
|
|
8
|
-
Generic agent activation and management system for Kiro using instruction commands with parameter support.
|
|
9
|
-
|
|
10
|
-
**For complete documentation, examples, and troubleshooting, see `docs/agent-system-guide.md`**
|
|
11
|
-
|
|
12
|
-
## Agent Commands
|
|
13
|
-
|
|
14
|
-
**Note:** This system uses the Instruction Alias pattern defined in `aliases.md`.
|
|
15
|
-
|
|
16
|
-
### Command 1: Activate Specific Agent
|
|
17
|
-
|
|
18
|
-
<alias>
|
|
19
|
-
<trigger>/agents {agent_name}</trigger>
|
|
20
|
-
<definition>
|
|
21
|
-
## Agent Activation: {agent_name}
|
|
22
|
-
|
|
23
|
-
You are now activating the **{agent_name}** agent.
|
|
24
|
-
|
|
25
|
-
**Load and execute activation protocol:**
|
|
26
|
-
1. Read `.kiro/agents/{agent_name}.md` into context
|
|
27
|
-
2. Read `~/.kiro/steering/kiro-agents/protocols/agent-activation.mdx` into context
|
|
28
|
-
3. Follow all steps from the "Agent Activation Steps" section in agent-activation.mdx
|
|
29
|
-
4. Use `{agent_name}` as the agent identifier throughout the protocol
|
|
30
|
-
</definition>
|
|
31
|
-
</alias>
|
|
32
|
-
|
|
33
|
-
### Command 2: Interactive Agent Management
|
|
34
|
-
|
|
35
|
-
For interactive agent management, use the `/agents` slash command (without parameters).
|
|
36
|
-
This provides a visual interface for:
|
|
37
|
-
- Viewing all available agents
|
|
38
|
-
- Creating new agents
|
|
39
|
-
- Managing existing agents
|
|
40
|
-
- Viewing agent details
|
|
41
|
-
|
|
42
|
-
**Usage:**
|
|
43
|
-
- Interactive: `/agents` (no parameters, loads `agents.md` steering file)
|
|
44
|
-
- Direct: `/agents {name}` (with agent name, uses alias above)
|
|
45
|
-
|
|
46
|
-
## Quick Reference
|
|
47
|
-
|
|
48
|
-
### Activation Protocol Summary
|
|
49
|
-
|
|
50
|
-
When `/agents {name}` is executed:
|
|
51
|
-
|
|
52
|
-
1. **Discover** - Check `.kiro/agents/{name}.md` exists
|
|
53
|
-
2. **Load** - Read agent definition and `strict-mode.md`
|
|
54
|
-
3. **Apply** - Follow mandatory protocols, load required steering
|
|
55
|
-
4. **Assume** - Become agent completely, maintain role
|
|
56
|
-
5. **Begin** - Start interaction per agent's protocol
|
|
57
|
-
|
|
58
|
-
### Management Protocol Summary
|
|
59
|
-
|
|
60
|
-
When `/agents` is executed:
|
|
61
|
-
|
|
62
|
-
1. **Activate chit-chat** - Load chit-chat.md, use diff blocks
|
|
63
|
-
2. **Scan directory** - List `.md` files in `.kiro/agents/`
|
|
64
|
-
3. **Present choices** - Show agents, offer operations
|
|
65
|
-
4. **Handle operations** - Activation, creation, management, viewing
|
|
66
|
-
5. **Maintain context** - Track progress, preserve decisions
|
|
67
|
-
|
|
68
|
-
## Agent Definition Requirements
|
|
69
|
-
|
|
70
|
-
**File location:** `.kiro/agents/{agent-name}.md`
|
|
71
|
-
|
|
72
|
-
**Required sections:**
|
|
73
|
-
- Frontmatter (name, type, description, version)
|
|
74
|
-
- Core Responsibilities
|
|
75
|
-
- Capabilities
|
|
76
|
-
- Interaction Protocol
|
|
77
|
-
- Mandatory Protocols
|
|
78
|
-
- Workflows
|
|
79
|
-
- Examples
|
|
80
|
-
|
|
81
|
-
**Recommended sections:**
|
|
82
|
-
- Integration Points
|
|
83
|
-
- Conflict Priorities
|
|
84
|
-
- Best Practices
|
|
85
|
-
- Advanced Features
|
|
86
|
-
- Error Handling
|
|
87
|
-
- Success Metrics
|
|
88
|
-
|
|
89
|
-
## Initial Agent
|
|
90
|
-
|
|
91
|
-
When auto-setup detects no agents exist, it creates:
|
|
92
|
-
|
|
93
|
-
**kiro-master** - Interactive Kiro feature management with CRUD operations for MCP servers, hooks, agents, specs, powers, and steering documents. Includes .kiro/ directory maintenance, steering optimization, refactoring, and comprehensive analysis capabilities
|
|
94
|
-
|
|
95
|
-
## Integration Notes
|
|
96
|
-
|
|
97
|
-
- Works alongside steering documents
|
|
98
|
-
- Compatible with chit-chat mode
|
|
99
|
-
- Preserves ADHD-C optimizations
|
|
100
|
-
- **Mode system** - Works seamlessly with modes (see `modes-system.md`)
|
|
101
|
-
- **Context preservation** - File changes and conversation history persist across agent switches
|
|
102
|
-
|
|
103
|
-
## System Notes
|
|
104
|
-
|
|
105
|
-
- Prototype system using Instruction Alias pattern
|
|
106
|
-
- Relies on AI understanding and following instructions
|
|
107
|
-
- May need iteration based on actual usage
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
**Agent system ready. Use `/agents` to begin or `/agents {name}` to activate specific agent.**
|
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
inclusion: always
|
|
3
|
-
description: Kiro mode switching system for flexible interaction styles (vibe/spec modes)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Modes System
|
|
7
|
-
|
|
8
|
-
Mode switching system for Kiro that enables different interaction styles and workflows.
|
|
9
|
-
|
|
10
|
-
**For complete documentation, examples, and troubleshooting, see `docs/modes-system-guide.md`**
|
|
11
|
-
|
|
12
|
-
## Available Modes
|
|
13
|
-
|
|
14
|
-
- **vibe** - Flexible, conversational development assistance
|
|
15
|
-
- **spec** - Structured feature development with requirements, design, and tasks
|
|
16
|
-
|
|
17
|
-
## Mode Commands
|
|
18
|
-
|
|
19
|
-
### Command 1: Switch Kiro Mode
|
|
20
|
-
|
|
21
|
-
<alias>
|
|
22
|
-
<trigger>/modes {mode_name}</trigger>
|
|
23
|
-
<definition>
|
|
24
|
-
## Mode Switch: {mode_name}
|
|
25
|
-
|
|
26
|
-
You are now switching to **{mode_name} mode**.
|
|
27
|
-
|
|
28
|
-
**Load and execute mode switching protocol:**
|
|
29
|
-
1. Read `kiro-{mode_name}-mode.md` from agent-system directory into context
|
|
30
|
-
2. Read `~/.kiro/steering/kiro-agents/protocols/mode-switching.mdx` into context
|
|
31
|
-
3. Follow all steps from the "Mode Switch Steps" section in mode-switching.mdx
|
|
32
|
-
4. Use `{mode_name}` as the mode identifier throughout the protocol
|
|
33
|
-
</definition>
|
|
34
|
-
</alias>
|
|
35
|
-
|
|
36
|
-
### Command 2: Interactive Mode Management
|
|
37
|
-
|
|
38
|
-
For interactive mode management, use the `/modes` slash command (without parameters).
|
|
39
|
-
This provides a visual interface for:
|
|
40
|
-
- Viewing available modes
|
|
41
|
-
- Comparing modes
|
|
42
|
-
- Switching modes
|
|
43
|
-
- Getting help
|
|
44
|
-
|
|
45
|
-
**Usage:**
|
|
46
|
-
- Interactive: `/modes` (no parameters, loads `modes.md` steering file)
|
|
47
|
-
- Direct: `/modes {name}` (with mode name, uses alias above)
|
|
48
|
-
|
|
49
|
-
## Quick Reference
|
|
50
|
-
|
|
51
|
-
### Activation Protocol Summary
|
|
52
|
-
|
|
53
|
-
When `/modes {name}` is executed:
|
|
54
|
-
|
|
55
|
-
1. **Load** - Read mode definition and parse configuration
|
|
56
|
-
2. **Check** - If from spec mode, show warning and confirm
|
|
57
|
-
3. **Apply** - Follow mode protocols, set up context
|
|
58
|
-
4. **Begin** - Start interaction per mode's protocol
|
|
59
|
-
|
|
60
|
-
### Management Protocol Summary
|
|
61
|
-
|
|
62
|
-
When `/modes` is executed:
|
|
63
|
-
|
|
64
|
-
1. **Activate chit-chat** - Load chit-chat.md, use diff blocks
|
|
65
|
-
2. **Detect modes** - Scan for `kiro-*-mode.md` files
|
|
66
|
-
3. **Present choices** - Show modes, offer operations
|
|
67
|
-
4. **Handle operations** - Switching, viewing, comparison, help
|
|
68
|
-
|
|
69
|
-
## Mode and Agent Coordination
|
|
70
|
-
|
|
71
|
-
**Modes provide the framework:**
|
|
72
|
-
- Vibe mode: Flexible, conversational interaction
|
|
73
|
-
- Spec mode: Structured workflow with approval gates
|
|
74
|
-
|
|
75
|
-
**Agents provide specialized capabilities:**
|
|
76
|
-
- kiro-master: Feature management and .kiro/ operations
|
|
77
|
-
- Custom agents: Domain-specific expertise
|
|
78
|
-
|
|
79
|
-
**They work together:**
|
|
80
|
-
- Modes can activate agents: `/modes spec` then `/agents kiro-master`
|
|
81
|
-
- Agents inherit mode protocols: Agent in spec mode follows spec workflow
|
|
82
|
-
- Context preserved: Switch modes/agents without losing work
|
|
83
|
-
- Layered capabilities: Mode + Agent + Strict mode all active simultaneously
|
|
84
|
-
|
|
85
|
-
## System Notes
|
|
86
|
-
|
|
87
|
-
- Prototype system using Instruction Alias pattern
|
|
88
|
-
- Relies on AI understanding and following instructions
|
|
89
|
-
- Works seamlessly with agent system
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
|
|
93
|
-
**Modes system ready.**
|
|
94
|
-
|
|
95
|
-
**Quick start:**
|
|
96
|
-
- `/modes vibe` - Flexible development
|
|
97
|
-
- `/modes spec` - Structured planning
|
|
98
|
-
- `/modes` - Interactive mode management
|