superclaude-kiro 1.2.7 → 1.2.8

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
@@ -1,8 +1,8 @@
1
- # SuperClaude for Kiro CLI
1
+ # SuperClaude for Kiro
2
2
 
3
- Easy installation of [SuperClaude Framework](https://superclaude.netlify.app/) for Kiro CLI. One command to install, update, or uninstall.
3
+ Easy installation of [SuperClaude Framework](https://superclaude.netlify.app/) for Kiro (CLI and IDE). One command to install, update, or uninstall.
4
4
 
5
- > **Attribution**: This package is an installer for the SuperClaude Framework created by [SuperClaude-Org](https://github.com/SuperClaude-Org/SuperClaude_Framework). All command content and framework design belongs to the original authors. This package simply provides a convenient installation mechanism for Kiro CLI users.
5
+ > **Attribution**: This package is an installer for the SuperClaude Framework created by [SuperClaude-Org](https://github.com/SuperClaude-Org/SuperClaude_Framework). All command content and framework design belongs to the original authors. This package simply provides a convenient installation mechanism for Kiro users.
6
6
 
7
7
  ## Installation
8
8
 
@@ -20,43 +20,62 @@ npx superclaude-kiro install --with-morph
20
20
 
21
21
  ## Usage
22
22
 
23
- After installation, start Kiro CLI:
23
+ After installation, start Kiro:
24
24
 
25
+ **Kiro CLI:**
25
26
  ```bash
26
27
  kiro-cli chat
27
28
  ```
28
29
 
29
- Reference SuperClaude commands using `#sc-*` syntax:
30
+ **Kiro IDE:**
31
+ Open the Kiro IDE and start a chat session.
30
32
 
33
+ ### Command Syntax
34
+
35
+ SuperClaude commands use different prefixes depending on your environment:
36
+
37
+ | Environment | Syntax | Example |
38
+ |-------------|--------|---------|
39
+ | Kiro CLI | `#sc-*` | `#sc-implement Add user auth` |
40
+ | Kiro IDE | `/sc-*` | `/sc-implement Add user auth` |
41
+
42
+ **CLI Examples:**
31
43
  ```
32
44
  #sc-implement Add user authentication
33
45
  #sc-analyze Review this code for security issues
34
46
  #sc-help Show all available commands
35
47
  ```
36
48
 
49
+ **IDE Examples:**
50
+ ```
51
+ /sc-implement Add user authentication
52
+ /sc-analyze Review this code for security issues
53
+ /sc-help Show all available commands
54
+ ```
55
+
37
56
  ## Available Commands
38
57
 
39
- | Command | Description |
40
- |---------|-------------|
41
- | `#sc-analyze` | Comprehensive code analysis |
42
- | `#sc-brainstorm` | Interactive requirements discovery |
43
- | `#sc-build` | Project building with error handling |
44
- | `#sc-cleanup` | Code cleanup and optimization |
45
- | `#sc-design` | System and component design |
46
- | `#sc-document` | Documentation generation |
47
- | `#sc-estimate` | Development estimates |
48
- | `#sc-explain` | Code explanations |
49
- | `#sc-git` | Git operations |
50
- | `#sc-implement` | Feature implementation |
51
- | `#sc-improve` | Code improvements |
52
- | `#sc-index` | Project documentation generation |
53
- | `#sc-pm` | Project management orchestration |
54
- | `#sc-research` | Deep web research |
55
- | `#sc-task` | Complex task execution |
56
- | `#sc-test` | Test execution |
57
- | `#sc-troubleshoot` | Issue diagnosis |
58
- | `#sc-workflow` | Workflow generation |
59
- | `#sc-help` | Show all commands and flags |
58
+ | Command | CLI Syntax | IDE Syntax | Description |
59
+ |---------|------------|------------|-------------|
60
+ | analyze | `#sc-analyze` | `/sc-analyze` | Comprehensive code analysis |
61
+ | brainstorm | `#sc-brainstorm` | `/sc-brainstorm` | Interactive requirements discovery |
62
+ | build | `#sc-build` | `/sc-build` | Project building with error handling |
63
+ | cleanup | `#sc-cleanup` | `/sc-cleanup` | Code cleanup and optimization |
64
+ | design | `#sc-design` | `/sc-design` | System and component design |
65
+ | document | `#sc-document` | `/sc-document` | Documentation generation |
66
+ | estimate | `#sc-estimate` | `/sc-estimate` | Development estimates |
67
+ | explain | `#sc-explain` | `/sc-explain` | Code explanations |
68
+ | git | `#sc-git` | `/sc-git` | Git operations |
69
+ | implement | `#sc-implement` | `/sc-implement` | Feature implementation |
70
+ | improve | `#sc-improve` | `/sc-improve` | Code improvements |
71
+ | index | `#sc-index` | `/sc-index` | Project documentation generation |
72
+ | pm | `#sc-pm` | `/sc-pm` | Project management orchestration |
73
+ | research | `#sc-research` | `/sc-research` | Deep web research |
74
+ | task | `#sc-task` | `/sc-task` | Complex task execution |
75
+ | test | `#sc-test` | `/sc-test` | Test execution |
76
+ | troubleshoot | `#sc-troubleshoot` | `/sc-troubleshoot` | Issue diagnosis |
77
+ | workflow | `#sc-workflow` | `/sc-workflow` | Workflow generation |
78
+ | help | `#sc-help` | `/sc-help` | Show all commands and flags |
60
79
 
61
80
  ## CLI Commands
62
81
 
@@ -141,7 +160,7 @@ All agents are configured with:
141
160
  - `"allowedTools": ["*", "use_subagent", "@context7", "@playwright", "@sequential-thinking", "@serena", "@morphllm-fast-apply/edit_file"]` - All built-in tools, subagents, and MCP tools pre-approved
142
161
  - `"toolsSettings"` - Shell and write operations auto-allowed
143
162
  - `"useLegacyMcpJson": true` - Uses global MCP servers
144
- - `"model": "claude-opus-4.5"` - Uses Claude Opus 4.5 by default (subagents inherit this when spawned with superclaude agent)
163
+ - `"model": "claude-opus-4.6"` - Uses Claude Opus 4.6 by default (subagents inherit this when spawned with superclaude agent)
145
164
 
146
165
  **Note**: No default model is set - Kiro CLI remembers your model choice.
147
166
 
@@ -269,7 +288,7 @@ npx superclaude-kiro install --force
269
288
  - **SuperClaude GitHub**: https://github.com/SuperClaude-Org/SuperClaude_Framework
270
289
  - **Kiro CLI Documentation**: https://kiro.dev/docs/cli/
271
290
 
272
- This installer package was created to simplify SuperClaude deployment for Kiro CLI users. All credit for the SuperClaude framework, commands, and methodology goes to the original creators.
291
+ This installer package was created to simplify SuperClaude deployment for Kiro users. All credit for the SuperClaude framework, commands, and methodology goes to the original creators.
273
292
 
274
293
  ## License
275
294
 
@@ -28,5 +28,5 @@
28
28
  }
29
29
  },
30
30
  "useLegacyMcpJson": true,
31
- "model": "claude-opus-4.5"
31
+ "model": "claude-opus-4.6"
32
32
  }
@@ -28,5 +28,5 @@
28
28
  }
29
29
  },
30
30
  "useLegacyMcpJson": true,
31
- "model": "claude-opus-4.5"
31
+ "model": "claude-opus-4.6"
32
32
  }
@@ -28,5 +28,5 @@
28
28
  }
29
29
  },
30
30
  "useLegacyMcpJson": true,
31
- "model": "claude-opus-4.5"
31
+ "model": "claude-opus-4.6"
32
32
  }
@@ -28,5 +28,5 @@
28
28
  }
29
29
  },
30
30
  "useLegacyMcpJson": true,
31
- "model": "claude-opus-4.5"
31
+ "model": "claude-opus-4.6"
32
32
  }
@@ -86,4 +86,13 @@ Key behaviors:
86
86
  **Will Not:**
87
87
  - Execute dynamic analysis requiring code compilation or runtime
88
88
  - Modify source code or apply fixes without explicit user consent
89
- - Analyze external dependencies beyond import and usage patterns
89
+ - Analyze external dependencies beyond import and usage patterns
90
+
91
+ **Output**: Analysis report containing:
92
+ - Severity-rated findings
93
+ - Code quality metrics
94
+ - Security vulnerabilities
95
+ - Performance issues
96
+ - Recommendations
97
+
98
+ **Next Step**: After review, use `/sc:improve` to apply recommended fixes or `/sc:cleanup` for dead code removal.
@@ -97,4 +97,26 @@ Key behaviors:
97
97
  **Will Not:**
98
98
  - Make implementation decisions without proper requirements discovery
99
99
  - Override user vision with prescriptive solutions during exploration phase
100
- - Bypass systematic exploration for complex multi-domain projects
100
+ - Bypass systematic exploration for complex multi-domain projects
101
+
102
+ ## CRITICAL BOUNDARIES
103
+
104
+ **STOP AFTER REQUIREMENTS DISCOVERY**
105
+
106
+ This command produces a REQUIREMENTS SPECIFICATION ONLY.
107
+
108
+ **Explicitly Will NOT**:
109
+ - Create architecture diagrams or system designs (use `/sc:design`)
110
+ - Generate implementation code (use `/sc:implement`)
111
+ - Make architectural decisions
112
+ - Design database schemas or API contracts
113
+ - Create technical specifications beyond requirements
114
+
115
+ **Output**: Requirements document with:
116
+ - Clarified user goals
117
+ - Functional requirements
118
+ - Non-functional requirements
119
+ - User stories / acceptance criteria
120
+ - Open questions for user
121
+
122
+ **Next Step**: After brainstorm completes, use `/sc:design` for architecture or `/sc:workflow` for implementation planning.
@@ -87,4 +87,36 @@ Question-driven exploration for deep learning and strategic thinking development
87
87
  ## Integration Notes
88
88
  - Compatible with all thinking flags (--think, --think-hard, --ultrathink)
89
89
  - Supports wave orchestration for comprehensive business analysis
90
- - Integrates with scribe persona for professional business communication
90
+ - Integrates with scribe persona for professional business communication
91
+
92
+ ## CRITICAL BOUNDARIES
93
+
94
+ **SYNTHESIS OUTPUT ONLY - NOT IMPLEMENTATION**
95
+
96
+ This command produces EXPERT ANALYSIS and RECOMMENDATIONS only.
97
+
98
+ **Default behavior**:
99
+ - Assemble expert panel
100
+ - Conduct analysis/discussion
101
+ - **STOP with synthesis document** - do not implement recommendations
102
+
103
+ **Completion Criteria**:
104
+ - All relevant experts have contributed
105
+ - Consensus or disagreements documented
106
+ - Actionable recommendations provided
107
+
108
+ **Explicitly Will NOT**:
109
+ - Implement any business recommendations
110
+ - Make code or architectural changes
111
+ - Execute decisions without user approval
112
+
113
+ **Output**: Business analysis document containing:
114
+ - Expert perspectives (9 simulated experts)
115
+ - Consensus points
116
+ - Disagreements with reasoning
117
+ - Priority-ranked recommendations
118
+
119
+ **Next Step**: User reviews recommendations, then:
120
+ - Use `/sc:design` for architectural changes
121
+ - Use `/sc:implement` for feature development
122
+ - Use `/sc:workflow` for planning
@@ -90,4 +90,23 @@ Key behaviors:
90
90
  **Will Not:**
91
91
  - Remove code without thorough safety analysis and validation
92
92
  - Override project-specific cleanup exclusions or architectural constraints
93
- - Apply cleanup operations that compromise functionality or introduce bugs
93
+ - Apply cleanup operations that compromise functionality or introduce bugs
94
+
95
+ ## AUTO-FIX VS APPROVAL-REQUIRED
96
+
97
+ **Auto-fix (applies automatically)**:
98
+ - Unused imports removal
99
+ - Dead code with zero references
100
+ - Empty blocks removal
101
+ - Redundant type annotations
102
+
103
+ **Approval Required (prompts user first)**:
104
+ - Code with indirect references
105
+ - Exports potentially used externally
106
+ - Test fixtures/utilities
107
+ - Configuration values
108
+
109
+ **Safety Threshold**:
110
+ - If code has ANY usage path, prompt user
111
+ - If code affects public API, prompt user
112
+ - If unsure, prompt user
@@ -85,4 +85,12 @@ Key behaviors:
85
85
  **Will Not:**
86
86
  - Generate actual implementation code (use /sc:implement for implementation)
87
87
  - Modify existing system architecture without explicit design approval
88
- - Create designs that violate established architectural constraints
88
+ - Create designs that violate established architectural constraints
89
+
90
+ **Output**: Architecture documents containing:
91
+ - System diagrams (component, sequence, data flow)
92
+ - API specifications
93
+ - Database schemas
94
+ - Interface definitions
95
+
96
+ **Next Step**: After design is approved, use `/sc:implement` to build the designed components.
@@ -83,4 +83,25 @@ Key behaviors:
83
83
  **Will Not:**
84
84
  - Guarantee estimate accuracy without proper scope analysis and validation
85
85
  - Provide estimates without appropriate domain expertise and complexity assessment
86
- - Override historical benchmarks without clear justification and analysis
86
+ - Override historical benchmarks without clear justification and analysis
87
+
88
+ ## CRITICAL BOUNDARIES
89
+
90
+ **STOP AFTER ESTIMATION**
91
+
92
+ This command produces an ESTIMATION REPORT ONLY - no implementation.
93
+
94
+ **Explicitly Will NOT**:
95
+ - Execute work based on estimates
96
+ - Create implementation timelines for execution
97
+ - Start implementation tasks
98
+ - Make commitments on behalf of user
99
+
100
+ **Output**: Estimation report containing:
101
+ - Time/effort breakdown
102
+ - Complexity analysis
103
+ - Confidence intervals
104
+ - Risk assessment
105
+ - Resource requirements
106
+
107
+ **Next Step**: After estimation, user decides on timeline. Use `/sc:workflow` for planning or `/sc:implement` for execution.
@@ -94,4 +94,18 @@ Key behaviors:
94
94
  **Will Not:**
95
95
  - Make architectural decisions without appropriate persona consultation
96
96
  - Implement features conflicting with security policies or architectural constraints
97
- - Override user-specified safety constraints or bypass quality gates
97
+ - Override user-specified safety constraints or bypass quality gates
98
+
99
+ ## COMPLETION CRITERIA
100
+
101
+ **Implementation is DONE when**:
102
+ - Feature code is written and compiles
103
+ - Basic functionality verified
104
+ - Files saved and ready for testing
105
+
106
+ **Post-Implementation Checklist**:
107
+ 1. Code compiles without errors
108
+ 2. Basic functionality works
109
+ 3. Ready for `/sc:test`
110
+
111
+ **Next Step**: After implementation, use `/sc:test` to run tests, then `/sc:git` to commit.
@@ -90,4 +90,24 @@ Key behaviors:
90
90
  **Will Not:**
91
91
  - Apply risky improvements without proper analysis and user confirmation
92
92
  - Make architectural changes without understanding full system impact
93
- - Override established coding standards or project-specific conventions
93
+ - Override established coding standards or project-specific conventions
94
+
95
+ ## AUTO-FIX VS APPROVAL-REQUIRED
96
+
97
+ **Auto-fix (applies automatically)**:
98
+ - Style fixes (formatting, naming conventions)
99
+ - Unused variable removal
100
+ - Import organization
101
+ - Simple type annotations
102
+
103
+ **Approval Required (prompts user first)**:
104
+ - Architectural changes
105
+ - Logic refactoring
106
+ - Function signature changes
107
+ - Removing code used by public APIs
108
+ - Changes affecting multiple files
109
+
110
+ **Explicitly Will NOT** (without `--force` flag):
111
+ - Make architectural decisions
112
+ - Refactor code structure without confirmation
113
+ - Remove functionality
@@ -100,4 +100,24 @@ inclusion: manual
100
100
 
101
101
  ## Boundaries
102
102
  **Will**: Current information, intelligent search, evidence-based analysis
103
- **Won't**: Make claims without sources, skip validation, access restricted content
103
+ **Won't**: Make claims without sources, skip validation, access restricted content
104
+
105
+ ## CRITICAL BOUNDARIES
106
+
107
+ **STOP AFTER RESEARCH REPORT**
108
+
109
+ This command produces a RESEARCH REPORT ONLY - no implementation.
110
+
111
+ **Explicitly Will NOT**:
112
+ - Implement findings or recommendations
113
+ - Write code based on research
114
+ - Make architectural decisions
115
+ - Create system changes based on research
116
+
117
+ **Output**: Research report (`claudedocs/research_*.md`) containing:
118
+ - Findings with sources
119
+ - Evidence-based analysis
120
+ - Recommendations (for human decision)
121
+ - Cited references
122
+
123
+ **Next Step**: After research completes, user decides next action. Use `/sc:design` for architecture or `/sc:implement` for coding.
@@ -82,4 +82,24 @@ Key behaviors:
82
82
  **Will Not:**
83
83
  - Replace domain-specific commands for simple operations
84
84
  - Override user coordination preferences or execution strategies
85
- - Execute operations without proper dependency analysis and validation
85
+ - Execute operations without proper dependency analysis and validation
86
+
87
+ ## CRITICAL BOUNDARIES
88
+
89
+ **STOP AFTER TASK DECOMPOSITION**
90
+
91
+ This command produces a TASK HIERARCHY ONLY - delegates execution to other commands.
92
+
93
+ **Explicitly Will NOT**:
94
+ - Execute implementation tasks directly
95
+ - Write or modify code
96
+ - Create system changes
97
+ - Replace domain-specific commands
98
+
99
+ **Output**: Task breakdown document with:
100
+ - Epic decomposition
101
+ - Task hierarchy with dependencies
102
+ - Delegation assignments (which `/sc:*` command handles each task)
103
+ - Coordination strategy
104
+
105
+ **Next Step**: Execute individual tasks using delegated commands (`/sc:implement`, `/sc:design`, `/sc:test`, etc.)
@@ -425,4 +425,12 @@ Comprehensive analysis with full expert commentary, examples, and implementation
425
425
  - Replace human judgment and domain expertise in critical decisions
426
426
  - Modify specifications without explicit user consent and validation
427
427
  - Generate specifications from scratch without existing content or context
428
- - Provide legal or regulatory compliance guarantees beyond analysis guidance
428
+ - Provide legal or regulatory compliance guarantees beyond analysis guidance
429
+
430
+ **Output**: Expert review document containing:
431
+ - Multi-expert analysis (10 simulated experts)
432
+ - Specific, actionable recommendations
433
+ - Consensus points and disagreements
434
+ - Priority-ranked improvements
435
+
436
+ **Next Step**: After review, incorporate feedback into spec, then use `/sc:design` for architecture or `/sc:implement` for coding.
@@ -86,4 +86,31 @@ Key behaviors:
86
86
  **Will Not:**
87
87
  - Execute simple tasks that don't require advanced orchestration
88
88
  - Compromise quality standards for speed or convenience
89
- - Operate without proper validation and quality gates
89
+ - Operate without proper validation and quality gates
90
+
91
+ ## CRITICAL BOUNDARIES
92
+
93
+ **USER-INVOKED DISCRETE TASK EXECUTION**
94
+
95
+ This command executes specific tasks when explicitly invoked by user.
96
+
97
+ **Difference from /sc:pm**:
98
+ - `/sc:pm` = session-level orchestration (background monitoring, continuous)
99
+ - `/sc:task` = user-invoked discrete execution (explicit start/end)
100
+
101
+ **Behavior**:
102
+ - User invokes `/sc:task [description]`
103
+ - Execute the specific task using multi-agent coordination
104
+ - **STOP when task is complete** - do not continue to next tasks without user input
105
+
106
+ **Completion Criteria**:
107
+ - Task objective achieved
108
+ - All sub-tasks marked completed in TodoWrite
109
+ - Validation passed
110
+
111
+ **Output**: Task completion report with:
112
+ - What was accomplished
113
+ - Files modified
114
+ - Tests status (if applicable)
115
+
116
+ **Next Step**: User decides next action. May invoke another `/sc:task` or use specific commands.
@@ -85,4 +85,36 @@ Key behaviors:
85
85
  **Will Not:**
86
86
  - Apply risky fixes without proper analysis and user confirmation
87
87
  - Modify production systems without explicit permission and safety validation
88
- - Make architectural changes without understanding full system impact
88
+ - Make architectural changes without understanding full system impact
89
+
90
+ ## CRITICAL BOUNDARIES
91
+
92
+ **DIAGNOSE FIRST - FIXES REQUIRE `--fix` FLAG**
93
+
94
+ This command is DIAGNOSIS-FIRST by default.
95
+
96
+ **Default behavior (no `--fix` flag)**:
97
+ - Diagnose the issue
98
+ - Identify root cause
99
+ - Propose solution options
100
+ - **STOP and present findings to user** - do not apply any fixes
101
+
102
+ **With `--fix` flag**:
103
+ - After diagnosis, prompt user for confirmation before applying
104
+ - Apply fix only after user explicitly approves
105
+ - Verify fix with tests
106
+
107
+ **Explicitly Will NOT** (without `--fix` flag):
108
+ - Apply any code changes
109
+ - Modify any files
110
+ - Execute fixes automatically
111
+
112
+ **Output**: Diagnostic report containing:
113
+ - Issue description
114
+ - Root cause analysis
115
+ - Proposed solutions (ranked)
116
+ - Risk assessment for each solution
117
+
118
+ **Next Step**: User reviews diagnosis, then either:
119
+ - Re-run with `--fix` flag to apply recommended fix
120
+ - Use `/sc:improve` for broader refactoring
@@ -94,4 +94,25 @@ Key behaviors:
94
94
  **Will Not:**
95
95
  - Execute actual implementation tasks beyond workflow planning and strategy
96
96
  - Override established development processes without proper analysis and validation
97
- - Generate workflows without comprehensive requirement analysis and dependency mapping
97
+ - Generate workflows without comprehensive requirement analysis and dependency mapping
98
+
99
+ ## CRITICAL BOUNDARIES
100
+
101
+ **STOP AFTER PLAN CREATION**
102
+
103
+ This command produces an IMPLEMENTATION PLAN ONLY - no code execution.
104
+
105
+ **Explicitly Will NOT**:
106
+ - Execute any implementation tasks
107
+ - Write or modify code
108
+ - Create files (except the workflow plan document)
109
+ - Make architectural changes
110
+ - Run builds or tests
111
+
112
+ **Output**: Workflow plan document (`claudedocs/workflow_*.md`) containing:
113
+ - Implementation phases
114
+ - Task dependencies
115
+ - Execution order
116
+ - Checkpoints and validation steps
117
+
118
+ **Next Step**: After workflow completes, use `/sc:implement` to execute the plan step by step.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "superclaude-kiro",
3
- "version": "1.2.7",
4
- "description": "SuperClaude Framework for Kiro CLI - Easy installation for teams",
3
+ "version": "1.2.8",
4
+ "description": "SuperClaude Framework for Kiro (CLI and IDE) - Easy installation for teams",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "superclaude-kiro": "./bin/superclaude-kiro.js"
@@ -102,7 +102,7 @@ export const MCP_SERVERS = {
102
102
  config: {
103
103
  command: 'npx',
104
104
  args: ['-y', '@morphllm/morphmcp'],
105
- autoApprove: ['edit_file']
105
+ autoApprove: ['edit_file', 'warpgrep_codebase_search']
106
106
  }
107
107
  }
108
108
  };