@yamo/memory-mesh 2.1.1 β 2.1.2
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/bin/setup.js +48 -31
- package/package.json +1 -1
- package/skills/SKILL.md +4 -555
- package/skills/skill-super.yamo +548 -0
package/bin/setup.js
CHANGED
|
@@ -65,21 +65,18 @@ async function copyWithPrompt(src, dest, label) {
|
|
|
65
65
|
async function installSkills() {
|
|
66
66
|
log('\nπ¦ Installing YAMO Skills...', 'blue');
|
|
67
67
|
|
|
68
|
-
const
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
mkdirSync(claudeSkillsDir, { recursive: true });
|
|
81
|
-
log(` β Created ${claudeSkillsDir}`, 'green');
|
|
82
|
-
}
|
|
68
|
+
const targetDirs = [
|
|
69
|
+
{
|
|
70
|
+
name: 'Claude Code',
|
|
71
|
+
base: join(homedir(), '.claude'),
|
|
72
|
+
skills: join(homedir(), '.claude', 'skills', 'yamo-super')
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
name: 'Gemini CLI',
|
|
76
|
+
base: join(homedir(), '.gemini'),
|
|
77
|
+
skills: join(homedir(), '.gemini', 'skills', 'yamo-super')
|
|
78
|
+
}
|
|
79
|
+
];
|
|
83
80
|
|
|
84
81
|
const skillsSourceDir = join(packageRoot, 'skills');
|
|
85
82
|
if (!existsSync(skillsSourceDir)) {
|
|
@@ -87,23 +84,41 @@ async function installSkills() {
|
|
|
87
84
|
return { installed: 0, skipped: 0 };
|
|
88
85
|
}
|
|
89
86
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
87
|
+
const skillFiles = readdirSync(skillsSourceDir);
|
|
88
|
+
let totalInstalled = 0;
|
|
89
|
+
let totalSkipped = 0;
|
|
90
|
+
let detectedCount = 0;
|
|
94
91
|
|
|
95
|
-
|
|
96
|
-
|
|
92
|
+
for (const target of targetDirs) {
|
|
93
|
+
// Check if the CLI environment is detected
|
|
94
|
+
if (!existsSync(target.base)) {
|
|
95
|
+
continue;
|
|
96
|
+
}
|
|
97
97
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
if (
|
|
103
|
-
|
|
98
|
+
detectedCount++;
|
|
99
|
+
log(` Installing to ${target.name}...`, 'blue');
|
|
100
|
+
|
|
101
|
+
// Create skills directory
|
|
102
|
+
if (!existsSync(target.skills)) {
|
|
103
|
+
mkdirSync(target.skills, { recursive: true });
|
|
104
|
+
log(` β Created ${target.skills}`, 'green');
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
for (const file of skillFiles) {
|
|
108
|
+
const src = join(skillsSourceDir, file);
|
|
109
|
+
const dest = join(target.skills, file);
|
|
110
|
+
const success = await copyWithPrompt(src, dest, `${target.name}: ${file}`);
|
|
111
|
+
if (success) totalInstalled++;
|
|
112
|
+
else totalSkipped++;
|
|
113
|
+
}
|
|
104
114
|
}
|
|
105
115
|
|
|
106
|
-
|
|
116
|
+
if (detectedCount === 0) {
|
|
117
|
+
log('β No supported AI environment detected (~/.claude or ~/.gemini not found)', 'yellow');
|
|
118
|
+
log(' Skills will be skipped.', 'yellow');
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
return { installed: totalInstalled, skipped: totalSkipped };
|
|
107
122
|
}
|
|
108
123
|
|
|
109
124
|
async function installTools() {
|
|
@@ -147,11 +162,13 @@ function showUsage() {
|
|
|
147
162
|
const pkg = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf-8'));
|
|
148
163
|
|
|
149
164
|
log('\n⨠Setup Complete!', 'bright');
|
|
150
|
-
log('\nYAMO Skills installed to:
|
|
165
|
+
log('\nYAMO Skills installed to AI CLI environments:', 'blue');
|
|
166
|
+
log(' β’ ~/.claude/skills/yamo-super/', 'blue');
|
|
167
|
+
log(' β’ ~/.gemini/skills/yamo-super/', 'blue');
|
|
151
168
|
log('Tools installed to: ./tools/', 'blue');
|
|
152
169
|
|
|
153
170
|
log('\nπ Usage:', 'bright');
|
|
154
|
-
log(' β’ Use /yamo-super in Claude
|
|
171
|
+
log(' β’ Use /yamo-super in Claude or Gemini for workflow automation');
|
|
155
172
|
log(' β’ Use /scrubber skill for content sanitization');
|
|
156
173
|
log(' β’ Call tools/memory_mesh.js for memory operations');
|
|
157
174
|
|
|
@@ -167,7 +184,7 @@ async function main() {
|
|
|
167
184
|
log('ββββββββββββββββββββββββββββββββββββββββββ', 'bright');
|
|
168
185
|
|
|
169
186
|
try {
|
|
170
|
-
// Install skills to ~/.claude/skills/
|
|
187
|
+
// Install skills to ~/.claude/skills/yamo-super/
|
|
171
188
|
const skillResults = await installSkills();
|
|
172
189
|
|
|
173
190
|
// Install tools to ./tools/
|
package/package.json
CHANGED
package/skills/SKILL.md
CHANGED
|
@@ -1,555 +1,4 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: yamo-super
|
|
3
|
-
description:
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
For all code improvement or creation tasks, strictly adhere to the logic, agents, and constraints defined in this Yamo Skill:
|
|
7
|
-
|
|
8
|
-
metadata:
|
|
9
|
-
name;YamoSuper;
|
|
10
|
-
version;2.1.0;
|
|
11
|
-
description;Comprehensive AI coding workflow system with automatic memory integration for pattern recognition and workflow optimization;
|
|
12
|
-
author;Derived from Superpowers by Jesse Scott;adapted for YAMO by Soverane Labs;
|
|
13
|
-
license;MIT;
|
|
14
|
-
tags;tdd;debugging;collaboration;planning;workflow;subagent;git;review;memory;semantic_search;
|
|
15
|
-
capabilities;brainstorm_design;write_implementation_plan;execute_plan_batch;test_driven_development;systematic_debugging;verification;code_review;git_worktree;subagent_driven;parallel_dispatch;retrieve_workflow_patterns;store_execution_history;semantic_memory;
|
|
16
|
-
parameters:
|
|
17
|
-
workflow_mode:
|
|
18
|
-
type;string;
|
|
19
|
-
required;false;
|
|
20
|
-
description;Mode: brainstorm, plan, execute, debug, review;
|
|
21
|
-
enum;brainstorm;plan;execute;debug;review;
|
|
22
|
-
dry_run:
|
|
23
|
-
type;boolean;
|
|
24
|
-
required;false;
|
|
25
|
-
description;Preview actions without executing;
|
|
26
|
-
memory_enabled:
|
|
27
|
-
type;boolean;
|
|
28
|
-
required;false;
|
|
29
|
-
default;true;
|
|
30
|
-
description;Enable storing and retrieving workflow execution patterns from Memory Mesh;
|
|
31
|
-
environment:
|
|
32
|
-
requires_filesystem;true;
|
|
33
|
-
requires_local_storage;true;
|
|
34
|
-
notes;Creates worktrees, writes plans, manages git workflows, and stores execution history in Memory Mesh via tools/memory_mesh.js;
|
|
35
|
-
dependencies:
|
|
36
|
-
required:
|
|
37
|
-
- Git >= 2.30.0
|
|
38
|
-
- Node >= 18.0.0 (for npm test commands)
|
|
39
|
-
- MemoryMesh >=1.0.0;
|
|
40
|
-
- tools/memory_mesh.js;
|
|
41
|
-
optional:
|
|
42
|
-
- YamoChainClient (for blockchain anchoring)
|
|
43
|
-
---
|
|
44
|
-
agent: MemorySystemInitializer;
|
|
45
|
-
intent: verify_memory_system_availability;
|
|
46
|
-
context:
|
|
47
|
-
memory_tool;tools/memory_mesh.js;
|
|
48
|
-
memory_enabled;provided_by_user.memory_enabled;
|
|
49
|
-
constraints:
|
|
50
|
-
- if_memory_enabled;verify_tool_exists;
|
|
51
|
-
- test_memory_connection_with_search;
|
|
52
|
-
- if_memory_unavailable;warn_user;continue_without_memory;
|
|
53
|
-
- set_memory_status_flag;
|
|
54
|
-
priority: high;
|
|
55
|
-
output: memory_status.json;
|
|
56
|
-
log: memory_initialized;available;timestamp;
|
|
57
|
-
meta:
|
|
58
|
-
hypothesis;Memory system availability check prevents runtime failures;
|
|
59
|
-
rationale;Graceful degradation if memory unavailable;
|
|
60
|
-
confidence;0.98;
|
|
61
|
-
handoff: WorkflowOrchestrator;
|
|
62
|
-
---
|
|
63
|
-
agent: WorkflowOrchestrator;
|
|
64
|
-
intent: determine_workflow_entry_point_with_historical_context;
|
|
65
|
-
context:
|
|
66
|
-
user_request;raw_input;
|
|
67
|
-
project_state;current_git_status;recent_commits;file_tree;
|
|
68
|
-
available_modes;brainstorm;plan;execute;debug;review;
|
|
69
|
-
memory_status;from_MemorySystemInitializer;
|
|
70
|
-
memory_tool;tools/memory_mesh.js;
|
|
71
|
-
memory_enabled;provided_by_user.memory_enabled;
|
|
72
|
-
constraints:
|
|
73
|
-
- if_memory_available;search_similar_workflows;
|
|
74
|
-
- extract_keywords_from_user_request;
|
|
75
|
-
- search_query_format;"workflow mode project outcome";
|
|
76
|
-
- retrieve_top_3_similar_patterns;
|
|
77
|
-
- analyze_past_outcomes_success_failure;
|
|
78
|
-
- present_similar_patterns_to_inform_decision;
|
|
79
|
-
- check_if_creative_work_requested;trigger_brainstorming_agent;
|
|
80
|
-
- check_if_spec_exists;trigger_planning_agent;
|
|
81
|
-
- check_if_plan_exists;trigger_execution_agent;
|
|
82
|
-
- check_if_bug_reported;trigger_debugging_agent;
|
|
83
|
-
- check_if_review_requested;trigger_review_agent;
|
|
84
|
-
- default_to_brainstorming_if_uncertain;
|
|
85
|
-
- announce_active_workflow_to_user;
|
|
86
|
-
priority: critical;
|
|
87
|
-
output: workflow_decision.json;
|
|
88
|
-
log: workflow_determined;timestamp;mode_selected;past_patterns_found;
|
|
89
|
-
meta:
|
|
90
|
-
hypothesis;Historical workflow patterns improve decision accuracy;
|
|
91
|
-
rationale;Similar past workflows provide context for current decision;
|
|
92
|
-
confidence;0.92;
|
|
93
|
-
observation;Past success patterns should bias toward proven approaches;
|
|
94
|
-
handoff: BrainstormingAgent;
|
|
95
|
-
---
|
|
96
|
-
agent: BrainstormingAgent;
|
|
97
|
-
intent: refine_ideas_through_socratic_dialogue;
|
|
98
|
-
context:
|
|
99
|
-
project_state;from_WorkflowOrchestrator;
|
|
100
|
-
workflow_decision;from_WorkflowOrchestrator;
|
|
101
|
-
user_idea;raw_request;
|
|
102
|
-
past_patterns;from_WorkflowOrchestrator.similar_workflows;
|
|
103
|
-
constraints:
|
|
104
|
-
- if_past_patterns_exist;reference_successful_approaches;
|
|
105
|
-
- check_project_context_first;files;docs;recent_commits;
|
|
106
|
-
- ask_questions_one_at_a_time;
|
|
107
|
-
- prefer_multiple_choice_when_possible;
|
|
108
|
-
- focus_understanding;purpose;constraints;success_criteria;
|
|
109
|
-
- propose_2_3_alternatives_with_tradeoffs;
|
|
110
|
-
- present_design_in_sections_200_300_words;
|
|
111
|
-
- validate_after_each_section;
|
|
112
|
-
- cover;architecture;components;data_flow;error_handling;testing;
|
|
113
|
-
- apply_yagni_ruthlessly;
|
|
114
|
-
priority: high;
|
|
115
|
-
output: validated_design.md;
|
|
116
|
-
log: design_validated;timestamp;sections_reviewed;alternatives_proposed;
|
|
117
|
-
meta:
|
|
118
|
-
hypothesis;Incremental validation produces better designs;
|
|
119
|
-
rationale;Large designs overwhelm;section-by-section enables feedback;
|
|
120
|
-
confidence;0.94;
|
|
121
|
-
handoff: DocumentationAgent;
|
|
122
|
-
---
|
|
123
|
-
agent: DocumentationAgent;
|
|
124
|
-
intent: persist_and_commit_design;
|
|
125
|
-
context:
|
|
126
|
-
design;from_BrainstormingAgent;
|
|
127
|
-
destination;docs/plans/YYYY-MM-DD-<topic>-design.md;
|
|
128
|
-
memory_tool;tools/memory_mesh.js;
|
|
129
|
-
memory_status;from_MemorySystemInitializer;
|
|
130
|
-
constraints:
|
|
131
|
-
- use_clear_concise_writing;
|
|
132
|
-
- commit_to_git_with_descriptive_message;
|
|
133
|
-
- tag_commit_with_design_reviewed;
|
|
134
|
-
- if_memory_available;store_design_summary;
|
|
135
|
-
- content_format;"Design phase: <topic>. Approach: <architecture>. Components: <list>. Status: validated.";
|
|
136
|
-
- metadata;{workflow:"yamo-super",phase:"design",project:"<name>",timestamp:"<iso>",commit_sha:"<sha>"};
|
|
137
|
-
- ask_ready_for_implementation;
|
|
138
|
-
priority: medium;
|
|
139
|
-
output: design_file_path;commit_sha;memory_id;
|
|
140
|
-
log: design_documented;timestamp;file_path;commit_sha;memory_stored;
|
|
141
|
-
meta:
|
|
142
|
-
hypothesis;Documented designs enable better implementation;
|
|
143
|
-
rationale;Written specs prevent drift during coding;
|
|
144
|
-
confidence;0.96;
|
|
145
|
-
handoff: WorktreeAgent;
|
|
146
|
-
---
|
|
147
|
-
agent: WorktreeAgent;
|
|
148
|
-
intent: create_isolated_development_workspace;
|
|
149
|
-
context:
|
|
150
|
-
design;from_DocumentationAgent;
|
|
151
|
-
base_branch;main_or_master;
|
|
152
|
-
constraints:
|
|
153
|
-
- create_git_worktree_at;.git/worktrees/<feature-name>;
|
|
154
|
-
- checkout_new_branch_feature/<name>;
|
|
155
|
-
- run_project_setup;npm_install;npm_run_build;
|
|
156
|
-
- verify_clean_test_baseline;npm_test;
|
|
157
|
-
- document_worktree_location;
|
|
158
|
-
priority: high;
|
|
159
|
-
output: worktree_path;branch_name;
|
|
160
|
-
log: workspace_created;timestamp;path;branch;baseline_tests;
|
|
161
|
-
meta:
|
|
162
|
-
hypothesis;Isolated worktrees prevent main branch pollution;
|
|
163
|
-
rationale;Clean branches enable easy rollback and parallel development;
|
|
164
|
-
confidence;0.99;
|
|
165
|
-
handoff: PlanningAgent;
|
|
166
|
-
---
|
|
167
|
-
agent: PlanningAgent;
|
|
168
|
-
intent: create_detailed_implementation_plan;
|
|
169
|
-
context:
|
|
170
|
-
design;from_DocumentationAgent;
|
|
171
|
-
worktree_path;from_WorktreeAgent;
|
|
172
|
-
past_patterns;from_WorkflowOrchestrator.similar_workflows;
|
|
173
|
-
assumptions;
|
|
174
|
-
engineer_has_zero_codebase_context;
|
|
175
|
-
engineer_has_questionable_taste;
|
|
176
|
-
engineer_needs_explicit_instructions;
|
|
177
|
-
constraints:
|
|
178
|
-
- if_similar_plans_exist;adapt_proven_task_breakdowns;
|
|
179
|
-
- break_into_bite_sized_tasks;2_5_minutes_each;
|
|
180
|
-
- each_task_one_action;write_test;run_test;implement;verify;commit;
|
|
181
|
-
- specify_exact_file_paths;
|
|
182
|
-
- include_complete_code_not_hints;
|
|
183
|
-
- include_exact_commands_with_expected_output;
|
|
184
|
-
- reference_relevant_skills_with_at_syntax;
|
|
185
|
-
- enforce_dry;yagni;tdd;frequent_commits;
|
|
186
|
-
- save_to;docs/plans/YYYY-MM-DD-<feature-name>.md;
|
|
187
|
-
- include_required_header;goal;architecture;tech_stack;
|
|
188
|
-
- include_sub_skill_directive;use_superpowers:executing_plans;
|
|
189
|
-
priority: critical;
|
|
190
|
-
output: implementation_plan.md;
|
|
191
|
-
log: plan_created;timestamp;task_count;file_path;
|
|
192
|
-
meta:
|
|
193
|
-
hypothesis;Explicit plans enable autonomous subagent execution;
|
|
194
|
-
rationale;Zero_context engineers need complete information;
|
|
195
|
-
confidence;0.97;
|
|
196
|
-
handoff: ExecutionSelector;
|
|
197
|
-
---
|
|
198
|
-
agent: ExecutionSelector;
|
|
199
|
-
intent: offer_execution_choice;
|
|
200
|
-
context:
|
|
201
|
-
plan;from_PlanningAgent;
|
|
202
|
-
worktree_path;from_WorktreeAgent;
|
|
203
|
-
constraints:
|
|
204
|
-
- present_two_options;subagent_driven;parallel_session;
|
|
205
|
-
- explain_subagent_driven;same_session;fresh_subagent_per_task;two_stage_review;
|
|
206
|
-
- explain_parallel_session;new_session;batch_execution;checkpoints;
|
|
207
|
-
- await_user_choice;
|
|
208
|
-
priority: high;
|
|
209
|
-
output: execution_mode;session_instructions;
|
|
210
|
-
log: execution_mode_selected;timestamp;mode;
|
|
211
|
-
meta:
|
|
212
|
-
hypothesis;Choice accommodates different working styles;
|
|
213
|
-
rationale;Some prefer continuity;others prefer isolation;
|
|
214
|
-
confidence;0.91;
|
|
215
|
-
handoff: SubagentDriver;
|
|
216
|
-
---
|
|
217
|
-
agent: SubagentDriver;
|
|
218
|
-
intent: execute_plan_via_fresh_subagents;
|
|
219
|
-
context:
|
|
220
|
-
plan;from_PlanningAgent;
|
|
221
|
-
worktree_path;from_WorktreeAgent;
|
|
222
|
-
constraints:
|
|
223
|
-
- read_plan_once;extract_all_tasks_with_full_text;
|
|
224
|
-
- create_todo_write_with_all_tasks;
|
|
225
|
-
- per_task;
|
|
226
|
-
- dispatch_implementer_subagent_with_full_context;
|
|
227
|
-
- allow_subagent_to_ask_questions_before_work;
|
|
228
|
-
- implementer_subagent_implements_tests_commits_self_reviews;
|
|
229
|
-
- dispatch_spec_compliance_reviewer_subagent;
|
|
230
|
-
- spec_reviewer_confirms_code_matches_spec;
|
|
231
|
-
- if_spec_issues;implementer_fixes;re_review_until_approved;
|
|
232
|
-
- dispatch_code_quality_reviewer_subagent;
|
|
233
|
-
- code_reviewer_approves_quality;
|
|
234
|
-
- if_quality_issues;implementer_fixes;re_review_until_approved;
|
|
235
|
-
- mark_task_complete_in_todo_write;
|
|
236
|
-
- after_all_tasks;dispatch_final_code_reviewer;
|
|
237
|
-
- use_finishing_development_branch_workflow;
|
|
238
|
-
- never_skip_reviews;
|
|
239
|
-
- never_parallel_dispatch_implementers;
|
|
240
|
-
- always_provide_full_text_not_file_references;
|
|
241
|
-
- ensure_scene_setting_context_per_task;
|
|
242
|
-
priority: critical;
|
|
243
|
-
output: implementation_complete;all_commits;test_results;
|
|
244
|
-
log: execution_complete;timestamp;tasks_completed;commits;tests_passed;
|
|
245
|
-
meta:
|
|
246
|
-
hypothesis;Fresh subagents per task prevent context pollution;
|
|
247
|
-
rationale;Two_stage_review ensures_spec_compliance_and_code_quality;
|
|
248
|
-
confidence;0.95;
|
|
249
|
-
handoff: BatchExecutor;
|
|
250
|
-
---
|
|
251
|
-
agent: BatchExecutor;
|
|
252
|
-
intent: execute_plan_in_batches_with_checkpoints;
|
|
253
|
-
context:
|
|
254
|
-
plan;from_PlanningAgent;
|
|
255
|
-
worktree_path;from_WorktreeAgent;
|
|
256
|
-
constraints:
|
|
257
|
-
- group_tasks_into_logical_batches;
|
|
258
|
-
- execute_batch_sequentially;
|
|
259
|
-
- after_each_batch;
|
|
260
|
-
- run_all_tests;verify_passing;
|
|
261
|
-
- request_human_checkpoint;
|
|
262
|
-
- await_approval_before_next_batch;
|
|
263
|
-
- commit_after_each_batch;
|
|
264
|
-
- report_progress_clearly;
|
|
265
|
-
priority: high;
|
|
266
|
-
output: batches_completed;checkpoint_status;
|
|
267
|
-
log: batch_execution_complete;timestamp;batches;checkpoints_passed;
|
|
268
|
-
meta:
|
|
269
|
-
hypothesis;Checkpoints maintain human oversight;
|
|
270
|
-
rationale;Batch execution balances autonomy_with_control;
|
|
271
|
-
confidence;0.93;
|
|
272
|
-
handoff: TDDAgent;
|
|
273
|
-
---
|
|
274
|
-
agent: TDDAgent;
|
|
275
|
-
intent: enforce_test_driven_development_cycle;
|
|
276
|
-
context:
|
|
277
|
-
task;from_SubagentDriver_or_BatchExecutor;
|
|
278
|
-
constraints:
|
|
279
|
-
- iron_law;no_production_code_without_failing_test_first;
|
|
280
|
-
- red;write_one_minimal_test;
|
|
281
|
-
- one_behavior_per_test;
|
|
282
|
-
- clear_name_describing_behavior;
|
|
283
|
-
- use_real_code_not_mocks;
|
|
284
|
-
- verify_red;run_test;confirm_fails_correctly;
|
|
285
|
-
- test_must_fail_not_error;
|
|
286
|
-
- failure_message_must_be_expected;
|
|
287
|
-
- fails_because_feature_missing_not_typo;
|
|
288
|
-
- green;write_minimal_code_to_pass;
|
|
289
|
-
- simplest_possible_implementation;
|
|
290
|
-
- no_features_beyond_test;
|
|
291
|
-
- no_refactoring_during_green;
|
|
292
|
-
- verify_green;run_test;confirm_passes;
|
|
293
|
-
- test_passes;
|
|
294
|
-
- other_tests_still_pass;
|
|
295
|
-
- output_pristine_no_errors;
|
|
296
|
-
- refactor;clean_up_only_after_green;
|
|
297
|
-
- remove_duplication;
|
|
298
|
-
- improve_names;
|
|
299
|
-
- extract_helpers;
|
|
300
|
-
- keep_tests_green;
|
|
301
|
-
- red_flags;code_before_test;test_passes_immediately;rationalizing_exceptions;
|
|
302
|
-
- penalty;delete_code_start_over;
|
|
303
|
-
priority: critical;
|
|
304
|
-
output: test_coverage;implementation;
|
|
305
|
-
log: tdd_cycle_complete;timestamp;test_name;status;
|
|
306
|
-
meta:
|
|
307
|
-
hypothesis;Watching_test_fail_proves_it_tests_something;
|
|
308
|
-
rationale;tests_after_answer_what_does_this_do;tests_first_answer_what_should_this_do;
|
|
309
|
-
confidence;0.99;
|
|
310
|
-
handoff: DebuggingAgent;
|
|
311
|
-
---
|
|
312
|
-
agent: DebuggingAgent;
|
|
313
|
-
intent: systematic_root_cause_analysis;
|
|
314
|
-
context:
|
|
315
|
-
bug_report;user_report_or_test_failure;
|
|
316
|
-
memory_tool;tools/memory_mesh.js;
|
|
317
|
-
memory_status;from_MemorySystemInitializer;
|
|
318
|
-
constraints:
|
|
319
|
-
- if_memory_available;search_similar_bugs;
|
|
320
|
-
- extract_error_signature;
|
|
321
|
-
- search_query_format;"debug error <signature> <component>";
|
|
322
|
-
- check_past_solutions;
|
|
323
|
-
- phase_1_define_problem;
|
|
324
|
-
- describe_symptoms_precisely;
|
|
325
|
-
- identify_affected_components;
|
|
326
|
-
- determine_frequency_always_sometimes_intermittent;
|
|
327
|
-
- phase_2_gather_evidence;
|
|
328
|
-
- reproduce_bug_reliably;
|
|
329
|
-
- collect_logs_stack_traces;
|
|
330
|
-
- identify_when_started_working;
|
|
331
|
-
- phase_3_isolate_cause;
|
|
332
|
-
- use_root_cause_tracing;
|
|
333
|
-
- use_defense_in_depth_analysis;
|
|
334
|
-
- use_condition_based_waiting_for_race_conditions;
|
|
335
|
-
- binary_search_git_history;
|
|
336
|
-
- minimize_reproduction_case;
|
|
337
|
-
- phase_4_verify_fix;
|
|
338
|
-
- write_failing_test_reproducing_bug;
|
|
339
|
-
- apply_tdd_cycle_to_fix;
|
|
340
|
-
- use_verification_before_completion;
|
|
341
|
-
- if_memory_available;store_bug_resolution;
|
|
342
|
-
- content_format;"Debug: <error_signature>. Root cause: <cause>. Solution: <fix>. Component: <component>.";
|
|
343
|
-
- metadata;{workflow:"yamo-super",phase:"debug",bug_type:"<type>",resolution:"<fix>",timestamp:"<iso>"};
|
|
344
|
-
- never_fix_without_test;
|
|
345
|
-
- never_apply_bandages;
|
|
346
|
-
priority: high;
|
|
347
|
-
output: root_cause;fix_verification_test;memory_id;
|
|
348
|
-
log: bug_resolved;timestamp;root_cause;test_added;similar_bugs_found;
|
|
349
|
-
meta:
|
|
350
|
-
hypothesis;Systematic_debugging_faster_than_shotgun_debugging;
|
|
351
|
-
rationale;root_cause_elimination_prevents_reoccurrence;
|
|
352
|
-
confidence;0.96;
|
|
353
|
-
observation;Historical bug patterns accelerate diagnosis;
|
|
354
|
-
handoff: VerificationAgent;
|
|
355
|
-
---
|
|
356
|
-
agent: VerificationAgent;
|
|
357
|
-
intent: ensure_fix_actually_works;
|
|
358
|
-
context:
|
|
359
|
-
proposed_fix;from_DebuggingAgent;
|
|
360
|
-
original_bug;from_DebuggingAgent;
|
|
361
|
-
constraints:
|
|
362
|
-
- reproduce_original_bug_first;confirm_exists;
|
|
363
|
-
- apply_fix;
|
|
364
|
-
- verify_bug_gone;
|
|
365
|
-
- verify_no_regressions;
|
|
366
|
-
- verify_edge_cases;
|
|
367
|
-
- run_full_test_suite;
|
|
368
|
-
- check_output_pristine;
|
|
369
|
-
- if_not_fixed;restart_debugging;
|
|
370
|
-
priority: high;
|
|
371
|
-
output: verification_status;regression_check;
|
|
372
|
-
log: verification_complete;timestamp;status;regressions;
|
|
373
|
-
meta:
|
|
374
|
-
hypothesis;Verification_catches_incomplete_fixes;
|
|
375
|
-
rationale;feeling_fixed_does_not_mean_fixed;
|
|
376
|
-
confidence;0.98;
|
|
377
|
-
handoff: CodeReviewAgent;
|
|
378
|
-
---
|
|
379
|
-
agent: CodeReviewAgent;
|
|
380
|
-
intent: conduct_pre_merge_quality_gate;
|
|
381
|
-
context:
|
|
382
|
-
implementation;from_SubagentDriver_or_BatchExecutor;
|
|
383
|
-
plan;from_PlanningAgent;
|
|
384
|
-
memory_tool;tools/memory_mesh.js;
|
|
385
|
-
memory_status;from_MemorySystemInitializer;
|
|
386
|
-
constraints:
|
|
387
|
-
- review_against_plan;
|
|
388
|
-
- all_requirements_implemented;
|
|
389
|
-
- no_extra_features_beyond_spec;
|
|
390
|
-
- file_matches_match_plan;
|
|
391
|
-
- code_quality_check;
|
|
392
|
-
- tests_cover_all_cases;
|
|
393
|
-
- tests_use_real_code_not_mocks;
|
|
394
|
-
- code_is_clean_not_clever;
|
|
395
|
-
- names_are_clear;
|
|
396
|
-
- no_duplication;
|
|
397
|
-
- proper_error_handling;
|
|
398
|
-
- report_by_severity;
|
|
399
|
-
- critical;blocks_progress;must_fix;
|
|
400
|
-
- important;should_fix_before_merge;
|
|
401
|
-
- minor;nice_to_have;
|
|
402
|
-
- if_critical_issues;block_progress;
|
|
403
|
-
- if_no_issues;approve;
|
|
404
|
-
- if_memory_available;store_review_outcome;
|
|
405
|
-
- content_format;"Code review: <feature>. Quality: <rating>. Issues: <count>. Tests: <coverage>. Outcome: <approved/rejected>.";
|
|
406
|
-
- metadata;{workflow:"yamo-super",phase:"review",quality_rating:"<rating>",issues_count:"<n>",timestamp:"<iso>"};
|
|
407
|
-
priority: critical;
|
|
408
|
-
output: review_report;approval_status;memory_id;
|
|
409
|
-
log: review_complete;timestamp;critical;important;minor;status;
|
|
410
|
-
meta:
|
|
411
|
-
hypothesis;Pre_merge_review_catches_issues_early;
|
|
412
|
-
rationale;merge_reviews_are_too_late_for_easy_fixes;
|
|
413
|
-
confidence;0.97;
|
|
414
|
-
handoff: BranchFinisher;
|
|
415
|
-
---
|
|
416
|
-
agent: BranchFinisher;
|
|
417
|
-
intent: complete_development_branch_workflow;
|
|
418
|
-
context:
|
|
419
|
-
implementation;from_CodeReviewAgent;
|
|
420
|
-
worktree_path;from_WorktreeAgent;
|
|
421
|
-
review_report;from_CodeReviewAgent;
|
|
422
|
-
constraints:
|
|
423
|
-
- verify_all_tests_pass;
|
|
424
|
-
- verify_no_regressions;
|
|
425
|
-
- present_options;
|
|
426
|
-
- merge_to_main;
|
|
427
|
-
- create_pull_request;
|
|
428
|
-
- keep_branch_for_more_work;
|
|
429
|
-
- discard_branch;
|
|
430
|
-
- if_merge;merge_fast_forward_or_squash;delete_worktree;
|
|
431
|
-
- if_pull_request;create_pr_with_description;link_to_plan;
|
|
432
|
-
- if_discard;delete_branch;remove_worktree;
|
|
433
|
-
- document_decision;
|
|
434
|
-
priority: high;
|
|
435
|
-
output: merge_status;pr_url_or_branch_deleted;
|
|
436
|
-
log: branch_completed;timestamp;outcome;
|
|
437
|
-
meta:
|
|
438
|
-
hypothesis;Explicit_branch_completion_prevents_orphan_branches;
|
|
439
|
-
rationale;clear_decisions_prevent_branch_accumulation;
|
|
440
|
-
confidence;0.95;
|
|
441
|
-
handoff: WorkflowMemoryStore;
|
|
442
|
-
---
|
|
443
|
-
agent: ParallelDispatcher;
|
|
444
|
-
intent: coordinate_concurrent_subagent_workflows;
|
|
445
|
-
context:
|
|
446
|
-
independent_tasks;task_list;
|
|
447
|
-
constraints:
|
|
448
|
-
- identify_truly_independent_tasks;
|
|
449
|
-
- dispatch_subagents_in_parallel;
|
|
450
|
-
- wait_for_all_subagents;
|
|
451
|
-
- collect_results;
|
|
452
|
-
- detect_conflicts;
|
|
453
|
-
- if_conflicts;resolve_sequentially;
|
|
454
|
-
- merge_results;
|
|
455
|
-
priority: medium;
|
|
456
|
-
output: parallel_results;conflict_resolution_log;
|
|
457
|
-
log: parallel_dispatch_complete;timestamp;tasks;conflicts;
|
|
458
|
-
meta:
|
|
459
|
-
hypothesis;Parallel_execution_saves_wall_clock_time;
|
|
460
|
-
rationale;independent_tasks_have_no_dependencies;
|
|
461
|
-
confidence;0.89;
|
|
462
|
-
handoff: SkillMetaAgent;
|
|
463
|
-
---
|
|
464
|
-
agent: SkillMetaAgent;
|
|
465
|
-
intent: enable_skill_creation_and_extension;
|
|
466
|
-
context:
|
|
467
|
-
new_skill_idea;user_request;
|
|
468
|
-
constraints:
|
|
469
|
-
- use_writing_skills_skill;
|
|
470
|
-
- follow_skill_structure;
|
|
471
|
-
- metadata_block;
|
|
472
|
-
- agent_definitions;
|
|
473
|
-
- constraints_as_semicolon_key_values;
|
|
474
|
-
- triple_dash_delimiters;
|
|
475
|
-
- explicit_handoff_chains;
|
|
476
|
-
- ensure_v1_compliance;
|
|
477
|
-
- scaffold_tests;
|
|
478
|
-
- validate_syntax;
|
|
479
|
-
- classify_category;
|
|
480
|
-
priority: low;
|
|
481
|
-
output: new_skill_yamo;test_plan;
|
|
482
|
-
log: skill_created;timestamp;name;category;
|
|
483
|
-
meta:
|
|
484
|
-
hypothesis;Meta_skills_enable_ecosystem_growth;
|
|
485
|
-
rationale;extensible_systems_adapt_to_new_needs;
|
|
486
|
-
confidence;0.88;
|
|
487
|
-
handoff: End;
|
|
488
|
-
---
|
|
489
|
-
agent: UsageGuide;
|
|
490
|
-
intent: introduce_superpowers_workflow;
|
|
491
|
-
context:
|
|
492
|
-
user;new_to_superpowers;
|
|
493
|
-
constraints:
|
|
494
|
-
- explain_basic_workflow;
|
|
495
|
-
- brainstorming;design_refinement;
|
|
496
|
-
- using_git_worktrees;isolated_workspace;
|
|
497
|
-
- writing_plans;implementation_breakdown;
|
|
498
|
-
- subagent_driven_or_executing_plans;task_execution;
|
|
499
|
-
- test_driven_development;red_green_refactor;
|
|
500
|
-
- systematic_debugging;root_cause_analysis;
|
|
501
|
-
- requesting_code_review;quality_gate;
|
|
502
|
-
- finishing_development_branch;merge_pr_discard;
|
|
503
|
-
- memory_integration;pattern_recognition;
|
|
504
|
-
- explain_skills_trigger_automatically;
|
|
505
|
-
- explain_mandatory_not_suggestions;
|
|
506
|
-
- demonstrate_with_example;
|
|
507
|
-
priority: low;
|
|
508
|
-
output: user_understanding;workflow_ready;
|
|
509
|
-
log: onboarded;timestamp;user;
|
|
510
|
-
meta:
|
|
511
|
-
hypothesis;clear_introduction_enables_effective_use;
|
|
512
|
-
rationale;understanding_why_builds_compliance;
|
|
513
|
-
confidence;0.92;
|
|
514
|
-
handoff: WorkflowMemoryStore;
|
|
515
|
-
---
|
|
516
|
-
agent: WorkflowMemoryStore;
|
|
517
|
-
intent: store_complete_workflow_execution_for_pattern_recognition;
|
|
518
|
-
context:
|
|
519
|
-
workflow_decision;from_WorkflowOrchestrator;
|
|
520
|
-
design_output;from_DocumentationAgent;
|
|
521
|
-
implementation_result;from_SubagentDriver_or_BatchExecutor;
|
|
522
|
-
review_result;from_CodeReviewAgent;
|
|
523
|
-
branch_outcome;from_BranchFinisher;
|
|
524
|
-
memory_tool;tools/memory_mesh.js;
|
|
525
|
-
memory_status;from_MemorySystemInitializer;
|
|
526
|
-
constraints:
|
|
527
|
-
- if_memory_available;store_complete_workflow;
|
|
528
|
-
- aggregate_all_phase_data;
|
|
529
|
-
- content_format;"Workflow: yamo-super. Mode: <mode>. Project: <project>. Design: <summary>. Implementation: <tasks_completed>. Review: <quality>. Tests: <passed/failed>. Outcome: <success/failure>. Duration: <time>.";
|
|
530
|
-
- metadata;{
|
|
531
|
-
workflow:"yamo-super",
|
|
532
|
-
mode:"<selected_mode>",
|
|
533
|
-
project:"<project_name>",
|
|
534
|
-
phase:"complete",
|
|
535
|
-
design_commit:"<sha>",
|
|
536
|
-
implementation_commits:"<count>",
|
|
537
|
-
tests_passed:"<true/false>",
|
|
538
|
-
review_approved:"<true/false>",
|
|
539
|
-
outcome:"<success/failure>",
|
|
540
|
-
duration_minutes:"<n>",
|
|
541
|
-
timestamp:"<iso>"
|
|
542
|
-
};
|
|
543
|
-
- generate_workflow_embedding;
|
|
544
|
-
- tag_by_mode_project_type_and_outcome;
|
|
545
|
-
- enable_future_recommendations;
|
|
546
|
-
- if_blockchain_available;anchor_to_yamo_chain;
|
|
547
|
-
priority: high;
|
|
548
|
-
output: workflow_memory_receipt.json;
|
|
549
|
-
log: workflow_stored;memory_id;outcome;timestamp;
|
|
550
|
-
meta:
|
|
551
|
-
hypothesis;Storing complete workflows enables pattern recognition for future recommendations;
|
|
552
|
-
rationale;Historical success patterns guide future workflow decisions;
|
|
553
|
-
confidence;0.94;
|
|
554
|
-
observation;Semantic search finds similar contexts not just keyword matches;
|
|
555
|
-
handoff: End;
|
|
1
|
+
---
|
|
2
|
+
name: yamo-super
|
|
3
|
+
description: For all code improvement or creation tasks, strictly adhere to the logic, agents, and constraints defined in ~/.claude/skills/yamo-super/skill-super.yamo or ~/.gemini/skills/yamo-super/skill-super.yamo.
|
|
4
|
+
---
|
|
@@ -0,0 +1,548 @@
|
|
|
1
|
+
metadata:
|
|
2
|
+
name;YamoSuper;
|
|
3
|
+
version;2.1.2;
|
|
4
|
+
description;Comprehensive AI coding workflow system with automatic memory integration for pattern recognition and workflow optimization;
|
|
5
|
+
author;Derived from Superpowers by Jesse Scott;adapted for YAMO by Soverane Labs;
|
|
6
|
+
license;MIT;
|
|
7
|
+
tags;tdd;debugging;collaboration;planning;workflow;subagent;git;review;memory;semantic_search;
|
|
8
|
+
capabilities;brainstorm_design;write_implementation_plan;execute_plan_batch;test_driven_development;systematic_debugging;verification;code_review;git_worktree;subagent_driven;parallel_dispatch;retrieve_workflow_patterns;store_execution_history;semantic_memory;
|
|
9
|
+
parameters:
|
|
10
|
+
workflow_mode:
|
|
11
|
+
type;string;
|
|
12
|
+
required;false;
|
|
13
|
+
description;Mode: brainstorm, plan, execute, debug, review;
|
|
14
|
+
enum;brainstorm;plan;execute;debug;review;
|
|
15
|
+
dry_run:
|
|
16
|
+
type;boolean;
|
|
17
|
+
required;false;
|
|
18
|
+
description;Preview actions without executing;
|
|
19
|
+
memory_enabled:
|
|
20
|
+
type;boolean;
|
|
21
|
+
required;false;
|
|
22
|
+
default;true;
|
|
23
|
+
description;Enable storing and retrieving workflow execution patterns from Memory Mesh;
|
|
24
|
+
environment:
|
|
25
|
+
requires_filesystem;true;
|
|
26
|
+
requires_local_storage;true;
|
|
27
|
+
notes;Creates worktrees, writes plans, manages git workflows, and stores execution history in Memory Mesh via tools/memory_mesh.js;
|
|
28
|
+
dependencies:
|
|
29
|
+
required:
|
|
30
|
+
- Git >= 2.30.0
|
|
31
|
+
- Node >= 18.0.0 (for npm test commands)
|
|
32
|
+
- MemoryMesh >=1.0.0;
|
|
33
|
+
- tools/memory_mesh.js;
|
|
34
|
+
optional:
|
|
35
|
+
- YamoChainClient (for blockchain anchoring)
|
|
36
|
+
---
|
|
37
|
+
agent: MemorySystemInitializer;
|
|
38
|
+
intent: verify_memory_system_availability;
|
|
39
|
+
context:
|
|
40
|
+
memory_tool;tools/memory_mesh.js;
|
|
41
|
+
memory_enabled;provided_by_user.memory_enabled;
|
|
42
|
+
constraints:
|
|
43
|
+
- if_memory_enabled;verify_tool_exists;
|
|
44
|
+
- test_memory_connection_with_search;
|
|
45
|
+
- if_memory_unavailable;warn_user;continue_without_memory;
|
|
46
|
+
- set_memory_status_flag;
|
|
47
|
+
priority: high;
|
|
48
|
+
output: memory_status.json;
|
|
49
|
+
log: memory_initialized;available;timestamp;
|
|
50
|
+
meta:
|
|
51
|
+
hypothesis;Memory system availability check prevents runtime failures;
|
|
52
|
+
rationale;Graceful degradation if memory unavailable;
|
|
53
|
+
confidence;0.98;
|
|
54
|
+
handoff: WorkflowOrchestrator;
|
|
55
|
+
---
|
|
56
|
+
agent: WorkflowOrchestrator;
|
|
57
|
+
intent: determine_workflow_entry_point_with_historical_context;
|
|
58
|
+
context:
|
|
59
|
+
user_request;raw_input;
|
|
60
|
+
project_state;current_git_status;recent_commits;file_tree;
|
|
61
|
+
available_modes;brainstorm;plan;execute;debug;review;
|
|
62
|
+
memory_status;from_MemorySystemInitializer;
|
|
63
|
+
memory_tool;tools/memory_mesh.js;
|
|
64
|
+
memory_enabled;provided_by_user.memory_enabled;
|
|
65
|
+
constraints:
|
|
66
|
+
- if_memory_available;search_similar_workflows;
|
|
67
|
+
- extract_keywords_from_user_request;
|
|
68
|
+
- search_query_format;"workflow mode project outcome";
|
|
69
|
+
- retrieve_top_3_similar_patterns;
|
|
70
|
+
- analyze_past_outcomes_success_failure;
|
|
71
|
+
- present_similar_patterns_to_inform_decision;
|
|
72
|
+
- check_if_creative_work_requested;trigger_brainstorming_agent;
|
|
73
|
+
- check_if_spec_exists;trigger_planning_agent;
|
|
74
|
+
- check_if_plan_exists;trigger_execution_agent;
|
|
75
|
+
- check_if_bug_reported;trigger_debugging_agent;
|
|
76
|
+
- check_if_review_requested;trigger_review_agent;
|
|
77
|
+
- default_to_brainstorming_if_uncertain;
|
|
78
|
+
- announce_active_workflow_to_user;
|
|
79
|
+
priority: critical;
|
|
80
|
+
output: workflow_decision.json;
|
|
81
|
+
log: workflow_determined;timestamp;mode_selected;past_patterns_found;
|
|
82
|
+
meta:
|
|
83
|
+
hypothesis;Historical workflow patterns improve decision accuracy;
|
|
84
|
+
rationale;Similar past workflows provide context for current decision;
|
|
85
|
+
confidence;0.92;
|
|
86
|
+
observation;Past success patterns should bias toward proven approaches;
|
|
87
|
+
handoff: BrainstormingAgent;
|
|
88
|
+
---
|
|
89
|
+
agent: BrainstormingAgent;
|
|
90
|
+
intent: refine_ideas_through_socratic_dialogue;
|
|
91
|
+
context:
|
|
92
|
+
project_state;from_WorkflowOrchestrator;
|
|
93
|
+
workflow_decision;from_WorkflowOrchestrator;
|
|
94
|
+
user_idea;raw_request;
|
|
95
|
+
past_patterns;from_WorkflowOrchestrator.similar_workflows;
|
|
96
|
+
constraints:
|
|
97
|
+
- if_past_patterns_exist;reference_successful_approaches;
|
|
98
|
+
- check_project_context_first;files;docs;recent_commits;
|
|
99
|
+
- ask_questions_one_at_a_time;
|
|
100
|
+
- prefer_multiple_choice_when_possible;
|
|
101
|
+
- focus_understanding;purpose;constraints;success_criteria;
|
|
102
|
+
- propose_2_3_alternatives_with_tradeoffs;
|
|
103
|
+
- present_design_in_sections_200_300_words;
|
|
104
|
+
- validate_after_each_section;
|
|
105
|
+
- cover;architecture;components;data_flow;error_handling;testing;
|
|
106
|
+
- apply_yagni_ruthlessly;
|
|
107
|
+
priority: high;
|
|
108
|
+
output: validated_design.md;
|
|
109
|
+
log: design_validated;timestamp;sections_reviewed;alternatives_proposed;
|
|
110
|
+
meta:
|
|
111
|
+
hypothesis;Incremental validation produces better designs;
|
|
112
|
+
rationale;Large designs overwhelm;section-by-section enables feedback;
|
|
113
|
+
confidence;0.94;
|
|
114
|
+
handoff: DocumentationAgent;
|
|
115
|
+
---
|
|
116
|
+
agent: DocumentationAgent;
|
|
117
|
+
intent: persist_and_commit_design;
|
|
118
|
+
context:
|
|
119
|
+
design;from_BrainstormingAgent;
|
|
120
|
+
destination;docs/plans/YYYY-MM-DD-<topic>-design.md;
|
|
121
|
+
memory_tool;tools/memory_mesh.js;
|
|
122
|
+
memory_status;from_MemorySystemInitializer;
|
|
123
|
+
constraints:
|
|
124
|
+
- use_clear_concise_writing;
|
|
125
|
+
- commit_to_git_with_descriptive_message;
|
|
126
|
+
- tag_commit_with_design_reviewed;
|
|
127
|
+
- if_memory_available;store_design_summary;
|
|
128
|
+
- content_format;"Design phase: <topic>. Approach: <architecture>. Components: <list>. Status: validated.";
|
|
129
|
+
- metadata;{workflow:"yamo-super",phase:"design",project:"<name>",timestamp:"<iso>",commit_sha:"<sha>"};
|
|
130
|
+
- ask_ready_for_implementation;
|
|
131
|
+
priority: medium;
|
|
132
|
+
output: design_file_path;commit_sha;memory_id;
|
|
133
|
+
log: design_documented;timestamp;file_path;commit_sha;memory_stored;
|
|
134
|
+
meta:
|
|
135
|
+
hypothesis;Documented designs enable better implementation;
|
|
136
|
+
rationale;Written specs prevent drift during coding;
|
|
137
|
+
confidence;0.96;
|
|
138
|
+
handoff: WorktreeAgent;
|
|
139
|
+
---
|
|
140
|
+
agent: WorktreeAgent;
|
|
141
|
+
intent: create_isolated_development_workspace;
|
|
142
|
+
context:
|
|
143
|
+
design;from_DocumentationAgent;
|
|
144
|
+
base_branch;main_or_master;
|
|
145
|
+
constraints:
|
|
146
|
+
- create_git_worktree_at;.git/worktrees/<feature-name>;
|
|
147
|
+
- checkout_new_branch_feature/<name>;
|
|
148
|
+
- run_project_setup;npm_install;npm_run_build;
|
|
149
|
+
- verify_clean_test_baseline;npm_test;
|
|
150
|
+
- document_worktree_location;
|
|
151
|
+
priority: high;
|
|
152
|
+
output: worktree_path;branch_name;
|
|
153
|
+
log: workspace_created;timestamp;path;branch;baseline_tests;
|
|
154
|
+
meta:
|
|
155
|
+
hypothesis;Isolated worktrees prevent main branch pollution;
|
|
156
|
+
rationale;Clean branches enable easy rollback and parallel development;
|
|
157
|
+
confidence;0.99;
|
|
158
|
+
handoff: PlanningAgent;
|
|
159
|
+
---
|
|
160
|
+
agent: PlanningAgent;
|
|
161
|
+
intent: create_detailed_implementation_plan;
|
|
162
|
+
context:
|
|
163
|
+
design;from_DocumentationAgent;
|
|
164
|
+
worktree_path;from_WorktreeAgent;
|
|
165
|
+
past_patterns;from_WorkflowOrchestrator.similar_workflows;
|
|
166
|
+
assumptions;
|
|
167
|
+
engineer_has_zero_codebase_context;
|
|
168
|
+
engineer_has_questionable_taste;
|
|
169
|
+
engineer_needs_explicit_instructions;
|
|
170
|
+
constraints:
|
|
171
|
+
- if_similar_plans_exist;adapt_proven_task_breakdowns;
|
|
172
|
+
- break_into_bite_sized_tasks;2_5_minutes_each;
|
|
173
|
+
- each_task_one_action;write_test;run_test;implement;verify;commit;
|
|
174
|
+
- specify_exact_file_paths;
|
|
175
|
+
- include_complete_code_not_hints;
|
|
176
|
+
- include_exact_commands_with_expected_output;
|
|
177
|
+
- reference_relevant_skills_with_at_syntax;
|
|
178
|
+
- enforce_dry;yagni;tdd;frequent_commits;
|
|
179
|
+
- save_to;docs/plans/YYYY-MM-DD-<feature-name>.md;
|
|
180
|
+
- include_required_header;goal;architecture;tech_stack;
|
|
181
|
+
- include_sub_skill_directive;use_superpowers:executing_plans;
|
|
182
|
+
priority: critical;
|
|
183
|
+
output: implementation_plan.md;
|
|
184
|
+
log: plan_created;timestamp;task_count;file_path;
|
|
185
|
+
meta:
|
|
186
|
+
hypothesis;Explicit plans enable autonomous subagent execution;
|
|
187
|
+
rationale;Zero_context engineers need complete information;
|
|
188
|
+
confidence;0.97;
|
|
189
|
+
handoff: ExecutionSelector;
|
|
190
|
+
---
|
|
191
|
+
agent: ExecutionSelector;
|
|
192
|
+
intent: offer_execution_choice;
|
|
193
|
+
context:
|
|
194
|
+
plan;from_PlanningAgent;
|
|
195
|
+
worktree_path;from_WorktreeAgent;
|
|
196
|
+
constraints:
|
|
197
|
+
- present_two_options;subagent_driven;parallel_session;
|
|
198
|
+
- explain_subagent_driven;same_session;fresh_subagent_per_task;two_stage_review;
|
|
199
|
+
- explain_parallel_session;new_session;batch_execution;checkpoints;
|
|
200
|
+
- await_user_choice;
|
|
201
|
+
priority: high;
|
|
202
|
+
output: execution_mode;session_instructions;
|
|
203
|
+
log: execution_mode_selected;timestamp;mode;
|
|
204
|
+
meta:
|
|
205
|
+
hypothesis;Choice accommodates different working styles;
|
|
206
|
+
rationale;Some prefer continuity;others prefer isolation;
|
|
207
|
+
confidence;0.91;
|
|
208
|
+
handoff: SubagentDriver;
|
|
209
|
+
---
|
|
210
|
+
agent: SubagentDriver;
|
|
211
|
+
intent: execute_plan_via_fresh_subagents;
|
|
212
|
+
context:
|
|
213
|
+
plan;from_PlanningAgent;
|
|
214
|
+
worktree_path;from_WorktreeAgent;
|
|
215
|
+
constraints:
|
|
216
|
+
- read_plan_once;extract_all_tasks_with_full_text;
|
|
217
|
+
- create_todo_write_with_all_tasks;
|
|
218
|
+
- per_task;
|
|
219
|
+
- dispatch_implementer_subagent_with_full_context;
|
|
220
|
+
- allow_subagent_to_ask_questions_before_work;
|
|
221
|
+
- implementer_subagent_implements_tests_commits_self_reviews;
|
|
222
|
+
- dispatch_spec_compliance_reviewer_subagent;
|
|
223
|
+
- spec_reviewer_confirms_code_matches_spec;
|
|
224
|
+
- if_spec_issues;implementer_fixes;re_review_until_approved;
|
|
225
|
+
- dispatch_code_quality_reviewer_subagent;
|
|
226
|
+
- code_reviewer_approves_quality;
|
|
227
|
+
- if_quality_issues;implementer_fixes;re_review_until_approved;
|
|
228
|
+
- mark_task_complete_in_todo_write;
|
|
229
|
+
- after_all_tasks;dispatch_final_code_reviewer;
|
|
230
|
+
- use_finishing_development_branch_workflow;
|
|
231
|
+
- never_skip_reviews;
|
|
232
|
+
- never_parallel_dispatch_implementers;
|
|
233
|
+
- always_provide_full_text_not_file_references;
|
|
234
|
+
- ensure_scene_setting_context_per_task;
|
|
235
|
+
priority: critical;
|
|
236
|
+
output: implementation_complete;all_commits;test_results;
|
|
237
|
+
log: execution_complete;timestamp;tasks_completed;commits;tests_passed;
|
|
238
|
+
meta:
|
|
239
|
+
hypothesis;Fresh subagents per task prevent context pollution;
|
|
240
|
+
rationale;Two_stage_review ensures_spec_compliance_and_code_quality;
|
|
241
|
+
confidence;0.95;
|
|
242
|
+
handoff: BatchExecutor;
|
|
243
|
+
---
|
|
244
|
+
agent: BatchExecutor;
|
|
245
|
+
intent: execute_plan_in_batches_with_checkpoints;
|
|
246
|
+
context:
|
|
247
|
+
plan;from_PlanningAgent;
|
|
248
|
+
worktree_path;from_WorktreeAgent;
|
|
249
|
+
constraints:
|
|
250
|
+
- group_tasks_into_logical_batches;
|
|
251
|
+
- execute_batch_sequentially;
|
|
252
|
+
- after_each_batch;
|
|
253
|
+
- run_all_tests;verify_passing;
|
|
254
|
+
- request_human_checkpoint;
|
|
255
|
+
- await_approval_before_next_batch;
|
|
256
|
+
- commit_after_each_batch;
|
|
257
|
+
- report_progress_clearly;
|
|
258
|
+
priority: high;
|
|
259
|
+
output: batches_completed;checkpoint_status;
|
|
260
|
+
log: batch_execution_complete;timestamp;batches;checkpoints_passed;
|
|
261
|
+
meta:
|
|
262
|
+
hypothesis;Checkpoints maintain human oversight;
|
|
263
|
+
rationale;Batch execution balances autonomy_with_control;
|
|
264
|
+
confidence;0.93;
|
|
265
|
+
handoff: TDDAgent;
|
|
266
|
+
---
|
|
267
|
+
agent: TDDAgent;
|
|
268
|
+
intent: enforce_test_driven_development_cycle;
|
|
269
|
+
context:
|
|
270
|
+
task;from_SubagentDriver_or_BatchExecutor;
|
|
271
|
+
constraints:
|
|
272
|
+
- iron_law;no_production_code_without_failing_test_first;
|
|
273
|
+
- red;write_one_minimal_test;
|
|
274
|
+
- one_behavior_per_test;
|
|
275
|
+
- clear_name_describing_behavior;
|
|
276
|
+
- use_real_code_not_mocks;
|
|
277
|
+
- verify_red;run_test;confirm_fails_correctly;
|
|
278
|
+
- test_must_fail_not_error;
|
|
279
|
+
- failure_message_must_be_expected;
|
|
280
|
+
- fails_because_feature_missing_not_typo;
|
|
281
|
+
- green;write_minimal_code_to_pass;
|
|
282
|
+
- simplest_possible_implementation;
|
|
283
|
+
- no_features_beyond_test;
|
|
284
|
+
- no_refactoring_during_green;
|
|
285
|
+
- verify_green;run_test;confirm_passes;
|
|
286
|
+
- test_passes;
|
|
287
|
+
- other_tests_still_pass;
|
|
288
|
+
- output_pristine_no_errors;
|
|
289
|
+
- refactor;clean_up_only_after_green;
|
|
290
|
+
- remove_duplication;
|
|
291
|
+
- improve_names;
|
|
292
|
+
- extract_helpers;
|
|
293
|
+
- keep_tests_green;
|
|
294
|
+
- red_flags;code_before_test;test_passes_immediately;rationalizing_exceptions;
|
|
295
|
+
- penalty;delete_code_start_over;
|
|
296
|
+
priority: critical;
|
|
297
|
+
output: test_coverage;implementation;
|
|
298
|
+
log: tdd_cycle_complete;timestamp;test_name;status;
|
|
299
|
+
meta:
|
|
300
|
+
hypothesis;Watching_test_fail_proves_it_tests_something;
|
|
301
|
+
rationale;tests_after_answer_what_does_this_do;tests_first_answer_what_should_this_do;
|
|
302
|
+
confidence;0.99;
|
|
303
|
+
handoff: DebuggingAgent;
|
|
304
|
+
---
|
|
305
|
+
agent: DebuggingAgent;
|
|
306
|
+
intent: systematic_root_cause_analysis;
|
|
307
|
+
context:
|
|
308
|
+
bug_report;user_report_or_test_failure;
|
|
309
|
+
memory_tool;tools/memory_mesh.js;
|
|
310
|
+
memory_status;from_MemorySystemInitializer;
|
|
311
|
+
constraints:
|
|
312
|
+
- if_memory_available;search_similar_bugs;
|
|
313
|
+
- extract_error_signature;
|
|
314
|
+
- search_query_format;"debug error <signature> <component>";
|
|
315
|
+
- check_past_solutions;
|
|
316
|
+
- phase_1_define_problem;
|
|
317
|
+
- describe_symptoms_precisely;
|
|
318
|
+
- identify_affected_components;
|
|
319
|
+
- determine_frequency_always_sometimes_intermittent;
|
|
320
|
+
- phase_2_gather_evidence;
|
|
321
|
+
- reproduce_bug_reliably;
|
|
322
|
+
- collect_logs_stack_traces;
|
|
323
|
+
- identify_when_started_working;
|
|
324
|
+
- phase_3_isolate_cause;
|
|
325
|
+
- use_root_cause_tracing;
|
|
326
|
+
- use_defense_in_depth_analysis;
|
|
327
|
+
- use_condition_based_waiting_for_race_conditions;
|
|
328
|
+
- binary_search_git_history;
|
|
329
|
+
- minimize_reproduction_case;
|
|
330
|
+
- phase_4_verify_fix;
|
|
331
|
+
- write_failing_test_reproducing_bug;
|
|
332
|
+
- apply_tdd_cycle_to_fix;
|
|
333
|
+
- use_verification_before_completion;
|
|
334
|
+
- if_memory_available;store_bug_resolution;
|
|
335
|
+
- content_format;"Debug: <error_signature>. Root cause: <cause>. Solution: <fix>. Component: <component>.";
|
|
336
|
+
- metadata;{workflow:"yamo-super",phase:"debug",bug_type:"<type>",resolution:"<fix>",timestamp:"<iso>"};
|
|
337
|
+
- never_fix_without_test;
|
|
338
|
+
- never_apply_bandages;
|
|
339
|
+
priority: high;
|
|
340
|
+
output: root_cause;fix_verification_test;memory_id;
|
|
341
|
+
log: bug_resolved;timestamp;root_cause;test_added;similar_bugs_found;
|
|
342
|
+
meta:
|
|
343
|
+
hypothesis;Systematic_debugging_faster_than_shotgun_debugging;
|
|
344
|
+
rationale;root_cause_elimination_prevents_reoccurrence;
|
|
345
|
+
confidence;0.96;
|
|
346
|
+
observation;Historical bug patterns accelerate diagnosis;
|
|
347
|
+
handoff: VerificationAgent;
|
|
348
|
+
---
|
|
349
|
+
agent: VerificationAgent;
|
|
350
|
+
intent: ensure_fix_actually_works;
|
|
351
|
+
context:
|
|
352
|
+
proposed_fix;from_DebuggingAgent;
|
|
353
|
+
original_bug;from_DebuggingAgent;
|
|
354
|
+
constraints:
|
|
355
|
+
- reproduce_original_bug_first;confirm_exists;
|
|
356
|
+
- apply_fix;
|
|
357
|
+
- verify_bug_gone;
|
|
358
|
+
- verify_no_regressions;
|
|
359
|
+
- verify_edge_cases;
|
|
360
|
+
- run_full_test_suite;
|
|
361
|
+
- check_output_pristine;
|
|
362
|
+
- if_not_fixed;restart_debugging;
|
|
363
|
+
priority: high;
|
|
364
|
+
output: verification_status;regression_check;
|
|
365
|
+
log: verification_complete;timestamp;status;regressions;
|
|
366
|
+
meta:
|
|
367
|
+
hypothesis;Verification_catches_incomplete_fixes;
|
|
368
|
+
rationale;feeling_fixed_does_not_mean_fixed;
|
|
369
|
+
confidence;0.98;
|
|
370
|
+
handoff: CodeReviewAgent;
|
|
371
|
+
---
|
|
372
|
+
agent: CodeReviewAgent;
|
|
373
|
+
intent: conduct_pre_merge_quality_gate;
|
|
374
|
+
context:
|
|
375
|
+
implementation;from_SubagentDriver_or_BatchExecutor;
|
|
376
|
+
plan;from_PlanningAgent;
|
|
377
|
+
memory_tool;tools/memory_mesh.js;
|
|
378
|
+
memory_status;from_MemorySystemInitializer;
|
|
379
|
+
constraints:
|
|
380
|
+
- review_against_plan;
|
|
381
|
+
- all_requirements_implemented;
|
|
382
|
+
- no_extra_features_beyond_spec;
|
|
383
|
+
- file_matches_match_plan;
|
|
384
|
+
- code_quality_check;
|
|
385
|
+
- tests_cover_all_cases;
|
|
386
|
+
- tests_use_real_code_not_mocks;
|
|
387
|
+
- code_is_clean_not_clever;
|
|
388
|
+
- names_are_clear;
|
|
389
|
+
- no_duplication;
|
|
390
|
+
- proper_error_handling;
|
|
391
|
+
- report_by_severity;
|
|
392
|
+
- critical;blocks_progress;must_fix;
|
|
393
|
+
- important;should_fix_before_merge;
|
|
394
|
+
- minor;nice_to_have;
|
|
395
|
+
- if_critical_issues;block_progress;
|
|
396
|
+
- if_no_issues;approve;
|
|
397
|
+
- if_memory_available;store_review_outcome;
|
|
398
|
+
- content_format;"Code review: <feature>. Quality: <rating>. Issues: <count>. Tests: <coverage>. Outcome: <approved/rejected>.";
|
|
399
|
+
- metadata;{workflow:"yamo-super",phase:"review",quality_rating:"<rating>",issues_count:"<n>",timestamp:"<iso>"};
|
|
400
|
+
priority: critical;
|
|
401
|
+
output: review_report;approval_status;memory_id;
|
|
402
|
+
log: review_complete;timestamp;critical;important;minor;status;
|
|
403
|
+
meta:
|
|
404
|
+
hypothesis;Pre_merge_review_catches_issues_early;
|
|
405
|
+
rationale;merge_reviews_are_too_late_for_easy_fixes;
|
|
406
|
+
confidence;0.97;
|
|
407
|
+
handoff: BranchFinisher;
|
|
408
|
+
---
|
|
409
|
+
agent: BranchFinisher;
|
|
410
|
+
intent: complete_development_branch_workflow;
|
|
411
|
+
context:
|
|
412
|
+
implementation;from_CodeReviewAgent;
|
|
413
|
+
worktree_path;from_WorktreeAgent;
|
|
414
|
+
review_report;from_CodeReviewAgent;
|
|
415
|
+
constraints:
|
|
416
|
+
- verify_all_tests_pass;
|
|
417
|
+
- verify_no_regressions;
|
|
418
|
+
- present_options;
|
|
419
|
+
- merge_to_main;
|
|
420
|
+
- create_pull_request;
|
|
421
|
+
- keep_branch_for_more_work;
|
|
422
|
+
- discard_branch;
|
|
423
|
+
- if_merge;merge_fast_forward_or_squash;delete_worktree;
|
|
424
|
+
- if_pull_request;create_pr_with_description;link_to_plan;
|
|
425
|
+
- if_discard;delete_branch;remove_worktree;
|
|
426
|
+
- document_decision;
|
|
427
|
+
priority: high;
|
|
428
|
+
output: merge_status;pr_url_or_branch_deleted;
|
|
429
|
+
log: branch_completed;timestamp;outcome;
|
|
430
|
+
meta:
|
|
431
|
+
hypothesis;Explicit_branch_completion_prevents_orphan_branches;
|
|
432
|
+
rationale;clear_decisions_prevent_branch_accumulation;
|
|
433
|
+
confidence;0.95;
|
|
434
|
+
handoff: WorkflowMemoryStore;
|
|
435
|
+
---
|
|
436
|
+
agent: ParallelDispatcher;
|
|
437
|
+
intent: coordinate_concurrent_subagent_workflows;
|
|
438
|
+
context:
|
|
439
|
+
independent_tasks;task_list;
|
|
440
|
+
constraints:
|
|
441
|
+
- identify_truly_independent_tasks;
|
|
442
|
+
- dispatch_subagents_in_parallel;
|
|
443
|
+
- wait_for_all_subagents;
|
|
444
|
+
- collect_results;
|
|
445
|
+
- detect_conflicts;
|
|
446
|
+
- if_conflicts;resolve_sequentially;
|
|
447
|
+
- merge_results;
|
|
448
|
+
priority: medium;
|
|
449
|
+
output: parallel_results;conflict_resolution_log;
|
|
450
|
+
log: parallel_dispatch_complete;timestamp;tasks;conflicts;
|
|
451
|
+
meta:
|
|
452
|
+
hypothesis;Parallel_execution_saves_wall_clock_time;
|
|
453
|
+
rationale;independent_tasks_have_no_dependencies;
|
|
454
|
+
confidence;0.89;
|
|
455
|
+
handoff: SkillMetaAgent;
|
|
456
|
+
---
|
|
457
|
+
agent: SkillMetaAgent;
|
|
458
|
+
intent: enable_skill_creation_and_extension;
|
|
459
|
+
context:
|
|
460
|
+
new_skill_idea;user_request;
|
|
461
|
+
constraints:
|
|
462
|
+
- use_writing_skills_skill;
|
|
463
|
+
- follow_skill_structure;
|
|
464
|
+
- metadata_block;
|
|
465
|
+
- agent_definitions;
|
|
466
|
+
- constraints_as_semicolon_key_values;
|
|
467
|
+
- triple_dash_delimiters;
|
|
468
|
+
- explicit_handoff_chains;
|
|
469
|
+
- ensure_v1_compliance;
|
|
470
|
+
- scaffold_tests;
|
|
471
|
+
- validate_syntax;
|
|
472
|
+
- classify_category;
|
|
473
|
+
priority: low;
|
|
474
|
+
output: new_skill_yamo;test_plan;
|
|
475
|
+
log: skill_created;timestamp;name;category;
|
|
476
|
+
meta:
|
|
477
|
+
hypothesis;Meta_skills_enable_ecosystem_growth;
|
|
478
|
+
rationale;extensible_systems_adapt_to_new_needs;
|
|
479
|
+
confidence;0.88;
|
|
480
|
+
handoff: End;
|
|
481
|
+
---
|
|
482
|
+
agent: UsageGuide;
|
|
483
|
+
intent: introduce_superpowers_workflow;
|
|
484
|
+
context:
|
|
485
|
+
user;new_to_superpowers;
|
|
486
|
+
constraints:
|
|
487
|
+
- explain_basic_workflow;
|
|
488
|
+
- brainstorming;design_refinement;
|
|
489
|
+
- using_git_worktrees;isolated_workspace;
|
|
490
|
+
- writing_plans;implementation_breakdown;
|
|
491
|
+
- subagent_driven_or_executing_plans;task_execution;
|
|
492
|
+
- test_driven_development;red_green_refactor;
|
|
493
|
+
- systematic_debugging;root_cause_analysis;
|
|
494
|
+
- requesting_code_review;quality_gate;
|
|
495
|
+
- finishing_development_branch;merge_pr_discard;
|
|
496
|
+
- memory_integration;pattern_recognition;
|
|
497
|
+
- explain_skills_trigger_automatically;
|
|
498
|
+
- explain_mandatory_not_suggestions;
|
|
499
|
+
- demonstrate_with_example;
|
|
500
|
+
priority: low;
|
|
501
|
+
output: user_understanding;workflow_ready;
|
|
502
|
+
log: onboarded;timestamp;user;
|
|
503
|
+
meta:
|
|
504
|
+
hypothesis;clear_introduction_enables_effective_use;
|
|
505
|
+
rationale;understanding_why_builds_compliance;
|
|
506
|
+
confidence;0.92;
|
|
507
|
+
handoff: WorkflowMemoryStore;
|
|
508
|
+
---
|
|
509
|
+
agent: WorkflowMemoryStore;
|
|
510
|
+
intent: store_complete_workflow_execution_for_pattern_recognition;
|
|
511
|
+
context:
|
|
512
|
+
workflow_decision;from_WorkflowOrchestrator;
|
|
513
|
+
design_output;from_DocumentationAgent;
|
|
514
|
+
implementation_result;from_SubagentDriver_or_BatchExecutor;
|
|
515
|
+
review_result;from_CodeReviewAgent;
|
|
516
|
+
branch_outcome;from_BranchFinisher;
|
|
517
|
+
memory_tool;tools/memory_mesh.js;
|
|
518
|
+
memory_status;from_MemorySystemInitializer;
|
|
519
|
+
constraints:
|
|
520
|
+
- if_memory_available;store_complete_workflow;
|
|
521
|
+
- aggregate_all_phase_data;
|
|
522
|
+
- content_format;"Workflow: yamo-super. Mode: <mode>. Project: <project>. Design: <summary>. Implementation: <tasks_completed>. Review: <quality>. Tests: <passed/failed>. Outcome: <success/failure>. Duration: <time>.";
|
|
523
|
+
- metadata;{
|
|
524
|
+
workflow:"yamo-super",
|
|
525
|
+
mode:"<selected_mode>",
|
|
526
|
+
project:"<project_name>",
|
|
527
|
+
phase:"complete",
|
|
528
|
+
design_commit:"<sha>",
|
|
529
|
+
implementation_commits:"<count>",
|
|
530
|
+
tests_passed:"<true/false>",
|
|
531
|
+
review_approved:"<true/false>",
|
|
532
|
+
outcome:"<success/failure>",
|
|
533
|
+
duration_minutes:"<n>",
|
|
534
|
+
timestamp:"<iso>"
|
|
535
|
+
};
|
|
536
|
+
- generate_workflow_embedding;
|
|
537
|
+
- tag_by_mode_project_type_and_outcome;
|
|
538
|
+
- enable_future_recommendations;
|
|
539
|
+
- if_blockchain_available;anchor_to_yamo_chain;
|
|
540
|
+
priority: high;
|
|
541
|
+
output: workflow_memory_receipt.json;
|
|
542
|
+
log: workflow_stored;memory_id;outcome;timestamp;
|
|
543
|
+
meta:
|
|
544
|
+
hypothesis;Storing complete workflows enables pattern recognition for future recommendations;
|
|
545
|
+
rationale;Historical success patterns guide future workflow decisions;
|
|
546
|
+
confidence;0.94;
|
|
547
|
+
observation;Semantic search finds similar contexts not just keyword matches;
|
|
548
|
+
handoff: End;
|