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
@@ -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 `{{{PROTOCOLS_PATH}}}/agent-creation.mdx` into context** - Load agent creation protocol
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 `{{{PROTOCOLS_PATH}}}/agent-creation.mdx` into context** - Load agent creation protocol
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 `{{{PROTOCOLS_PATH}}}/agent-creation.mdx` into context** - Load agent structure reference
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
- {{{MODE_COMMANDS}}}
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 Kiro interaction
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
- **Begin agent management mode now.**
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**: kiro-manager
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**: kiro-manager-hybrid
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.5.0",
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": "^2.29.8",
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