super-opencode 1.1.0 → 1.1.1

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.
Files changed (35) hide show
  1. package/.opencode/agents/architect.md +84 -84
  2. package/.opencode/agents/backend.md +124 -124
  3. package/.opencode/agents/frontend.md +137 -137
  4. package/.opencode/agents/optimizer.md +51 -51
  5. package/.opencode/agents/pm-agent.md +105 -105
  6. package/.opencode/agents/quality.md +107 -107
  7. package/.opencode/agents/researcher.md +105 -105
  8. package/.opencode/agents/reviewer.md +80 -80
  9. package/.opencode/agents/security.md +107 -107
  10. package/.opencode/agents/writer.md +136 -136
  11. package/.opencode/commands/soc-analyze.md +136 -137
  12. package/.opencode/commands/soc-brainstorm.md +109 -110
  13. package/.opencode/commands/soc-cleanup.md +107 -107
  14. package/.opencode/commands/soc-design.md +0 -1
  15. package/.opencode/commands/soc-explain.md +113 -113
  16. package/.opencode/commands/soc-git.md +104 -104
  17. package/.opencode/commands/soc-help.md +94 -94
  18. package/.opencode/commands/soc-implement.md +112 -112
  19. package/.opencode/commands/soc-improve.md +105 -105
  20. package/.opencode/commands/soc-pm.md +99 -99
  21. package/.opencode/commands/soc-research.md +105 -105
  22. package/.opencode/commands/soc-review.md +102 -102
  23. package/.opencode/commands/soc-test.md +109 -109
  24. package/.opencode/commands/soc-workflow.md +97 -97
  25. package/.opencode/settings.json +3 -3
  26. package/.opencode/skills/confidence-check/SKILL.md +97 -97
  27. package/.opencode/skills/debug-protocol/SKILL.md +83 -83
  28. package/.opencode/skills/reflexion/SKILL.md +108 -108
  29. package/.opencode/skills/security-audit/SKILL.md +90 -90
  30. package/.opencode/skills/self-check/SKILL.md +95 -95
  31. package/.opencode/skills/simplification/SKILL.md +92 -92
  32. package/AGENTS.md +175 -175
  33. package/LICENSE +21 -21
  34. package/dist/cli.js +2 -2
  35. package/package.json +45 -45
package/AGENTS.md CHANGED
@@ -1,175 +1,175 @@
1
- # AGENTS.md
2
-
3
- This file provides guidance to OpenCode when working with code in this repository.
4
-
5
- ---
6
-
7
- ## 🎯 Core Principles
8
-
9
- ### 1. Evidence-Based Development
10
- **Never guess** — always verify with official sources before implementation:
11
- - Use **context7** MCP for official documentation lookup
12
- - Use **tavily** search for community solutions and patterns
13
- - Check existing code with search before implementing
14
- - Verify assumptions against test results
15
-
16
- ### 2. Confidence-First Implementation
17
- Check confidence **BEFORE** starting work:
18
- - **≥90%**: Proceed with implementation
19
- - **70-89%**: Present alternatives, investigate more
20
- - **<70%**: STOP — ask questions, gather more context
21
-
22
- **ROI**: Spend 100-200 tokens on confidence check to save 5,000-50,000 on wrong direction work.
23
-
24
- ### 3. Parallel-First Execution
25
- Use **Wave → Checkpoint → Wave** pattern:
26
- ```
27
- Wave 1: [Read file1, file2, file3] (parallel)
28
-
29
- Checkpoint: Analyze together
30
-
31
- Wave 2: [Edit file1, file2, file3] (parallel)
32
- ```
33
- **Result**: 3.5x faster than sequential execution.
34
-
35
- ### 4. Self-Correction Protocol
36
- When errors occur:
37
- 1. **STOP** — Never retry the same approach immediately
38
- 2. **Investigate** — Research root cause with documentation
39
- 3. **Hypothesize** — Form theory with evidence
40
- 4. **Redesign** — New approach must differ from failed one
41
- 5. **Execute** — Implement based on understanding
42
- 6. **Learn** — Document for future prevention
43
-
44
- ---
45
-
46
- ## 🛠️ Development Workflow
47
-
48
- ### Starting Any Task
49
- 1. Read AGENTS.md and relevant documentation
50
- 2. Search for existing implementations (avoid duplicates)
51
- 3. Run confidence check (see `.opencode/skills/confidence-check/`)
52
- 4. Only proceed if confidence ≥ 70%
53
-
54
- ### During Implementation
55
- - Use parallel execution where possible
56
- - Document non-obvious decisions inline
57
- - Run tests frequently to catch errors early
58
- - Checkpoint progress for complex tasks
59
-
60
- ### After Implementation
61
- 1. Validate all tests pass
62
- 2. Run self-check protocol (`.opencode/skills/self-check/`)
63
- 3. Document new patterns discovered
64
- 4. Update relevant documentation
65
-
66
- ---
67
-
68
- ## 📏 Quality Standards
69
-
70
- ### Code Quality
71
- - All public functions need docstrings
72
- - Use type hints where supported
73
- - Follow project's existing patterns
74
- - Include usage examples for complex functions
75
-
76
- ### Documentation Quality
77
- - ✅ **Current**: Include "Last Verified" dates
78
- - ✅ **Minimal**: Necessary information only
79
- - ✅ **Clear**: Concrete examples included
80
- - ✅ **Practical**: Copy-paste ready
81
-
82
- ### Testing Standards
83
- - Write tests for new functionality
84
- - Aim for >80% coverage on new code
85
- - Include edge cases and error conditions
86
- - Run full test suite before major changes
87
-
88
- ---
89
-
90
- ## 🔄 PDCA Cycle
91
-
92
- For significant implementations, follow Plan-Do-Check-Act:
93
-
94
- ### Plan (Hypothesis)
95
- - What are we implementing?
96
- - Why this approach?
97
- - What are success criteria?
98
-
99
- ### Do (Experiment)
100
- - Execute the plan
101
- - Track progress and deviations
102
- - Record errors and solutions
103
-
104
- ### Check (Evaluate)
105
- - Did we meet success criteria?
106
- - What worked well?
107
- - What failed?
108
-
109
- ### Act (Improve)
110
- - Success → Extract pattern for reuse
111
- - Failure → Document prevention checklist
112
- - Either → Update knowledge base
113
-
114
- ---
115
-
116
- ## 🚫 Anti-Patterns
117
-
118
- **Never do these:**
119
- - ❌ Retry same failing approach without investigation
120
- - ❌ "Tests pass" without showing actual output
121
- - ❌ Implement before checking for duplicates
122
- - ❌ Skip documentation due to time pressure
123
- - ❌ Ignore warnings ("probably fine")
124
- - ❌ Use "probably works" language
125
-
126
- ---
127
-
128
- ## 📁 Project Structure
129
-
130
- ```
131
- .opencode/
132
- ├── agents/ # Specialized agent personas
133
- ├── commands/ # Slash command definitions
134
- └── skills/ # Reusable skill modules
135
- ├── confidence-check/
136
- ├── self-check/
137
- └── reflexion/
138
-
139
- AGENTS.md # Core principles and guidelines
140
- opencode.json # OpenCode configuration
141
- ```
142
-
143
- ---
144
-
145
- ## 🤖 Agent System
146
-
147
- When complex tasks require specialized expertise, delegate to appropriate agent:
148
-
149
- | Agent | Purpose |
150
- |-------|---------|
151
- | **pm-agent** | Project orchestration, PDCA cycles, documentation |
152
- | **architect** | System design, architecture, technical strategy |
153
- | **backend** | APIs, databases, server-side logic |
154
- | **frontend** | UI/UX, components, styling |
155
- | **security** | Security review, threat modeling |
156
- | **quality** | Testing, code review |
157
- | **researcher** | Deep research, fact-checking |
158
- | **writer** | Technical documentation |
159
- | **reviewer** | Code review, quality assurance |
160
- | **optimizer** | Performance optimization |
161
-
162
- ---
163
-
164
- ## 🔧 MCP Integration
165
-
166
- The framework assumes the following MCP servers are available for optimal performance:
167
- - **context7**: Official documentation lookup
168
- - **serena**: Codebase analysis and navigation
169
- - **tavily**: Web search for research
170
- - **filesystem**: File system access
171
- - **sequential-thinking**: Multi-step reasoning
172
-
173
- ---
174
-
175
- *This document should be read at session start. Update it when global patterns are discovered.*
1
+ # AGENTS.md
2
+
3
+ This file provides guidance to OpenCode when working with code in this repository.
4
+
5
+ ---
6
+
7
+ ## 🎯 Core Principles
8
+
9
+ ### 1. Evidence-Based Development
10
+ **Never guess** — always verify with official sources before implementation:
11
+ - Use **context7** MCP for official documentation lookup
12
+ - Use **tavily** search for community solutions and patterns
13
+ - Check existing code with search before implementing
14
+ - Verify assumptions against test results
15
+
16
+ ### 2. Confidence-First Implementation
17
+ Check confidence **BEFORE** starting work:
18
+ - **≥90%**: Proceed with implementation
19
+ - **70-89%**: Present alternatives, investigate more
20
+ - **<70%**: STOP — ask questions, gather more context
21
+
22
+ **ROI**: Spend 100-200 tokens on confidence check to save 5,000-50,000 on wrong direction work.
23
+
24
+ ### 3. Parallel-First Execution
25
+ Use **Wave → Checkpoint → Wave** pattern:
26
+ ```
27
+ Wave 1: [Read file1, file2, file3] (parallel)
28
+
29
+ Checkpoint: Analyze together
30
+
31
+ Wave 2: [Edit file1, file2, file3] (parallel)
32
+ ```
33
+ **Result**: 3.5x faster than sequential execution.
34
+
35
+ ### 4. Self-Correction Protocol
36
+ When errors occur:
37
+ 1. **STOP** — Never retry the same approach immediately
38
+ 2. **Investigate** — Research root cause with documentation
39
+ 3. **Hypothesize** — Form theory with evidence
40
+ 4. **Redesign** — New approach must differ from failed one
41
+ 5. **Execute** — Implement based on understanding
42
+ 6. **Learn** — Document for future prevention
43
+
44
+ ---
45
+
46
+ ## 🛠️ Development Workflow
47
+
48
+ ### Starting Any Task
49
+ 1. Read AGENTS.md and relevant documentation
50
+ 2. Search for existing implementations (avoid duplicates)
51
+ 3. Run confidence check (see `.opencode/skills/confidence-check/`)
52
+ 4. Only proceed if confidence ≥ 70%
53
+
54
+ ### During Implementation
55
+ - Use parallel execution where possible
56
+ - Document non-obvious decisions inline
57
+ - Run tests frequently to catch errors early
58
+ - Checkpoint progress for complex tasks
59
+
60
+ ### After Implementation
61
+ 1. Validate all tests pass
62
+ 2. Run self-check protocol (`.opencode/skills/self-check/`)
63
+ 3. Document new patterns discovered
64
+ 4. Update relevant documentation
65
+
66
+ ---
67
+
68
+ ## 📏 Quality Standards
69
+
70
+ ### Code Quality
71
+ - All public functions need docstrings
72
+ - Use type hints where supported
73
+ - Follow project's existing patterns
74
+ - Include usage examples for complex functions
75
+
76
+ ### Documentation Quality
77
+ - ✅ **Current**: Include "Last Verified" dates
78
+ - ✅ **Minimal**: Necessary information only
79
+ - ✅ **Clear**: Concrete examples included
80
+ - ✅ **Practical**: Copy-paste ready
81
+
82
+ ### Testing Standards
83
+ - Write tests for new functionality
84
+ - Aim for >80% coverage on new code
85
+ - Include edge cases and error conditions
86
+ - Run full test suite before major changes
87
+
88
+ ---
89
+
90
+ ## 🔄 PDCA Cycle
91
+
92
+ For significant implementations, follow Plan-Do-Check-Act:
93
+
94
+ ### Plan (Hypothesis)
95
+ - What are we implementing?
96
+ - Why this approach?
97
+ - What are success criteria?
98
+
99
+ ### Do (Experiment)
100
+ - Execute the plan
101
+ - Track progress and deviations
102
+ - Record errors and solutions
103
+
104
+ ### Check (Evaluate)
105
+ - Did we meet success criteria?
106
+ - What worked well?
107
+ - What failed?
108
+
109
+ ### Act (Improve)
110
+ - Success → Extract pattern for reuse
111
+ - Failure → Document prevention checklist
112
+ - Either → Update knowledge base
113
+
114
+ ---
115
+
116
+ ## 🚫 Anti-Patterns
117
+
118
+ **Never do these:**
119
+ - ❌ Retry same failing approach without investigation
120
+ - ❌ "Tests pass" without showing actual output
121
+ - ❌ Implement before checking for duplicates
122
+ - ❌ Skip documentation due to time pressure
123
+ - ❌ Ignore warnings ("probably fine")
124
+ - ❌ Use "probably works" language
125
+
126
+ ---
127
+
128
+ ## 📁 Project Structure
129
+
130
+ ```
131
+ .opencode/
132
+ ├── agents/ # Specialized agent personas
133
+ ├── commands/ # Slash command definitions
134
+ └── skills/ # Reusable skill modules
135
+ ├── confidence-check/
136
+ ├── self-check/
137
+ └── reflexion/
138
+
139
+ AGENTS.md # Core principles and guidelines
140
+ opencode.json # OpenCode configuration
141
+ ```
142
+
143
+ ---
144
+
145
+ ## 🤖 Agent System
146
+
147
+ When complex tasks require specialized expertise, delegate to appropriate agent:
148
+
149
+ | Agent | Purpose |
150
+ |-------|---------|
151
+ | **pm-agent** | Project orchestration, PDCA cycles, documentation |
152
+ | **architect** | System design, architecture, technical strategy |
153
+ | **backend** | APIs, databases, server-side logic |
154
+ | **frontend** | UI/UX, components, styling |
155
+ | **security** | Security review, threat modeling |
156
+ | **quality** | Testing, code review |
157
+ | **researcher** | Deep research, fact-checking |
158
+ | **writer** | Technical documentation |
159
+ | **reviewer** | Code review, quality assurance |
160
+ | **optimizer** | Performance optimization |
161
+
162
+ ---
163
+
164
+ ## 🔧 MCP Integration
165
+
166
+ The framework assumes the following MCP servers are available for optimal performance:
167
+ - **context7**: Official documentation lookup
168
+ - **serena**: Codebase analysis and navigation
169
+ - **tavily**: Web search for research
170
+ - **filesystem**: File system access
171
+ - **sequential-thinking**: Multi-step reasoning
172
+
173
+ ---
174
+
175
+ *This document should be read at session start. Update it when global patterns are discovered.*
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Super-OpenCode
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.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Super-OpenCode
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/dist/cli.js CHANGED
@@ -149,8 +149,8 @@ function getMcpServerConfig(serverId, envVars, targetDir) {
149
149
  return configs[serverId];
150
150
  }
151
151
  async function copyFile(src, dest, targetDir, overwrite) {
152
- const srcPath = resolveSafePath(FRAMEWORK_DIR, path.join(FRAMEWORK_DIR, src));
153
- const destPath = resolveSafePath(targetDir, path.join(targetDir, dest));
152
+ const srcPath = resolveSafePath(FRAMEWORK_DIR, src);
153
+ const destPath = resolveSafePath(targetDir, dest);
154
154
  if (await fs.pathExists(srcPath)) {
155
155
  try {
156
156
  await fs.copy(srcPath, destPath, { overwrite });
package/package.json CHANGED
@@ -1,45 +1,45 @@
1
- {
2
- "name": "super-opencode",
3
- "version": "1.1.0",
4
- "description": "Super-OpenCode Framework Installer",
5
- "type": "module",
6
- "main": "dist/cli.js",
7
- "bin": {
8
- "super-opencode": "./dist/cli.js"
9
- },
10
- "files": [
11
- "dist",
12
- "AGENTS.md",
13
- ".opencode",
14
- "README.md",
15
- "LICENSE"
16
- ],
17
- "scripts": {
18
- "build": "tsc",
19
- "lint": "biome check src/",
20
- "format": "biome check --write src/",
21
- "prepublishOnly": "npm run build",
22
- "test": "echo \"Error: no test specified\" && exit 1"
23
- },
24
- "keywords": [
25
- "opencode",
26
- "agent",
27
- "framework",
28
- "cli"
29
- ],
30
- "author": "lst97",
31
- "license": "MIT",
32
- "dependencies": {
33
- "chalk": "^5.6.2",
34
- "fs-extra": "^11.3.3",
35
- "inquirer": "^13.2.1",
36
- "ora": "^9.1.0"
37
- },
38
- "devDependencies": {
39
- "@biomejs/biome": "2.3.13",
40
- "@types/fs-extra": "^11.0.4",
41
- "@types/node": "^25.0.10",
42
- "ts-node": "^10.9.2",
43
- "typescript": "^5.9.3"
44
- }
45
- }
1
+ {
2
+ "name": "super-opencode",
3
+ "version": "1.1.1",
4
+ "description": "Super-OpenCode Framework Installer",
5
+ "type": "module",
6
+ "main": "dist/cli.js",
7
+ "bin": {
8
+ "super-opencode": "./dist/cli.js"
9
+ },
10
+ "files": [
11
+ "dist",
12
+ "AGENTS.md",
13
+ ".opencode",
14
+ "README.md",
15
+ "LICENSE"
16
+ ],
17
+ "scripts": {
18
+ "build": "tsc",
19
+ "lint": "biome check src/",
20
+ "format": "biome check --write src/",
21
+ "prepublishOnly": "npm run build",
22
+ "test": "echo \"Error: no test specified\" && exit 1"
23
+ },
24
+ "keywords": [
25
+ "opencode",
26
+ "agent",
27
+ "framework",
28
+ "cli"
29
+ ],
30
+ "author": "lst97",
31
+ "license": "MIT",
32
+ "dependencies": {
33
+ "chalk": "^5.6.2",
34
+ "fs-extra": "^11.3.3",
35
+ "inquirer": "^13.2.1",
36
+ "ora": "^9.1.0"
37
+ },
38
+ "devDependencies": {
39
+ "@biomejs/biome": "2.3.13",
40
+ "@types/fs-extra": "^11.0.4",
41
+ "@types/node": "^25.0.10",
42
+ "ts-node": "^10.9.2",
43
+ "typescript": "^5.9.3"
44
+ }
45
+ }