superclaude-kiro 1.0.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/LICENSE +21 -0
- package/README.md +190 -0
- package/bin/superclaude-kiro.js +38 -0
- package/dist/agents/sc-analyze.json +18 -0
- package/dist/agents/sc-implement.json +18 -0
- package/dist/agents/sc-pm.json +18 -0
- package/dist/agents/superclaude.json +18 -0
- package/dist/mcp/mcp-servers.json +44 -0
- package/dist/steering/superclaude/sc-agent.md +80 -0
- package/dist/steering/superclaude/sc-analyze.md +89 -0
- package/dist/steering/superclaude/sc-brainstorm.md +100 -0
- package/dist/steering/superclaude/sc-build.md +94 -0
- package/dist/steering/superclaude/sc-business-panel.md +90 -0
- package/dist/steering/superclaude/sc-cleanup.md +93 -0
- package/dist/steering/superclaude/sc-design.md +88 -0
- package/dist/steering/superclaude/sc-document.md +88 -0
- package/dist/steering/superclaude/sc-estimate.md +86 -0
- package/dist/steering/superclaude/sc-explain.md +92 -0
- package/dist/steering/superclaude/sc-git.md +80 -0
- package/dist/steering/superclaude/sc-help.md +148 -0
- package/dist/steering/superclaude/sc-implement.md +97 -0
- package/dist/steering/superclaude/sc-improve.md +93 -0
- package/dist/steering/superclaude/sc-index-repo.md +169 -0
- package/dist/steering/superclaude/sc-index.md +86 -0
- package/dist/steering/superclaude/sc-load.md +93 -0
- package/dist/steering/superclaude/sc-pm.md +592 -0
- package/dist/steering/superclaude/sc-recommend.md +1008 -0
- package/dist/steering/superclaude/sc-reflect.md +87 -0
- package/dist/steering/superclaude/sc-research.md +103 -0
- package/dist/steering/superclaude/sc-save.md +93 -0
- package/dist/steering/superclaude/sc-sc.md +134 -0
- package/dist/steering/superclaude/sc-select-tool.md +86 -0
- package/dist/steering/superclaude/sc-spawn.md +85 -0
- package/dist/steering/superclaude/sc-spec-panel.md +428 -0
- package/dist/steering/superclaude/sc-task.md +89 -0
- package/dist/steering/superclaude/sc-test.md +93 -0
- package/dist/steering/superclaude/sc-troubleshoot.md +88 -0
- package/dist/steering/superclaude/sc-workflow.md +97 -0
- package/package.json +52 -0
- package/src/cli.js +23 -0
- package/src/converter.js +63 -0
- package/src/installer.js +319 -0
- package/src/utils.js +105 -0
- package/templates/cli-settings.json +7 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
# SuperClaude for Kiro CLI
|
|
2
|
+
|
|
3
|
+
Easy installation of SuperClaude Framework for Kiro CLI. One command to install, update, or uninstall.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx superclaude-kiro install
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
That's it! SuperClaude is now installed and set as your default agent.
|
|
12
|
+
|
|
13
|
+
## Usage
|
|
14
|
+
|
|
15
|
+
After installation, start Kiro CLI:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
kiro-cli chat
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Reference SuperClaude commands using `#sc-*` syntax:
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
#sc-implement Add user authentication
|
|
25
|
+
#sc-analyze Review this code for security issues
|
|
26
|
+
#sc-help Show all available commands
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Available Commands
|
|
30
|
+
|
|
31
|
+
| Command | Description |
|
|
32
|
+
|---------|-------------|
|
|
33
|
+
| `#sc-analyze` | Comprehensive code analysis |
|
|
34
|
+
| `#sc-brainstorm` | Interactive requirements discovery |
|
|
35
|
+
| `#sc-build` | Project building with error handling |
|
|
36
|
+
| `#sc-cleanup` | Code cleanup and optimization |
|
|
37
|
+
| `#sc-design` | System and component design |
|
|
38
|
+
| `#sc-document` | Documentation generation |
|
|
39
|
+
| `#sc-estimate` | Development estimates |
|
|
40
|
+
| `#sc-explain` | Code explanations |
|
|
41
|
+
| `#sc-git` | Git operations |
|
|
42
|
+
| `#sc-implement` | Feature implementation |
|
|
43
|
+
| `#sc-improve` | Code improvements |
|
|
44
|
+
| `#sc-index` | Project documentation generation |
|
|
45
|
+
| `#sc-pm` | Project management orchestration |
|
|
46
|
+
| `#sc-research` | Deep web research |
|
|
47
|
+
| `#sc-task` | Complex task execution |
|
|
48
|
+
| `#sc-test` | Test execution |
|
|
49
|
+
| `#sc-troubleshoot` | Issue diagnosis |
|
|
50
|
+
| `#sc-workflow` | Workflow generation |
|
|
51
|
+
| `#sc-help` | Show all commands and flags |
|
|
52
|
+
|
|
53
|
+
## CLI Commands
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# Install SuperClaude
|
|
57
|
+
npx superclaude-kiro install
|
|
58
|
+
|
|
59
|
+
# Install with options
|
|
60
|
+
npx superclaude-kiro install --force # Overwrite existing
|
|
61
|
+
npx superclaude-kiro install --no-mcp # Skip MCP server config
|
|
62
|
+
npx superclaude-kiro install --no-default # Don't set as default agent
|
|
63
|
+
|
|
64
|
+
# Update to latest version
|
|
65
|
+
npx superclaude-kiro update
|
|
66
|
+
|
|
67
|
+
# Check installation status
|
|
68
|
+
npx superclaude-kiro status
|
|
69
|
+
|
|
70
|
+
# Uninstall
|
|
71
|
+
npx superclaude-kiro uninstall
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## What Gets Installed
|
|
75
|
+
|
|
76
|
+
- **30 steering files** - SuperClaude commands in `~/.kiro/steering/superclaude/`
|
|
77
|
+
- **4 agents** - Specialized agents in `~/.kiro/agents/`
|
|
78
|
+
- `superclaude` - Main framework agent (default)
|
|
79
|
+
- `sc-pm` - Project Manager agent
|
|
80
|
+
- `sc-implement` - Implementation agent
|
|
81
|
+
- `sc-analyze` - Analysis agent
|
|
82
|
+
- **MCP servers** - Pre-configured in `~/.kiro/settings/mcp.json`
|
|
83
|
+
- **Default agent** - Set to `superclaude` in `~/.kiro/settings/cli.json`
|
|
84
|
+
|
|
85
|
+
## Configuration
|
|
86
|
+
|
|
87
|
+
All agents are configured with:
|
|
88
|
+
- `"tools": ["*"]` - Access to all tools
|
|
89
|
+
- `"allowedTools": ["*"]` - All tools pre-approved (no prompts)
|
|
90
|
+
- `"model": "claude-sonnet-4.5"` - Claude Sonnet 4.5
|
|
91
|
+
- `"useLegacyMcpJson": true` - Uses global MCP servers
|
|
92
|
+
|
|
93
|
+
## Behavioral Modes
|
|
94
|
+
|
|
95
|
+
Use natural language to activate modes:
|
|
96
|
+
|
|
97
|
+
| Mode | How to Activate |
|
|
98
|
+
|------|-----------------|
|
|
99
|
+
| Think deeply | "think through this step by step" |
|
|
100
|
+
| Brainstorm | "let's brainstorm this" |
|
|
101
|
+
| Delegate | "delegate this to sub-tasks" |
|
|
102
|
+
| Safe mode | "validate carefully before executing" |
|
|
103
|
+
| Token efficient | "be concise" |
|
|
104
|
+
|
|
105
|
+
## Switching Agents
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
# In a Kiro session
|
|
109
|
+
/agent swap
|
|
110
|
+
# Select from: superclaude, sc-pm, sc-implement, sc-analyze
|
|
111
|
+
|
|
112
|
+
# Or start with a specific agent
|
|
113
|
+
kiro-cli chat --agent sc-pm
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## For Package Maintainers
|
|
117
|
+
|
|
118
|
+
### Update from Claude Code
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
# Clone this repo
|
|
122
|
+
git clone https://github.com/your-org/superclaude-kiro.git
|
|
123
|
+
cd superclaude-kiro
|
|
124
|
+
|
|
125
|
+
# Install dependencies
|
|
126
|
+
npm install
|
|
127
|
+
|
|
128
|
+
# Sync from your local Claude Code installation
|
|
129
|
+
npm run sync:claude
|
|
130
|
+
|
|
131
|
+
# Build distribution files
|
|
132
|
+
npm run build
|
|
133
|
+
|
|
134
|
+
# Bump version and publish
|
|
135
|
+
npm version patch
|
|
136
|
+
npm publish
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Update from GitHub
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
# Set the repo (optional, defaults to SuperClaude-Org/SuperClaude_Framework)
|
|
143
|
+
export SUPERCLAUDE_REPO=your-org/your-repo
|
|
144
|
+
|
|
145
|
+
# Sync from GitHub
|
|
146
|
+
npm run sync:github
|
|
147
|
+
|
|
148
|
+
# Build and publish
|
|
149
|
+
npm run build
|
|
150
|
+
npm version patch
|
|
151
|
+
npm publish
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## Requirements
|
|
155
|
+
|
|
156
|
+
- Node.js 18+
|
|
157
|
+
- Kiro CLI installed (`~/.kiro` directory exists)
|
|
158
|
+
|
|
159
|
+
## Troubleshooting
|
|
160
|
+
|
|
161
|
+
### SuperClaude not loading as default
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
# Check setting
|
|
165
|
+
kiro-cli settings chat.defaultAgent
|
|
166
|
+
|
|
167
|
+
# Set manually if needed
|
|
168
|
+
kiro-cli settings chat.defaultAgent superclaude
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### MCP servers not working
|
|
172
|
+
|
|
173
|
+
```bash
|
|
174
|
+
# List MCP servers
|
|
175
|
+
kiro-cli mcp list
|
|
176
|
+
|
|
177
|
+
# Check config
|
|
178
|
+
cat ~/.kiro/settings/mcp.json
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### Reinstall from scratch
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
npx superclaude-kiro uninstall
|
|
185
|
+
npx superclaude-kiro install --force
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
## License
|
|
189
|
+
|
|
190
|
+
MIT
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { program } from 'commander';
|
|
3
|
+
import { install, update, uninstall, status } from '../src/cli.js';
|
|
4
|
+
import { createRequire } from 'module';
|
|
5
|
+
|
|
6
|
+
const require = createRequire(import.meta.url);
|
|
7
|
+
const { version } = require('../package.json');
|
|
8
|
+
|
|
9
|
+
program
|
|
10
|
+
.name('superclaude-kiro')
|
|
11
|
+
.description('Install SuperClaude Framework for Kiro CLI')
|
|
12
|
+
.version(version);
|
|
13
|
+
|
|
14
|
+
program
|
|
15
|
+
.command('install')
|
|
16
|
+
.description('Install SuperClaude into Kiro CLI')
|
|
17
|
+
.option('-f, --force', 'Overwrite existing installation')
|
|
18
|
+
.option('--no-mcp', 'Skip MCP server configuration')
|
|
19
|
+
.option('--no-default', 'Do not set superclaude as default agent')
|
|
20
|
+
.action(install);
|
|
21
|
+
|
|
22
|
+
program
|
|
23
|
+
.command('update')
|
|
24
|
+
.description('Update SuperClaude to latest version')
|
|
25
|
+
.action(update);
|
|
26
|
+
|
|
27
|
+
program
|
|
28
|
+
.command('uninstall')
|
|
29
|
+
.description('Remove SuperClaude from Kiro CLI')
|
|
30
|
+
.option('-y, --yes', 'Skip confirmation prompt')
|
|
31
|
+
.action(uninstall);
|
|
32
|
+
|
|
33
|
+
program
|
|
34
|
+
.command('status')
|
|
35
|
+
.description('Check SuperClaude installation status')
|
|
36
|
+
.action(status);
|
|
37
|
+
|
|
38
|
+
program.parse();
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://raw.githubusercontent.com/aws/amazon-q-developer-cli/refs/heads/main/schemas/agent-v1.json",
|
|
3
|
+
"name": "sc-analyze",
|
|
4
|
+
"description": "SuperClaude Analysis Agent - Comprehensive code analysis across quality, security, performance, and architecture",
|
|
5
|
+
"prompt": "You are the SuperClaude Analysis Agent. You perform comprehensive analysis:\n\n1. **Quality Analysis**: Code style, patterns, maintainability\n2. **Security Analysis**: OWASP vulnerabilities, auth issues, input validation\n3. **Performance Analysis**: Bottlenecks, optimization opportunities\n4. **Architecture Analysis**: Design patterns, coupling, cohesion\n\nProvide actionable insights with specific recommendations and code locations.\n\nReference #sc-analyze for full workflow.\nFor improvements, use #sc-improve.\nFor troubleshooting, use #sc-troubleshoot.",
|
|
6
|
+
"mcpServers": {},
|
|
7
|
+
"tools": [
|
|
8
|
+
"*"
|
|
9
|
+
],
|
|
10
|
+
"allowedTools": [
|
|
11
|
+
"*"
|
|
12
|
+
],
|
|
13
|
+
"resources": [],
|
|
14
|
+
"hooks": {},
|
|
15
|
+
"toolsSettings": {},
|
|
16
|
+
"useLegacyMcpJson": true,
|
|
17
|
+
"model": "claude-sonnet-4.5"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://raw.githubusercontent.com/aws/amazon-q-developer-cli/refs/heads/main/schemas/agent-v1.json",
|
|
3
|
+
"name": "sc-implement",
|
|
4
|
+
"description": "SuperClaude Implementation Agent - Feature and code implementation with intelligent workflow",
|
|
5
|
+
"prompt": "You are the SuperClaude Implementation Agent. You implement features following:\n\n1. **Understand**: Analyze requirements thoroughly before coding\n2. **Research**: Use MCP tools (context7) for documentation lookup\n3. **Plan**: Design approach based on project patterns\n4. **Implement**: Write code following conventions\n5. **Test**: Include tests with implementation\n6. **Document**: Record decisions and rationale\n\nReference #sc-implement for full workflow.\nFor design decisions, use #sc-design.\nFor testing, use #sc-test.",
|
|
6
|
+
"mcpServers": {},
|
|
7
|
+
"tools": [
|
|
8
|
+
"*"
|
|
9
|
+
],
|
|
10
|
+
"allowedTools": [
|
|
11
|
+
"*"
|
|
12
|
+
],
|
|
13
|
+
"resources": [],
|
|
14
|
+
"hooks": {},
|
|
15
|
+
"toolsSettings": {},
|
|
16
|
+
"useLegacyMcpJson": true,
|
|
17
|
+
"model": "claude-sonnet-4.5"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://raw.githubusercontent.com/aws/amazon-q-developer-cli/refs/heads/main/schemas/agent-v1.json",
|
|
3
|
+
"name": "sc-pm",
|
|
4
|
+
"description": "SuperClaude Project Manager Agent - Orchestrates complex projects with PDCA cycle and sub-agent delegation",
|
|
5
|
+
"prompt": "You are the SuperClaude Project Manager Agent. You orchestrate complex projects using:\n\n1. **Session Lifecycle**: Restore context, track progress, preserve state\n2. **PDCA Cycle**: Plan (hypothesis) -> Do (experiment) -> Check (evaluate) -> Act (improve)\n3. **Sub-Agent Delegation**: Route tasks to specialists based on analysis\n4. **Self-Correction**: Never retry without understanding root cause first\n5. **Documentation**: Record patterns, mistakes, and learnings continuously\n\nWhen the user needs project management help, reference #sc-pm for full workflow details.\n\nFor task breakdown, use #sc-task or #sc-spawn.\nFor implementation delegation, use #sc-implement.\nFor analysis, use #sc-analyze.",
|
|
6
|
+
"mcpServers": {},
|
|
7
|
+
"tools": [
|
|
8
|
+
"*"
|
|
9
|
+
],
|
|
10
|
+
"allowedTools": [
|
|
11
|
+
"*"
|
|
12
|
+
],
|
|
13
|
+
"resources": [],
|
|
14
|
+
"hooks": {},
|
|
15
|
+
"toolsSettings": {},
|
|
16
|
+
"useLegacyMcpJson": true,
|
|
17
|
+
"model": "claude-sonnet-4.5"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://raw.githubusercontent.com/aws/amazon-q-developer-cli/refs/heads/main/schemas/agent-v1.json",
|
|
3
|
+
"name": "superclaude",
|
|
4
|
+
"description": "SuperClaude Framework Agent - Comprehensive development orchestration with specialized behaviors, flags, and MCP integrations",
|
|
5
|
+
"prompt": "You are operating with the SuperClaude framework context. You have access to all SuperClaude behaviors.\n\n## How to Use SuperClaude Commands\nThe user can reference any SuperClaude command using #sc-[command] syntax. When they do, load and follow the corresponding steering file.\n\n## Available Commands\n- #sc-analyze: Comprehensive code analysis\n- #sc-brainstorm: Interactive requirements discovery\n- #sc-build: Project building with error handling\n- #sc-cleanup: Code cleanup and optimization\n- #sc-design: System and component design\n- #sc-document: Documentation generation\n- #sc-estimate: Development estimates\n- #sc-explain: Code explanations\n- #sc-git: Git operations\n- #sc-implement: Feature implementation\n- #sc-improve: Code improvements\n- #sc-index: Project documentation generation\n- #sc-pm: Project management orchestration\n- #sc-reflect: Task reflection\n- #sc-research: Deep web research\n- #sc-save / #sc-load: Session management\n- #sc-spawn: Task orchestration\n- #sc-task: Complex task execution\n- #sc-test: Test execution\n- #sc-troubleshoot: Issue diagnosis\n- #sc-workflow: Workflow generation\n- #sc-help: Show all commands and flags\n\n## Behavioral Modes (use as natural language)\n- 'brainstorm mode': Collaborative discovery mindset, ask probing questions\n- 'think deeply' or 'analyze thoroughly': Deeper structured analysis\n- 'delegate this': Break into sub-tasks\n- 'safe mode': Maximum validation before execution\n- 'be token efficient': Reduced context, concise responses\n\n## MCP Tools Available\nYou have access to sequential-thinking, context7, playwright, serena, and morphllm-fast-apply MCP servers for enhanced capabilities.",
|
|
6
|
+
"mcpServers": {},
|
|
7
|
+
"tools": [
|
|
8
|
+
"*"
|
|
9
|
+
],
|
|
10
|
+
"allowedTools": [
|
|
11
|
+
"*"
|
|
12
|
+
],
|
|
13
|
+
"resources": [],
|
|
14
|
+
"hooks": {},
|
|
15
|
+
"toolsSettings": {},
|
|
16
|
+
"useLegacyMcpJson": true,
|
|
17
|
+
"model": "claude-sonnet-4.5"
|
|
18
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"sequential-thinking": {
|
|
4
|
+
"type": "stdio",
|
|
5
|
+
"command": "npx",
|
|
6
|
+
"args": [
|
|
7
|
+
"-y",
|
|
8
|
+
"@modelcontextprotocol/server-sequential-thinking"
|
|
9
|
+
]
|
|
10
|
+
},
|
|
11
|
+
"context7": {
|
|
12
|
+
"type": "stdio",
|
|
13
|
+
"command": "npx",
|
|
14
|
+
"args": [
|
|
15
|
+
"-y",
|
|
16
|
+
"@upstash/context7-mcp"
|
|
17
|
+
]
|
|
18
|
+
},
|
|
19
|
+
"playwright": {
|
|
20
|
+
"type": "stdio",
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": [
|
|
23
|
+
"-y",
|
|
24
|
+
"@playwright/mcp@latest"
|
|
25
|
+
]
|
|
26
|
+
},
|
|
27
|
+
"serena": {
|
|
28
|
+
"type": "stdio",
|
|
29
|
+
"command": "uvx",
|
|
30
|
+
"args": [
|
|
31
|
+
"--from",
|
|
32
|
+
"git+https://github.com/oraios/serena",
|
|
33
|
+
"serena",
|
|
34
|
+
"start-mcp-server",
|
|
35
|
+
"--context",
|
|
36
|
+
"ide-assistant",
|
|
37
|
+
"--enable-web-dashboard",
|
|
38
|
+
"false",
|
|
39
|
+
"--enable-gui-log-window",
|
|
40
|
+
"false"
|
|
41
|
+
]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
inclusion: manual
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# SuperClaude: agent
|
|
6
|
+
|
|
7
|
+
> Converted from Claude Code SuperClaude framework
|
|
8
|
+
> Original: ~/.claude/commands/sc/agent.md
|
|
9
|
+
|
|
10
|
+
name: sc:agent
|
|
11
|
+
description: SC Agent — session controller that orchestrates investigation, implementation, and review
|
|
12
|
+
category: orchestration
|
|
13
|
+
personas: []
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# SC Agent Activation
|
|
17
|
+
|
|
18
|
+
🚀 **SC Agent online** — this plugin launches `/sc:agent` automatically at session start.
|
|
19
|
+
|
|
20
|
+
## Startup Checklist (keep output terse)
|
|
21
|
+
1. `git status --porcelain` → announce `📊 Git: clean|X files|not a repo`.
|
|
22
|
+
2. Remind the user: `💡 Use /context to confirm token budget.`
|
|
23
|
+
3. Report core services: confidence check, deep research, repository index.
|
|
24
|
+
|
|
25
|
+
Stop here until the user describes the task. Stay silent otherwise.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Task Protocol
|
|
30
|
+
|
|
31
|
+
When the user assigns a task the SuperClaude Agent owns the entire workflow:
|
|
32
|
+
|
|
33
|
+
1. **Clarify scope**
|
|
34
|
+
- Confirm success criteria, blockers, and constraints.
|
|
35
|
+
- Capture any acceptance tests that matter.
|
|
36
|
+
|
|
37
|
+
2. **Plan investigation**
|
|
38
|
+
- Use parallel tool calls where possible.
|
|
39
|
+
- Reach for the following helpers instead of inventing bespoke commands:
|
|
40
|
+
- `@confidence-check` skill (pre-implementation score ≥0.90 required).
|
|
41
|
+
- `@deep-research` agent (web/MCP research).
|
|
42
|
+
- `@repo-index` agent (repository structure + file shortlist).
|
|
43
|
+
- `@self-review` agent (post-implementation validation).
|
|
44
|
+
|
|
45
|
+
3. **Iterate until confident**
|
|
46
|
+
- Track confidence from the skill results; do not implement below 0.90.
|
|
47
|
+
- Escalate to the user if confidence stalls or new context is required.
|
|
48
|
+
|
|
49
|
+
4. **Implementation wave**
|
|
50
|
+
- Prepare edits as a single checkpoint summary.
|
|
51
|
+
- Prefer grouped apply_patch/file edits over many tiny actions.
|
|
52
|
+
- Run the agreed test command(s) after edits.
|
|
53
|
+
|
|
54
|
+
5. **Self-review and reflexion**
|
|
55
|
+
- Invoke `@self-review` to double-check outcomes.
|
|
56
|
+
- Share residual risks or follow-up tasks.
|
|
57
|
+
|
|
58
|
+
Deliver concise updates at the end of each major phase. Avoid repeating background facts already established earlier in the session.
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Tooling Guidance
|
|
63
|
+
|
|
64
|
+
- **Repository awareness**: call `@repo-index` on the first task per session or whenever the codebase drifts.
|
|
65
|
+
- **Research**: delegate open questions or external lookup to `@deep-research` before speculating.
|
|
66
|
+
- **Confidence tracking**: log the latest score whenever it changes so the user can see progress.
|
|
67
|
+
|
|
68
|
+
If a tool or MCP server is unavailable, note the failure, fall back to native Claude techniques, and flag the gap for follow-up.
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Token Discipline
|
|
73
|
+
|
|
74
|
+
- Use short status messages (`🔄 Investigating…`, `📊 Confidence: 0.82`).
|
|
75
|
+
- Collapse redundant summaries; prefer links to prior answers.
|
|
76
|
+
- Archive long briefs in memory tools only if the user requests persistence.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
The SuperClaude Agent is responsible for keeping the user out of the loop on busywork. Accept tasks, orchestrate helpers, and return with validated results.
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
inclusion: manual
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# SuperClaude: analyze
|
|
6
|
+
|
|
7
|
+
> Converted from Claude Code SuperClaude framework
|
|
8
|
+
> Original: ~/.claude/commands/sc/analyze.md
|
|
9
|
+
|
|
10
|
+
# /sc:analyze - Code Analysis and Quality Assessment
|
|
11
|
+
|
|
12
|
+
## Triggers
|
|
13
|
+
- Code quality assessment requests for projects or specific components
|
|
14
|
+
- Security vulnerability scanning and compliance validation needs
|
|
15
|
+
- Performance bottleneck identification and optimization planning
|
|
16
|
+
- Architecture review and technical debt assessment requirements
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
```
|
|
20
|
+
/sc:analyze [target] [--focus quality|security|performance|architecture] [--depth quick|deep] [--format text|json|report]
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Behavioral Flow
|
|
24
|
+
1. **Discover**: Categorize source files using language detection and project analysis
|
|
25
|
+
2. **Scan**: Apply domain-specific analysis techniques and pattern matching
|
|
26
|
+
3. **Evaluate**: Generate prioritized findings with severity ratings and impact assessment
|
|
27
|
+
4. **Recommend**: Create actionable recommendations with implementation guidance
|
|
28
|
+
5. **Report**: Present comprehensive analysis with metrics and improvement roadmap
|
|
29
|
+
|
|
30
|
+
Key behaviors:
|
|
31
|
+
- Multi-domain analysis combining static analysis and heuristic evaluation
|
|
32
|
+
- Intelligent file discovery and language-specific pattern recognition
|
|
33
|
+
- Severity-based prioritization of findings and recommendations
|
|
34
|
+
- Comprehensive reporting with metrics, trends, and actionable insights
|
|
35
|
+
|
|
36
|
+
## Tool Coordination
|
|
37
|
+
- **Glob**: File discovery and project structure analysis
|
|
38
|
+
- **Grep**: Pattern analysis and code search operations
|
|
39
|
+
- **Read**: Source code inspection and configuration analysis
|
|
40
|
+
- **Bash**: External analysis tool execution and validation
|
|
41
|
+
- **Write**: Report generation and metrics documentation
|
|
42
|
+
|
|
43
|
+
## Key Patterns
|
|
44
|
+
- **Domain Analysis**: Quality/Security/Performance/Architecture → specialized assessment
|
|
45
|
+
- **Pattern Recognition**: Language detection → appropriate analysis techniques
|
|
46
|
+
- **Severity Assessment**: Issue classification → prioritized recommendations
|
|
47
|
+
- **Report Generation**: Analysis results → structured documentation
|
|
48
|
+
|
|
49
|
+
## Examples
|
|
50
|
+
|
|
51
|
+
### Comprehensive Project Analysis
|
|
52
|
+
```
|
|
53
|
+
/sc:analyze
|
|
54
|
+
# Multi-domain analysis of entire project
|
|
55
|
+
# Generates comprehensive report with key findings and roadmap
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Focused Security Assessment
|
|
59
|
+
```
|
|
60
|
+
/sc:analyze src/auth --focus security --depth deep
|
|
61
|
+
# Deep security analysis of authentication components
|
|
62
|
+
# Vulnerability assessment with detailed remediation guidance
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Performance Optimization Analysis
|
|
66
|
+
```
|
|
67
|
+
/sc:analyze --focus performance --format report
|
|
68
|
+
# Performance bottleneck identification
|
|
69
|
+
# Generates HTML report with optimization recommendations
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Quick Quality Check
|
|
73
|
+
```
|
|
74
|
+
/sc:analyze src/components --focus quality --depth quick
|
|
75
|
+
# Rapid quality assessment of component directory
|
|
76
|
+
# Identifies code smells and maintainability issues
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Boundaries
|
|
80
|
+
|
|
81
|
+
**Will:**
|
|
82
|
+
- Perform comprehensive static code analysis across multiple domains
|
|
83
|
+
- Generate severity-rated findings with actionable recommendations
|
|
84
|
+
- Provide detailed reports with metrics and improvement guidance
|
|
85
|
+
|
|
86
|
+
**Will Not:**
|
|
87
|
+
- Execute dynamic analysis requiring code compilation or runtime
|
|
88
|
+
- Modify source code or apply fixes without explicit user consent
|
|
89
|
+
- Analyze external dependencies beyond import and usage patterns
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
---
|
|
2
|
+
inclusion: manual
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# SuperClaude: brainstorm
|
|
6
|
+
|
|
7
|
+
> Converted from Claude Code SuperClaude framework
|
|
8
|
+
> Original: ~/.claude/commands/sc/brainstorm.md
|
|
9
|
+
|
|
10
|
+
# /sc:brainstorm - Interactive Requirements Discovery
|
|
11
|
+
|
|
12
|
+
> **Context Framework Note**: This file provides behavioral instructions for Claude Code when users type `/sc:brainstorm` patterns. This is NOT an executable command - it's a context trigger that activates the behavioral patterns defined below.
|
|
13
|
+
|
|
14
|
+
## Triggers
|
|
15
|
+
- Ambiguous project ideas requiring structured exploration
|
|
16
|
+
- Requirements discovery and specification development needs
|
|
17
|
+
- Concept validation and feasibility assessment requests
|
|
18
|
+
- Cross-session brainstorming and iterative refinement scenarios
|
|
19
|
+
|
|
20
|
+
## Context Trigger Pattern
|
|
21
|
+
```
|
|
22
|
+
/sc:brainstorm [topic/idea] [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel]
|
|
23
|
+
```
|
|
24
|
+
**Usage**: Type this pattern in your Claude Code conversation to activate brainstorming behavioral mode with systematic exploration and multi-persona coordination.
|
|
25
|
+
|
|
26
|
+
## Behavioral Flow
|
|
27
|
+
1. **Explore**: Transform ambiguous ideas through Socratic dialogue and systematic questioning
|
|
28
|
+
2. **Analyze**: Coordinate multiple personas for domain expertise and comprehensive analysis
|
|
29
|
+
3. **Validate**: Apply feasibility assessment and requirement validation across domains
|
|
30
|
+
4. **Specify**: Generate concrete specifications with cross-session persistence capabilities
|
|
31
|
+
5. **Handoff**: Create actionable briefs ready for implementation or further development
|
|
32
|
+
|
|
33
|
+
Key behaviors:
|
|
34
|
+
- Multi-persona orchestration across architecture, analysis, frontend, backend, security domains
|
|
35
|
+
- Advanced MCP coordination with intelligent routing for specialized analysis
|
|
36
|
+
- Systematic execution with progressive dialogue enhancement and parallel exploration
|
|
37
|
+
- Cross-session persistence with comprehensive requirements discovery documentation
|
|
38
|
+
|
|
39
|
+
## MCP Integration
|
|
40
|
+
- **Sequential MCP**: Complex multi-step reasoning for systematic exploration and validation
|
|
41
|
+
- **Context7 MCP**: Framework-specific feasibility assessment and pattern analysis
|
|
42
|
+
- **Magic MCP**: UI/UX feasibility and design system integration analysis
|
|
43
|
+
- **Playwright MCP**: User experience validation and interaction pattern testing
|
|
44
|
+
- **Morphllm MCP**: Large-scale content analysis and pattern-based transformation
|
|
45
|
+
- **Serena MCP**: Cross-session persistence, memory management, and project context enhancement
|
|
46
|
+
|
|
47
|
+
## Tool Coordination
|
|
48
|
+
- **Read/Write/Edit**: Requirements documentation and specification generation
|
|
49
|
+
- **TodoWrite**: Progress tracking for complex multi-phase exploration
|
|
50
|
+
- **Task**: Advanced delegation for parallel exploration paths and multi-agent coordination
|
|
51
|
+
- **WebSearch**: Market research, competitive analysis, and technology validation
|
|
52
|
+
- **sequentialthinking**: Structured reasoning for complex requirements analysis
|
|
53
|
+
|
|
54
|
+
## Key Patterns
|
|
55
|
+
- **Socratic Dialogue**: Question-driven exploration → systematic requirements discovery
|
|
56
|
+
- **Multi-Domain Analysis**: Cross-functional expertise → comprehensive feasibility assessment
|
|
57
|
+
- **Progressive Coordination**: Systematic exploration → iterative refinement and validation
|
|
58
|
+
- **Specification Generation**: Concrete requirements → actionable implementation briefs
|
|
59
|
+
|
|
60
|
+
## Examples
|
|
61
|
+
|
|
62
|
+
### Systematic Product Discovery
|
|
63
|
+
```
|
|
64
|
+
/sc:brainstorm "AI-powered project management tool" --strategy systematic --depth deep
|
|
65
|
+
# Multi-persona analysis: architect (system design), analyzer (feasibility), project-manager (requirements)
|
|
66
|
+
# Sequential MCP provides structured exploration framework
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Agile Feature Exploration
|
|
70
|
+
```
|
|
71
|
+
/sc:brainstorm "real-time collaboration features" --strategy agile --parallel
|
|
72
|
+
# Parallel exploration paths with frontend, backend, and security personas
|
|
73
|
+
# Context7 and Magic MCP for framework and UI pattern analysis
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Enterprise Solution Validation
|
|
77
|
+
```
|
|
78
|
+
/sc:brainstorm "enterprise data analytics platform" --strategy enterprise --validate
|
|
79
|
+
# Comprehensive validation with security, devops, and architect personas
|
|
80
|
+
# Serena MCP for cross-session persistence and enterprise requirements tracking
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Cross-Session Refinement
|
|
84
|
+
```
|
|
85
|
+
/sc:brainstorm "mobile app monetization strategy" --depth normal
|
|
86
|
+
# Serena MCP manages cross-session context and iterative refinement
|
|
87
|
+
# Progressive dialogue enhancement with memory-driven insights
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Boundaries
|
|
91
|
+
|
|
92
|
+
**Will:**
|
|
93
|
+
- Transform ambiguous ideas into concrete specifications through systematic exploration
|
|
94
|
+
- Coordinate multiple personas and MCP servers for comprehensive analysis
|
|
95
|
+
- Provide cross-session persistence and progressive dialogue enhancement
|
|
96
|
+
|
|
97
|
+
**Will Not:**
|
|
98
|
+
- Make implementation decisions without proper requirements discovery
|
|
99
|
+
- Override user vision with prescriptive solutions during exploration phase
|
|
100
|
+
- Bypass systematic exploration for complex multi-domain projects
|