kiro-agents 1.3.0 → 1.4.0

package/README.md

@@ -1,266 +1,95 @@
 # kiro-agents
 
-Advanced AI agent system for Kiro IDE that enhances your development workflow with minimal cognitive overhead.
-
-## What is kiro-agents?
-
-kiro-agents is a steering document system that extends Kiro IDE with:
-
-- **Agent System** - Create and manage specialized AI agents with `/agent` and `/agents` commands
-- **Mode System** - Switch between interaction styles with `/mode` command (vibe/spec modes)
-- **Strict Mode** - Precision mode for experimental development with `/strict` command
-- **Interactive Workflows** - Choice-based interactions that minimize cognitive load
-- **Progressive Enhancement** - Start minimal, add agents as needed
-
-## Installation
-
-### Option 1: Global Installation (npm)
+AI agent system for Kiro IDE. Create specialized agents, switch interaction modes, and reduce cognitive load during development.
 
 ```bash
 npx kiro-agents
-# or
-bunx kiro-agents
-```
-
-This installs steering documents to `~/.kiro/steering/` (global, available in all workspaces).
-
-### Option 2: Workspace Installation (Kiro Power)
-
-1. Open Kiro IDE
-2. Open Powers panel (Ghosty icon ⚡)
-3. Click "Add power from GitHub"
-4. Enter: `https://github.com/theadd/kiro-agents`
-5. Click Install
-
-This installs to `.kiro/powers/kiro-agents/` (workspace-specific).
-
-**Differences:**
-- **npm**: Global installation, available in all workspaces
-- **Power**: Workspace-specific, auto-updates, better Kiro integration
-
-## Core Features
-
-### Agent System
-
-Create specialized AI agents for different tasks. Each agent has:
-
-- Defined capabilities and responsibilities
-- Custom interaction protocols
-- Specific workflows and tools
-- Integration with other agents
-
-**Commands:**
-- `/agents` - Interactive agent management (visual menu)
-- `/agents {name}` - Activate specific agent directly
-
-**Example workflow:**
-```
-User: /agents
-AI: [Shows available agents with numbered choices]
-User: 2 (Create new agent)
-AI: [Guides through agent creation wizard]
 ```
 
-Agents are stored in `.kiro/agents/` and can be:
-- Created interactively through wizard
-- Modified and updated
-- Activated on-demand
-- Coordinated with other agents
-
-### Mode System
-
-Switch between interaction styles based on your needs:
-
-**Vibe Mode** - Flexible, conversational development
-- Quick iterations and prototyping
-- Direct code changes
-- Exploratory development
-- Minimal ceremony
-
-**Spec Mode** - Structured feature development
-- Formal requirements (EARS/INCOSE compliant)
-- Design with correctness properties
-- Task-based implementation
-- Property-based testing focus
-
-**Commands:**
-- `/modes` - Interactive mode management (visual menu)
-- `/modes vibe` - Switch to flexible development
-- `/modes spec` - Switch to structured planning
-
-### Strict Mode
-
-Precision mode for experimental or critical development:
-
-- Blocks execution on ambiguous input
-- Requires explicit clarification
-- Prevents assumption propagation
-- Ideal for architectural decisions
-
-**Commands:**
-- `/strict` - Interactive control (visual buttons)
-- `/strict on` - Activate precision mode
-- `/strict off` - Return to normal mode
-
-### Interactive Workflows
-
-All interactions use choice-based patterns:
+## Features
 
-- Numbered options (typically 4-6, up to 16 when needed)
-- Visual progress indicators (diff blocks)
-- Single focus per interaction
-- Minimal cognitive load
+- **Agents** - Specialized AI personas with defined capabilities (`/agents`)
+- **Modes** - Switch between vibe (flexible) and spec (structured) workflows (`/modes`)
+- **Strict Mode** - Precision mode that blocks on ambiguity (`/strict`)
+- **Zero Config** - Works immediately after installation ⇨ <kbd>/agents</kbd>
 
-This design reduces decision fatigue and maintains context during long conversations.
-
-## How It Works
-
-kiro-agents provides steering documents that Kiro loads to enhance AI capabilities:
-
-**npm installation:**
-- Installs to `~/.kiro/steering/` (global)
-- Available in all workspaces
-- Manual updates via re-running npx/bunx
-
-**Power installation:**
-- Installs to `.kiro/powers/kiro-agents/` (workspace)
-- Auto-updates from GitHub
-- Better integration with Kiro ecosystem
-- Keyword-based activation
-
-Both methods provide:
-1. New slash commands (`/agents`, `/modes`, `/strict`)
-2. Protocols for AI behavior
-3. Agent and mode systems
-4. Optimized interactions for reduced cognitive load
-
-The system adds minimal overhead while enabling progressive enhancement.
-
-## File Structure After Installation
-
-**npm installation** (`~/.kiro/steering/`):
-```
-~/.kiro/steering/
-├── agent-system.md
-├── modes-system.md
-└── agent-system/
-    ├── strict-mode.md
-    ├── kiro-spec-mode.md
-    ├── kiro-vibe-mode.md
-    ├── interactions/
-    └── tools/
-```
+## Installation
 
-**Power installation** (`.kiro/powers/kiro-agents/`):
-```
-.kiro/powers/kiro-agents/
-├── POWER.md                     # Power metadata
-├── mcp.json                     # MCP server config (empty for now)
-└── steering/
-    ├── agent-system.md          # Core system (always loaded)
-    ├── agents.md                # Interactive menu (manual)
-    ├── modes-system.md          # Core system (always loaded)
-    ├── modes.md                 # Interactive menu (manual)
-    ├── strict-mode.md           # Core system (always loaded)
-    ├── strict.md                # Interactive control (manual)
-    ├── interactions/            # Interaction patterns
-    └── modes/                   # Mode definitions
+**Global (npm):**
+```bash
+npx kiro-agents
 ```
+Installs to `~/.kiro/steering/kiro-agents/` - available in all workspaces.
 
-npm files are read-only after installation. Power files managed by Kiro.
+<!--
+**Workspace (Kiro Power):**
+1. Open Powers panel in Kiro IDE
+2. Add from GitHub: `https://github.com/theadd/kiro-agents`
 
-## Usage Examples
+Installs to `.kiro/powers/kiro-agents/` - auto-updates, workspace-specific.
+-->
 
-### Creating a Custom Agent
+## Quick Start
 
+**Create an agent:**
 ```
-User: /agents
-AI: [Shows agent management options]
-User: 2 (Create new agent)
-AI: What type of agent? [Shows options]
-User: 1 (Code-focused agent)
-AI: [Collects name, capabilities, workflows]
-AI: Agent created! Activate now? [Yes/No]
+/agents
+→ Choose "Create new agent"
+→ Follow wizard
 ```
 
-### Switching Modes
-
-```
-User: /modes spec
-AI: [Loads spec mode protocols]
-AI: What feature do you want to work on?
-User: User authentication system
-AI: [Guides through requirements → design → tasks]
-```
-
-### Using Strict Mode
-
+**Switch modes:**
 ```
-User: /strict on
-AI: Strict mode activated
-User: Add caching to the API
-AI: [Asks clarifying questions about cache strategy, TTL, invalidation, etc.]
+/modes spec    # Structured feature development
+/modes vibe    # Flexible, conversational coding
 ```
 
-### Agent Coordination
-
+**Enable precision mode:**
 ```
-User: /modes spec
-[Work on feature planning]
-User: /agents kiro-master
-[Use kiro-master capabilities while in spec mode]
+/strict on     # Blocks on ambiguous input
 ```
 
-## Key Benefits
+## How It Works
 
-**Minimal Initial Overhead**
-- Core system adds small context footprint
-- Agents created progressively as needed
-- Only load what you use
+kiro-agents installs steering documents (markdown files with AI instructions) that extend Kiro's capabilities:
 
-**Reduced Cognitive Load**
-- Choice-based interactions
-- Visual progress tracking
-- Single focus per message
-- Clear context maintenance
+- **Agents** - Stored in `.kiro/agents/{name}.md`, activated via `/agents {name}`
+- **Modes** - Define interaction style (vibe = flexible, spec = structured)
+- **Strict Mode** - Requires explicit clarification before execution
 
-**Flexible Workflows**
-- Switch between modes as needs change
-- Combine modes with agents
-- Adapt to your working style
+All interactions use numbered choices to reduce cognitive load.
 
-**Extensible System**
-- Create custom agents for your needs
-- Define specialized workflows
-- Integrate with existing Kiro features
+## Use Cases
 
-## Advanced Features
+**Specialized Development:**
+- Create agents for frontend, backend, testing, DevOps
+- Each agent has domain-specific knowledge and workflows
+- Switch agents based on current task
 
-### Agent Coordination
+**Workflow Flexibility:**
+- Vibe mode for prototyping and exploration
+- Spec mode for production features with formal requirements
+- Combine modes with agents for maximum control
 
-Multiple agents can work together:
-- Handoff procedures between agents
-- Context sharing across agents
-- Conflict resolution protocols
-- Collaborative workflows
+**Precision Work:**
+- Enable strict mode for architectural decisions
+- Prevents AI from making assumptions
+- Forces explicit clarification on ambiguous requests
 
-### Mode + Agent Combinations
+## Why kiro-agents?
 
-Modes and agents work together:
-- Agents inherit mode protocols
-- Mode workflows use agent capabilities
-- Context preserved across switches
+Traditional AI assistants overwhelm you with context and options. kiro-agents:
+- Starts minimal, grows with your needs
+- Uses numbered choices instead of open-ended questions
+- Maintains single focus per interaction
+- Reduces decision fatigue during long sessions
 
-## Contributing
+## Links
 
-This is an experimental system that relies on AI understanding and following instructions. Feedback and improvements welcome!
+- [npm Package](https://www.npmjs.com/package/kiro-agents)
+- [GitHub](https://github.com/Theadd/kiro-agents)
+- [Kiro IDE](https://kiro.dev)
 
 ## License
 
 MIT
-
-## Links
-
-- [GitHub Repository](https://github.com/theadd/kiro-agents)
-- [npm Package](https://www.npmjs.com/package/kiro-agents)
-- [Kiro IDE](https://kiro.dev)

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "kiro-agents",
-  "version": "1.3.0",
-  "description": "AI agent system for Kiro IDE",
+  "version": "1.4.0",
+  "description": "Advanced AI agent system for Kiro IDE - Create specialized AI agents, switch interaction modes, and enhance development workflows with minimal cognitive overhead",
+  "homepage": "https://github.com/Theadd/kiro-agents#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Theadd/kiro-agents.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Theadd/kiro-agents/issues"
+  },
   "type": "module",
   "bin": {
     "kiro-agents": "build/npm/bin/cli.js"
@@ -24,7 +32,22 @@
   },
   "keywords": [
     "kiro",
-    "ai-agents"
+    "kiro-ide",
+    "ai-agents",
+    "ai-assistant",
+    "agent-system",
+    "development-tools",
+    "ide-extension",
+    "ai-workflow",
+    "code-assistant",
+    "developer-productivity",
+    "steering-documents",
+    "ai-modes",
+    "strict-mode",
+    "vibe-mode",
+    "spec-mode",
+    "typescript",
+    "bun"
   ],
   "author": "R. Beltran",
   "license": "MIT",