moai-adk 0.4.0__py3-none-any.whl → 0.4.1__py3-none-any.whl
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.
Potentially problematic release.
This version of moai-adk might be problematic. Click here for more details.
- moai_adk/__init__.py +1 -8
- moai_adk/cli/commands/init.py +10 -5
- moai_adk/cli/commands/update.py +274 -118
- moai_adk/cli/prompts/init_prompts.py +14 -18
- moai_adk/core/diagnostics/slash_commands.py +1 -1
- moai_adk/core/project/backup_utils.py +1 -0
- moai_adk/core/project/phase_executor.py +3 -1
- moai_adk/core/project/validator.py +3 -2
- moai_adk/core/template/backup.py +11 -3
- moai_adk/core/template/merger.py +16 -3
- moai_adk/core/template/processor.py +22 -3
- moai_adk/templates/.claude/agents/alfred/cc-manager.md +443 -424
- moai_adk/templates/.claude/agents/alfred/debug-helper.md +116 -103
- moai_adk/templates/.claude/agents/alfred/doc-syncer.md +130 -116
- moai_adk/templates/.claude/agents/alfred/git-manager.md +186 -174
- moai_adk/templates/.claude/agents/alfred/implementation-planner.md +227 -213
- moai_adk/templates/.claude/agents/alfred/project-manager.md +205 -125
- moai_adk/templates/.claude/agents/alfred/quality-gate.md +224 -209
- moai_adk/templates/.claude/agents/alfred/spec-builder.md +174 -160
- moai_adk/templates/.claude/agents/alfred/tag-agent.md +151 -139
- moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +209 -196
- moai_adk/templates/.claude/agents/alfred/trust-checker.md +247 -233
- moai_adk/templates/.claude/commands/alfred/0-project.md +673 -640
- moai_adk/templates/.claude/commands/alfred/1-plan.md +342 -333
- moai_adk/templates/.claude/commands/alfred/2-run.md +295 -285
- moai_adk/templates/.claude/commands/alfred/3-sync.md +366 -356
- moai_adk/templates/.claude/hooks/alfred/README.md +52 -52
- moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +44 -48
- moai_adk/templates/.claude/hooks/alfred/core/__init__.py +17 -17
- moai_adk/templates/.claude/hooks/alfred/core/checkpoint.py +59 -59
- moai_adk/templates/.claude/hooks/alfred/core/context.py +19 -19
- moai_adk/templates/.claude/hooks/alfred/core/project.py +52 -52
- moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py +1 -1
- moai_adk/templates/.claude/hooks/alfred/handlers/notification.py +4 -4
- moai_adk/templates/.claude/hooks/alfred/handlers/session.py +27 -27
- moai_adk/templates/.claude/hooks/alfred/handlers/tool.py +16 -17
- moai_adk/templates/.claude/hooks/alfred/handlers/user.py +11 -11
- moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +308 -307
- moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +297 -296
- moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +191 -190
- moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/SKILL.md +112 -0
- moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/SKILL.md +103 -0
- moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md +103 -0
- moai_adk/templates/.claude/skills/moai-alfred-git-workflow/SKILL.md +95 -0
- moai_adk/templates/.claude/skills/moai-alfred-language-detection/SKILL.md +99 -0
- moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/SKILL.md +105 -0
- moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/SKILL.md +97 -0
- moai_adk/templates/.claude/skills/moai-alfred-spec-metadata-validation/SKILL.md +97 -0
- moai_adk/templates/.claude/skills/moai-alfred-tag-scanning/SKILL.md +90 -0
- moai_adk/templates/.claude/skills/moai-alfred-trust-validation/SKILL.md +99 -0
- moai_adk/templates/.claude/skills/moai-alfred-tui-survey/SKILL.md +87 -0
- moai_adk/templates/.claude/skills/moai-alfred-tui-survey/examples.md +62 -0
- moai_adk/templates/.claude/skills/moai-claude-code/SKILL.md +70 -43
- moai_adk/templates/.claude/skills/moai-claude-code/examples.md +141 -141
- moai_adk/templates/.claude/skills/moai-claude-code/reference.md +179 -165
- moai_adk/templates/.claude/skills/moai-claude-code/templates/agent-full.md +78 -78
- moai_adk/templates/.claude/skills/moai-claude-code/templates/command-full.md +90 -90
- moai_adk/templates/.claude/skills/moai-claude-code/templates/plugin-full.json +39 -25
- moai_adk/templates/.claude/skills/moai-claude-code/templates/settings-full.json +117 -74
- moai_adk/templates/.claude/skills/moai-claude-code/templates/skill-full.md +131 -134
- moai_adk/templates/.claude/skills/moai-domain-backend/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-cli-tool/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-data-science/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-database/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-devops/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-frontend/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-ml/SKILL.md +43 -11
- moai_adk/templates/.claude/skills/moai-domain-mobile-app/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-security/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md +43 -12
- moai_adk/templates/.claude/skills/moai-essentials-debug/SKILL.md +47 -11
- moai_adk/templates/.claude/skills/moai-essentials-perf/SKILL.md +47 -11
- moai_adk/templates/.claude/skills/moai-essentials-refactor/SKILL.md +51 -14
- moai_adk/templates/.claude/skills/moai-essentials-review/SKILL.md +46 -10
- moai_adk/templates/.claude/skills/moai-foundation-ears/SKILL.md +62 -25
- moai_adk/templates/.claude/skills/moai-foundation-git/SKILL.md +44 -17
- moai_adk/templates/.claude/skills/moai-foundation-langs/SKILL.md +44 -14
- moai_adk/templates/.claude/skills/moai-foundation-specs/SKILL.md +45 -13
- moai_adk/templates/.claude/skills/moai-foundation-tags/SKILL.md +46 -14
- moai_adk/templates/.claude/skills/moai-foundation-trust/SKILL.md +48 -8
- moai_adk/templates/.claude/skills/moai-lang-c/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-clojure/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-cpp/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-csharp/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-dart/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-elixir/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-go/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-haskell/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-java/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-javascript/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-julia/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-lua/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-php/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-python/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-r/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-rust/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-scala/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-shell/SKILL.md +44 -11
- moai_adk/templates/.claude/skills/moai-lang-sql/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-swift/SKILL.md +44 -12
- moai_adk/templates/.claude/skills/moai-lang-typescript/SKILL.md +44 -12
- moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md +44 -43
- moai_adk/templates/.github/workflows/moai-gitflow.yml +36 -35
- moai_adk/templates/.moai/config.json +9 -6
- moai_adk/templates/.moai/memory/development-guide.md +220 -221
- moai_adk/templates/.moai/memory/gitflow-protection-policy.md +85 -85
- moai_adk/templates/.moai/memory/spec-metadata.md +149 -150
- moai_adk/templates/.moai/project/product.md +90 -90
- moai_adk/templates/.moai/project/structure.md +85 -85
- moai_adk/templates/.moai/project/tech.md +117 -117
- moai_adk/templates/CLAUDE.md +350 -722
- moai_adk-0.4.1.dist-info/METADATA +303 -0
- moai_adk-0.4.1.dist-info/RECORD +152 -0
- moai_adk/templates/.claude/commands/alfred/1-spec.md +0 -31
- moai_adk/templates/.claude/commands/alfred/2-build.md +0 -30
- moai_adk/templates/.claude/skills/scripts/standardize_skills.py +0 -166
- moai_adk/templates/.claude/skills/scripts/verify_standardization.sh +0 -43
- moai_adk/templates/.moai/hooks/pre-push.sample +0 -88
- moai_adk-0.4.0.dist-info/METADATA +0 -1816
- moai_adk-0.4.0.dist-info/RECORD +0 -145
- {moai_adk-0.4.0.dist-info → moai_adk-0.4.1.dist-info}/WHEEL +0 -0
- {moai_adk-0.4.0.dist-info → moai_adk-0.4.1.dist-info}/entry_points.txt +0 -0
- {moai_adk-0.4.0.dist-info → moai_adk-0.4.1.dist-info}/licenses/LICENSE +0 -0
|
@@ -19,7 +19,7 @@ allowed-tools:
|
|
|
19
19
|
|
|
20
20
|
{Comprehensive 2-3 sentence description of command's purpose, integration with MoAI-ADK workflow, and key benefits}
|
|
21
21
|
|
|
22
|
-
## 🎯
|
|
22
|
+
## 🎯 Command Purpose
|
|
23
23
|
|
|
24
24
|
{Detailed multi-paragraph explanation covering:
|
|
25
25
|
- What problem this command solves
|
|
@@ -27,13 +27,13 @@ allowed-tools:
|
|
|
27
27
|
- When to use this command vs alternatives
|
|
28
28
|
- What makes this command unique/valuable}
|
|
29
29
|
|
|
30
|
-
## 📋
|
|
30
|
+
## 📋 Execution flow (2-Phase structure)
|
|
31
31
|
|
|
32
|
-
### ⚙️ Phase 0:
|
|
32
|
+
### ⚙️ Phase 0: Environmental Analysis (Optional)
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
**Purpose**: {Pre-execution analysis purpose}
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
**execution**:
|
|
37
37
|
```bash
|
|
38
38
|
# {Environment check description}
|
|
39
39
|
{command-1}
|
|
@@ -42,7 +42,7 @@ allowed-tools:
|
|
|
42
42
|
{command-2}
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
**verification**:
|
|
46
46
|
- [ ] {Prerequisite 1 checked}
|
|
47
47
|
- [ ] {Prerequisite 2 verified}
|
|
48
48
|
|
|
@@ -50,14 +50,14 @@ allowed-tools:
|
|
|
50
50
|
|
|
51
51
|
### 📊 Phase 1: {Planning/Analysis Phase}
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
**Purpose**: {Detailed purpose of planning phase}
|
|
54
54
|
|
|
55
|
-
|
|
55
|
+
**Automatic processing**:
|
|
56
56
|
- {Auto-task 1 that happens without user input}
|
|
57
57
|
- {Auto-task 2 that system handles}
|
|
58
58
|
- {Auto-task 3 performed automatically}
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
**Execution Steps**:
|
|
61
61
|
|
|
62
62
|
#### 1.1 {First Sub-Step}
|
|
63
63
|
```bash
|
|
@@ -65,7 +65,7 @@ allowed-tools:
|
|
|
65
65
|
{command-or-action}
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
**Output**:
|
|
69
69
|
- {Output 1 with format specification}
|
|
70
70
|
- {Output 2 with expected structure}
|
|
71
71
|
|
|
@@ -74,30 +74,30 @@ allowed-tools:
|
|
|
74
74
|
{commands}
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
|
|
77
|
+
**Output**:
|
|
78
78
|
- {Intermediate output description}
|
|
79
79
|
|
|
80
|
-
#### 1.3 {
|
|
80
|
+
#### 1.3 {User Confirmation}
|
|
81
81
|
|
|
82
|
-
**AskUserQuestion
|
|
82
|
+
**AskUserQuestion timing**: {When user confirmation is needed}
|
|
83
83
|
|
|
84
|
-
|
|
84
|
+
**Confirmation**:
|
|
85
85
|
```typescript
|
|
86
86
|
AskUserQuestion({
|
|
87
87
|
questions: [{
|
|
88
88
|
question: "{What to ask user}?",
|
|
89
89
|
header: "{Short header}",
|
|
90
90
|
options: [
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
91
|
+
{ label: "Proceed", description: "Execute Phase 2" },
|
|
92
|
+
{ label: "Modify", description: "{What modification means}" },
|
|
93
|
+
{ label: "Abort", description: "Cancel operation" }
|
|
94
94
|
],
|
|
95
95
|
multiSelect: false
|
|
96
96
|
}]
|
|
97
97
|
})
|
|
98
98
|
```
|
|
99
99
|
|
|
100
|
-
**Phase 1
|
|
100
|
+
**Phase 1 deliverable (final)**:
|
|
101
101
|
- {Complete output 1 from planning}
|
|
102
102
|
- {Complete output 2 ready for execution}
|
|
103
103
|
- {User-approved plan}
|
|
@@ -106,14 +106,14 @@ AskUserQuestion({
|
|
|
106
106
|
|
|
107
107
|
### 🚀 Phase 2: {Execution Phase}
|
|
108
108
|
|
|
109
|
-
|
|
109
|
+
**Purpose**: {Detailed purpose of execution phase}
|
|
110
110
|
|
|
111
|
-
|
|
112
|
-
- [ ] Phase 1
|
|
111
|
+
**Prerequisites**:
|
|
112
|
+
- [ ] Phase 1 completed and user approved
|
|
113
113
|
- [ ] {Additional precondition 1}
|
|
114
114
|
- [ ] {Additional precondition 2}
|
|
115
115
|
|
|
116
|
-
|
|
116
|
+
**Execution Steps**:
|
|
117
117
|
|
|
118
118
|
#### 2.1 {First Execution Step}
|
|
119
119
|
```bash
|
|
@@ -124,7 +124,7 @@ AskUserQuestion({
|
|
|
124
124
|
{execution-command-2}
|
|
125
125
|
```
|
|
126
126
|
|
|
127
|
-
|
|
127
|
+
**Real-time progress**:
|
|
128
128
|
```
|
|
129
129
|
{Progress indicator format}
|
|
130
130
|
[▓▓▓▓▓▓▓░░░] {percentage}% - {current-action}
|
|
@@ -135,7 +135,7 @@ AskUserQuestion({
|
|
|
135
135
|
{commands-with-explanations}
|
|
136
136
|
```
|
|
137
137
|
|
|
138
|
-
#### 2.3 {
|
|
138
|
+
#### 2.3 {Quality Verification}
|
|
139
139
|
```bash
|
|
140
140
|
# {Validation check 1}
|
|
141
141
|
{validation-command-1}
|
|
@@ -144,36 +144,36 @@ AskUserQuestion({
|
|
|
144
144
|
{validation-command-2}
|
|
145
145
|
```
|
|
146
146
|
|
|
147
|
-
|
|
147
|
+
**Verification Criteria**:
|
|
148
148
|
- [ ] {Quality criterion 1 with threshold}
|
|
149
149
|
- [ ] {Quality criterion 2 with expected value}
|
|
150
150
|
- [ ] {Quality criterion 3 with pass/fail}
|
|
151
151
|
|
|
152
|
-
**Phase 2
|
|
152
|
+
**Phase 2 final output**:
|
|
153
153
|
```{format}
|
|
154
154
|
{example-final-output-structure}
|
|
155
155
|
```
|
|
156
156
|
|
|
157
|
-
## 🔗
|
|
157
|
+
## 🔗 Associated Agent
|
|
158
158
|
|
|
159
159
|
### Primary Agent
|
|
160
160
|
- **{agent-name}** ({Icon} {Persona})
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
161
|
+
- **Expertise**: {Expertise}
|
|
162
|
+
- **When invoked**: {When invoked}
|
|
163
|
+
- **Role**: {What agent does in this command}
|
|
164
164
|
|
|
165
165
|
### Secondary Agents
|
|
166
166
|
- **{agent-2}** ({Icon} {Role}) - {Integration scenario}
|
|
167
167
|
- **{agent-3}** ({Icon} {Role}) - {When used}
|
|
168
168
|
|
|
169
|
-
## 💡
|
|
169
|
+
## 💡 Example of use
|
|
170
170
|
|
|
171
|
-
###
|
|
171
|
+
### Default Enabled
|
|
172
172
|
```bash
|
|
173
173
|
/{command-name} {basic-example}
|
|
174
174
|
```
|
|
175
175
|
|
|
176
|
-
###
|
|
176
|
+
### Advanced Use
|
|
177
177
|
```bash
|
|
178
178
|
# {Advanced use case 1}
|
|
179
179
|
/{command-name} {param1} --{option1}={value1}
|
|
@@ -182,9 +182,9 @@ AskUserQuestion({
|
|
|
182
182
|
/{command-name} {param1} {param2} --{flag}
|
|
183
183
|
```
|
|
184
184
|
|
|
185
|
-
###
|
|
185
|
+
### Real-world scenarios
|
|
186
186
|
|
|
187
|
-
####
|
|
187
|
+
#### Scenario 1: {Common Workflow}
|
|
188
188
|
```bash
|
|
189
189
|
# Step 1: {What user does first}
|
|
190
190
|
/{command-name} "{example-input}"
|
|
@@ -193,7 +193,7 @@ AskUserQuestion({
|
|
|
193
193
|
# Next: {What to do next}
|
|
194
194
|
```
|
|
195
195
|
|
|
196
|
-
####
|
|
196
|
+
#### Scenario 2: {Edge Case}
|
|
197
197
|
```bash
|
|
198
198
|
# When {special condition}
|
|
199
199
|
/{command-name} {special-params}
|
|
@@ -201,57 +201,57 @@ AskUserQuestion({
|
|
|
201
201
|
# Handles: {How command adapts}
|
|
202
202
|
```
|
|
203
203
|
|
|
204
|
-
##
|
|
204
|
+
## Command argument details
|
|
205
205
|
|
|
206
|
-
|
|
|
206
|
+
| Arguments/Options | Type | Required | default | Description |
|
|
207
207
|
|----------|------|------|--------|------|
|
|
208
208
|
| `{param1}` | {type} | ✅ | - | {Detailed description of param1} |
|
|
209
209
|
| `{param2}` | {type} | ⚠️ | {default} | {Detailed description of param2} |
|
|
210
210
|
| `--{option1}` | {type} | ⚠️ | {default} | {What this option controls} |
|
|
211
211
|
| `--{flag}` | boolean | ⚠️ | false | {When to use this flag} |
|
|
212
212
|
|
|
213
|
-
|
|
213
|
+
**Argument Validation**:
|
|
214
214
|
- {Validation rule 1}
|
|
215
215
|
- {Validation rule 2}
|
|
216
216
|
|
|
217
|
-
## ⚠️
|
|
217
|
+
## ⚠️ Prohibitions
|
|
218
218
|
|
|
219
|
-
|
|
219
|
+
**What you should never do**:
|
|
220
220
|
|
|
221
221
|
- ❌ {Prohibited action 1 with explanation}
|
|
222
222
|
- ❌ {Prohibited action 2 with reason}
|
|
223
223
|
- ❌ {Prohibited action 3 with alternative}
|
|
224
224
|
|
|
225
|
-
|
|
225
|
+
**Expressions to use**:
|
|
226
226
|
|
|
227
227
|
- ✅ {Recommended practice 1}
|
|
228
228
|
- ✅ {Recommended practice 2}
|
|
229
229
|
|
|
230
|
-
## 🚨
|
|
230
|
+
## 🚨 Error handling
|
|
231
231
|
|
|
232
|
-
###
|
|
232
|
+
### Common errors
|
|
233
233
|
|
|
234
|
-
|
|
|
234
|
+
| error message | Cause | Solution |
|
|
235
235
|
|-----------|------|----------|
|
|
236
236
|
| `{Error 1}` | {Root cause} | {Step-by-step solution} |
|
|
237
237
|
| `{Error 2}` | {What triggers it} | {How to fix} |
|
|
238
238
|
| `{Error 3}` | {Condition} | {Resolution} |
|
|
239
239
|
|
|
240
|
-
###
|
|
240
|
+
### Recovery Procedure
|
|
241
241
|
|
|
242
242
|
1. **{Recovery Step 1}**: {What to do first}
|
|
243
243
|
2. **{Recovery Step 2}**: {Next action}
|
|
244
244
|
3. **{Fallback}**: {Last resort if all fails}
|
|
245
245
|
|
|
246
|
-
## ✅
|
|
246
|
+
## ✅ Success Criteria
|
|
247
247
|
|
|
248
|
-
|
|
248
|
+
**Check points after executing the command**:
|
|
249
249
|
|
|
250
250
|
- [ ] {Success criterion 1 with verification method}
|
|
251
251
|
- [ ] {Success criterion 2 with expected outcome}
|
|
252
252
|
- [ ] {Success criterion 3 with deliverable}
|
|
253
253
|
|
|
254
|
-
|
|
254
|
+
**Quality Gate**:
|
|
255
255
|
```bash
|
|
256
256
|
# {Quality check 1}
|
|
257
257
|
{verification-command-1}
|
|
@@ -260,21 +260,21 @@ AskUserQuestion({
|
|
|
260
260
|
{verification-command-2}
|
|
261
261
|
```
|
|
262
262
|
|
|
263
|
-
## 📋
|
|
263
|
+
## 📋 Next steps
|
|
264
264
|
|
|
265
|
-
|
|
265
|
+
**Recommended Workflow**:
|
|
266
266
|
|
|
267
|
-
1.
|
|
268
|
-
2.
|
|
269
|
-
3.
|
|
267
|
+
1. **Execute immediately**: {What to do right after command completes}
|
|
268
|
+
2. **Verification**: {How to verify results}
|
|
269
|
+
3. **Next command**: `/{next-command}` - {Why this is next}
|
|
270
270
|
|
|
271
|
-
|
|
271
|
+
**Alternative Path**:
|
|
272
272
|
- {Alternative path 1 if condition X}
|
|
273
273
|
- {Alternative path 2 if condition Y}
|
|
274
274
|
|
|
275
|
-
## 🔄
|
|
275
|
+
## 🔄 Integrated Workflow
|
|
276
276
|
|
|
277
|
-
### MoAI-ADK
|
|
277
|
+
### MoAI-ADK workflow location
|
|
278
278
|
|
|
279
279
|
```
|
|
280
280
|
/{prev-command} → /{command-name} → /{next-command}
|
|
@@ -282,31 +282,31 @@ AskUserQuestion({
|
|
|
282
282
|
{Connected agents/tasks}
|
|
283
283
|
```
|
|
284
284
|
|
|
285
|
-
###
|
|
285
|
+
### Relationship with other commands
|
|
286
286
|
|
|
287
|
-
|
|
|
287
|
+
| command | relationship | Execution order |
|
|
288
288
|
|--------|------|----------|
|
|
289
289
|
| `/{related-1}` | {Relationship} | {Before/After/Parallel} |
|
|
290
290
|
| `/{related-2}` | {Relationship} | {Sequence} |
|
|
291
291
|
|
|
292
|
-
## 📊
|
|
292
|
+
## 📊 Performance Metrics
|
|
293
293
|
|
|
294
|
-
-
|
|
295
|
-
-
|
|
296
|
-
-
|
|
297
|
-
- **API
|
|
294
|
+
- **Average execution time**: {Expected duration}
|
|
295
|
+
- **Memory usage**: {Expected memory}
|
|
296
|
+
- **Number of files created**: {Expected file count}
|
|
297
|
+
- **API calls**: {Expected external calls}
|
|
298
298
|
|
|
299
|
-
## 🎓
|
|
299
|
+
## 🎓 Best Practices
|
|
300
300
|
|
|
301
301
|
### 1. {Practice Category 1}
|
|
302
302
|
|
|
303
|
-
|
|
303
|
+
**Recommended**:
|
|
304
304
|
```bash
|
|
305
305
|
# {Good example}
|
|
306
306
|
/{command-name} {recommended-usage}
|
|
307
307
|
```
|
|
308
308
|
|
|
309
|
-
|
|
309
|
+
**Not recommended**:
|
|
310
310
|
```bash
|
|
311
311
|
# {Bad example - why to avoid}
|
|
312
312
|
/{command-name} {anti-pattern}
|
|
@@ -314,61 +314,61 @@ AskUserQuestion({
|
|
|
314
314
|
|
|
315
315
|
### 2. {Practice Category 2}
|
|
316
316
|
|
|
317
|
-
|
|
317
|
+
**Tip**: {Helpful tip or trick}
|
|
318
318
|
|
|
319
319
|
### 3. {Practice Category 3}
|
|
320
320
|
|
|
321
|
-
|
|
321
|
+
**Caution**: {Important consideration}
|
|
322
322
|
|
|
323
|
-
## 🔗
|
|
323
|
+
## 🔗 Related Resources
|
|
324
324
|
|
|
325
|
-
###
|
|
325
|
+
### Related commands
|
|
326
326
|
- `/{command-1}` - {Description and relation}
|
|
327
327
|
- `/{command-2}` - {Description and when to use}
|
|
328
328
|
|
|
329
|
-
###
|
|
329
|
+
### Related Agents
|
|
330
330
|
- `@agent-{agent-1}` - {How it supports this command}
|
|
331
331
|
- `@agent-{agent-2}` - {Integration point}
|
|
332
332
|
|
|
333
|
-
###
|
|
333
|
+
### document
|
|
334
334
|
- **SPEC**: {Link to specification}
|
|
335
|
-
-
|
|
336
|
-
-
|
|
335
|
+
- **Guide**: {Link to detailed guide}
|
|
336
|
+
- **Examples**: {Link to examples}
|
|
337
337
|
|
|
338
|
-
## 📝
|
|
338
|
+
## 📝 Command output example
|
|
339
339
|
|
|
340
|
-
|
|
340
|
+
**Success Case**:
|
|
341
341
|
```
|
|
342
|
-
✅ {Command Name}
|
|
342
|
+
✅ {Command Name} completed
|
|
343
343
|
|
|
344
|
-
📊
|
|
344
|
+
📊 Execution result:
|
|
345
345
|
- {Result metric 1}: {value}
|
|
346
346
|
- {Result metric 2}: {value}
|
|
347
347
|
- {Result metric 3}: {value}
|
|
348
348
|
|
|
349
|
-
📁
|
|
349
|
+
📁 Files generated:
|
|
350
350
|
- {File 1}: {Description}
|
|
351
351
|
- {File 2}: {Description}
|
|
352
352
|
|
|
353
|
-
📋
|
|
353
|
+
📋 Next steps:
|
|
354
354
|
- {Next step 1}
|
|
355
355
|
- {Next step 2}
|
|
356
356
|
```
|
|
357
357
|
|
|
358
|
-
|
|
358
|
+
**Error Case**:
|
|
359
359
|
```
|
|
360
|
-
❌ {Command Name}
|
|
360
|
+
❌ {Command Name} failed
|
|
361
361
|
|
|
362
|
-
🔍
|
|
363
|
-
-
|
|
364
|
-
-
|
|
365
|
-
-
|
|
362
|
+
🔍 Error details:
|
|
363
|
+
- Type: {Error type}
|
|
364
|
+
- Location: {Where error occurred}
|
|
365
|
+
- Message: {Error message}
|
|
366
366
|
|
|
367
|
-
💡
|
|
367
|
+
💡 Solution:
|
|
368
368
|
1. {Solution step 1}
|
|
369
369
|
2. {Solution step 2}
|
|
370
370
|
|
|
371
|
-
📞
|
|
371
|
+
📞 Additional help: {Where to get help}
|
|
372
372
|
```
|
|
373
373
|
|
|
374
374
|
---
|
|
@@ -381,4 +381,4 @@ AskUserQuestion({
|
|
|
381
381
|
|
|
382
382
|
---
|
|
383
383
|
|
|
384
|
-
|
|
384
|
+
This command provides standard automation for {workflow-domain}.
|
|
@@ -2,12 +2,14 @@
|
|
|
2
2
|
"_comment": "Full Plugin Template - MoAI-ADK Production Integration",
|
|
3
3
|
"_usage": "Complete MCP server configuration for MoAI-ADK workflows",
|
|
4
4
|
"_docs": "https://modelcontextprotocol.io/",
|
|
5
|
-
"_moai_integration": "Optimized for /alfred:0-project → /alfred:1-
|
|
6
|
-
|
|
5
|
+
"_moai_integration": "Optimized for /alfred:0-project → /alfred:1-plan → /alfred:2-run → /alfred:3-sync",
|
|
7
6
|
"mcpServers": {
|
|
8
7
|
"github": {
|
|
9
8
|
"command": "npx",
|
|
10
|
-
"args": [
|
|
9
|
+
"args": [
|
|
10
|
+
"-y",
|
|
11
|
+
"@modelcontextprotocol/server-github"
|
|
12
|
+
],
|
|
11
13
|
"env": {
|
|
12
14
|
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
|
|
13
15
|
},
|
|
@@ -17,7 +19,11 @@
|
|
|
17
19
|
"alfred_2_build": "Create feature branches, commit with TDD messages",
|
|
18
20
|
"alfred_3_sync": "Update PR description, transition Draft → Ready, auto-merge"
|
|
19
21
|
},
|
|
20
|
-
"_required_scopes": [
|
|
22
|
+
"_required_scopes": [
|
|
23
|
+
"repo",
|
|
24
|
+
"read:org",
|
|
25
|
+
"workflow"
|
|
26
|
+
],
|
|
21
27
|
"_workflow_automation": [
|
|
22
28
|
"Automatic branch creation from SPEC ID (feature/SPEC-AUTH-001)",
|
|
23
29
|
"Draft PR creation with SPEC template",
|
|
@@ -25,7 +31,6 @@
|
|
|
25
31
|
"Auto-merge after CI/CD passes"
|
|
26
32
|
]
|
|
27
33
|
},
|
|
28
|
-
|
|
29
34
|
"filesystem": {
|
|
30
35
|
"command": "npx",
|
|
31
36
|
"args": [
|
|
@@ -50,10 +55,12 @@
|
|
|
50
55
|
},
|
|
51
56
|
"_best_practice": "Use environment variable for project root to support multiple projects"
|
|
52
57
|
},
|
|
53
|
-
|
|
54
58
|
"brave-search": {
|
|
55
59
|
"command": "npx",
|
|
56
|
-
"args": [
|
|
60
|
+
"args": [
|
|
61
|
+
"-y",
|
|
62
|
+
"@modelcontextprotocol/server-brave-search"
|
|
63
|
+
],
|
|
57
64
|
"env": {
|
|
58
65
|
"BRAVE_API_KEY": "${BRAVE_API_KEY}"
|
|
59
66
|
},
|
|
@@ -68,10 +75,12 @@
|
|
|
68
75
|
"_signup": "https://brave.com/search/api/"
|
|
69
76
|
}
|
|
70
77
|
},
|
|
71
|
-
|
|
72
78
|
"_moai_adk_workflow_integration": {
|
|
73
79
|
"alfred_0_project": {
|
|
74
|
-
"plugins_used": [
|
|
80
|
+
"plugins_used": [
|
|
81
|
+
"brave-search",
|
|
82
|
+
"filesystem"
|
|
83
|
+
],
|
|
75
84
|
"tasks": [
|
|
76
85
|
"Search for latest framework docs (brave-search)",
|
|
77
86
|
"Read existing product.md if present (filesystem)",
|
|
@@ -79,7 +88,10 @@
|
|
|
79
88
|
]
|
|
80
89
|
},
|
|
81
90
|
"alfred_1_spec": {
|
|
82
|
-
"plugins_used": [
|
|
91
|
+
"plugins_used": [
|
|
92
|
+
"github",
|
|
93
|
+
"filesystem"
|
|
94
|
+
],
|
|
83
95
|
"tasks": [
|
|
84
96
|
"Read product.md for context (filesystem)",
|
|
85
97
|
"Write SPEC-{ID}/spec.md (filesystem)",
|
|
@@ -89,7 +101,10 @@
|
|
|
89
101
|
]
|
|
90
102
|
},
|
|
91
103
|
"alfred_2_build": {
|
|
92
|
-
"plugins_used": [
|
|
104
|
+
"plugins_used": [
|
|
105
|
+
"filesystem",
|
|
106
|
+
"github"
|
|
107
|
+
],
|
|
93
108
|
"tasks": [
|
|
94
109
|
"Read SPEC-{ID}/spec.md (filesystem)",
|
|
95
110
|
"Write test files @TEST:ID (filesystem)",
|
|
@@ -98,7 +113,10 @@
|
|
|
98
113
|
]
|
|
99
114
|
},
|
|
100
115
|
"alfred_3_sync": {
|
|
101
|
-
"plugins_used": [
|
|
116
|
+
"plugins_used": [
|
|
117
|
+
"filesystem",
|
|
118
|
+
"github"
|
|
119
|
+
],
|
|
102
120
|
"tasks": [
|
|
103
121
|
"Scan @TAG chain with rg (filesystem)",
|
|
104
122
|
"Update Living Documents (filesystem)",
|
|
@@ -108,7 +126,6 @@
|
|
|
108
126
|
]
|
|
109
127
|
}
|
|
110
128
|
},
|
|
111
|
-
|
|
112
129
|
"_environment_variables_template": {
|
|
113
130
|
"bash_zsh": [
|
|
114
131
|
"# MoAI-ADK Plugin Configuration",
|
|
@@ -150,11 +167,13 @@
|
|
|
150
167
|
"# Allow: direnv allow ."
|
|
151
168
|
]
|
|
152
169
|
},
|
|
153
|
-
|
|
154
170
|
"_team_collaboration": {
|
|
155
171
|
"shared_config": {
|
|
156
172
|
"_approach": "Commit mcpServers config, use .env for secrets",
|
|
157
|
-
"_gitignore": [
|
|
173
|
+
"_gitignore": [
|
|
174
|
+
".env",
|
|
175
|
+
".claude/settings.local.json"
|
|
176
|
+
],
|
|
158
177
|
"_shared_file": ".claude/settings.json (commit)",
|
|
159
178
|
"_local_file": ".claude/settings.local.json (gitignore)",
|
|
160
179
|
"_merge_strategy": "settings.local.json overrides settings.json"
|
|
@@ -175,7 +194,6 @@
|
|
|
175
194
|
}
|
|
176
195
|
}
|
|
177
196
|
},
|
|
178
|
-
|
|
179
197
|
"_ci_cd_integration": {
|
|
180
198
|
"github_actions": {
|
|
181
199
|
"secrets_setup": [
|
|
@@ -186,14 +204,16 @@
|
|
|
186
204
|
],
|
|
187
205
|
"workflow_example": {
|
|
188
206
|
"name": "MoAI-ADK CI",
|
|
189
|
-
"on": [
|
|
207
|
+
"on": [
|
|
208
|
+
"push",
|
|
209
|
+
"pull_request"
|
|
210
|
+
],
|
|
190
211
|
"env": {
|
|
191
212
|
"GITHUB_PERSONAL_ACCESS_TOKEN": "${{ secrets.GITHUB_PERSONAL_ACCESS_TOKEN }}"
|
|
192
213
|
}
|
|
193
214
|
}
|
|
194
215
|
}
|
|
195
216
|
},
|
|
196
|
-
|
|
197
217
|
"_advanced_configuration": {
|
|
198
218
|
"rate_limiting": {
|
|
199
219
|
"_note": "Prevent API quota exhaustion",
|
|
@@ -211,7 +231,6 @@
|
|
|
211
231
|
"_useful_for": "Troubleshooting connection issues, API errors"
|
|
212
232
|
}
|
|
213
233
|
},
|
|
214
|
-
|
|
215
234
|
"_security_hardening": {
|
|
216
235
|
"token_rotation": {
|
|
217
236
|
"frequency": "Quarterly or after team member departure",
|
|
@@ -233,7 +252,6 @@
|
|
|
233
252
|
"api_usage": "Check Brave Search API dashboard for anomalies"
|
|
234
253
|
}
|
|
235
254
|
},
|
|
236
|
-
|
|
237
255
|
"_performance_optimization": {
|
|
238
256
|
"startup_time": {
|
|
239
257
|
"baseline": "Each MCP server adds ~500ms to startup",
|
|
@@ -251,7 +269,6 @@
|
|
|
251
269
|
"timeout_settings": "MCP servers have 30s default timeout"
|
|
252
270
|
}
|
|
253
271
|
},
|
|
254
|
-
|
|
255
272
|
"_monitoring_and_alerts": {
|
|
256
273
|
"health_checks": [
|
|
257
274
|
"Verify: All plugins load successfully at startup",
|
|
@@ -271,7 +288,6 @@
|
|
|
271
288
|
"_notification": "Set up OS notifications for critical errors (advanced)"
|
|
272
289
|
}
|
|
273
290
|
},
|
|
274
|
-
|
|
275
291
|
"_troubleshooting_guide": {
|
|
276
292
|
"common_issues": {
|
|
277
293
|
"plugin_not_loading": {
|
|
@@ -316,7 +332,6 @@
|
|
|
316
332
|
}
|
|
317
333
|
}
|
|
318
334
|
},
|
|
319
|
-
|
|
320
335
|
"_validation_checklist": [
|
|
321
336
|
"✅ settings.json is valid JSON (no syntax errors)",
|
|
322
337
|
"✅ All environment variables are set (printenv | grep -E 'GITHUB|BRAVE|MOAI')",
|
|
@@ -329,7 +344,6 @@
|
|
|
329
344
|
"✅ Claude Code restarts successfully",
|
|
330
345
|
"✅ All plugins load without errors"
|
|
331
346
|
],
|
|
332
|
-
|
|
333
347
|
"_template_level": "full",
|
|
334
348
|
"_best_for": "MoAI-ADK production workflows, team collaboration, CI/CD",
|
|
335
349
|
"_features": [
|
|
@@ -346,4 +360,4 @@
|
|
|
346
360
|
"_estimated_time": "45-60 minutes for full setup",
|
|
347
361
|
"_maintenance": "Monthly review of tokens, quarterly rotation, continuous monitoring",
|
|
348
362
|
"_support": "Full MoAI-ADK workflow integration support"
|
|
349
|
-
}
|
|
363
|
+
}
|