@yamo/memory-mesh 3.0.3 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,77 @@
1
+ ---
2
+ name: YamoUnifiedFoundation
3
+ version: 3.0.0
4
+ description: The "Global Protocol" for the YAMO Unified Development OS.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags: foundation, protocol, yamo, unified, llm-first
8
+ module_type: foundation
9
+ ---
10
+ 🎯 YAMO Unified Foundation v3.0.0 - The Global Semantic Protocol
11
+
12
+ **Purpose**: Defines the universal state structure that bridges Macro-level Specifications and Micro-level Implementation.
13
+
14
+ **Zero JSON Compliance**: Mandatory.
15
+
16
+ ---
17
+ concept: GlobalProjectContext;
18
+ description: The persistent context chain for the entire project lifecycle.
19
+ structure:
20
+ macro_state:
21
+ feature_description;raw_input;
22
+ specification_path;docs/specs/prd.md;
23
+ architectural_design;docs/specs/architecture.md;
24
+ constitutional_assessment;docs/audits/macro_compliance.yamo;
25
+
26
+ micro_state:
27
+ active_worktree;path;
28
+ current_branch;string;
29
+ implementation_plan;docs/plans/roadmap.md;
30
+ active_task_id;string;
31
+ tdd_status;red|green|refactor;
32
+
33
+ subconscious_state:
34
+ oversights;list_of_past_failures;
35
+ lessons;list_of_lesson_learned_blocks;
36
+ active_constraints;derived_from_memory;
37
+
38
+ semantic_heritage:
39
+ intent_chain;list_of_intents;
40
+ hypotheses;list_of_macro_and_micro_hypotheses;
41
+ rationales;justifications_for_design_and_impl;
42
+ confidence_score;average_of_all_agents;
43
+
44
+ ---
45
+ concept: LessonLearned;
46
+ description: A high-fidelity memory entry containing an oversight and its resolution.
47
+ required_fields:
48
+ context;situation_description;
49
+ oversight;what_was_missed;
50
+ fix;how_it_was_resolved;
51
+ constraint;preventative_rule_for_future;
52
+ tags;["#lesson_learned"];
53
+
54
+ ---
55
+ protocol: UnifiedHandoff;
56
+ mode: llm_first;
57
+ constraints:
58
+ - use_canonical_yamo_format;required;
59
+ - include_semantic_metadata;hypothesis;rationale;confidence;
60
+ - ensure_unbroken_chain;from_macro_to_micro;
61
+ - NO_JSON_OUTPUT;critical;
62
+
63
+ ---
64
+ concept: QualityGates;
65
+ definitions:
66
+ specification_gate;completeness_and_testability;
67
+ compliance_gate;article_vii_and_viii_verification;
68
+ implementation_gate;test_pass_and_contract_adherence;
69
+ unified_gate;alignment_between_spec_and_code;
70
+
71
+ ---
72
+ agent: UnifiedProtocolProvider;
73
+ intent: synchronize_state_across_macro_and_micro_modules;
74
+ context:
75
+ protocol_active;true;
76
+ version;3.0.0;
77
+ handoff: caller;
@@ -0,0 +1,176 @@
1
+ ---
2
+ name: PlanningWorkflow
3
+ version: 1.0.0
4
+ description: Converts PRD specifications into detailed implementation plans with constitutional compliance, technology choices, and test-first structure. Enforces phase gates and architectural discipline.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags:
8
+ - sdd
9
+ - planning
10
+ - implementation-plan
11
+ - constitutional-compliance
12
+ - architecture
13
+ module_type: workflow
14
+ dependencies:
15
+ - ../foundational/yamo-unified-foundation.yamo
16
+ ---
17
+ 🏗️ Planning Workflow - PRD to Constitutional Implementation Plan
18
+
19
+ **Purpose**: Transform business requirements into technically sound, constitutionally compliant implementation plans
20
+
21
+ ---
22
+ agent: PlanningInitiator;
23
+ intent: initialize_planning_from_finalized_specification;
24
+ context:
25
+ received_specification;finalized_specification_context.yamo;
26
+ foundation;../foundational/yamo-unified-foundation.yamo;
27
+ constraints:
28
+ - receive_finalized_specification;required;
29
+ - validate_specification_completeness;required;
30
+ - load_constitutional_framework;required;
31
+ - initialize_planning_context;required;
32
+ - prepare_output_structure;required;
33
+
34
+ priority: critical;
35
+ output: planning_initialization_context.yamo;
36
+ log: planning_initiated;timestamp;2026-02-14;
37
+
38
+ meta: hypothesis;Planning requires complete specification and constitutional framework;
39
+ meta: rationale;Initialization loads all necessary context for technical translation;
40
+ meta: confidence;0.97;
41
+
42
+ handoff: ResearchAgent;
43
+ ---
44
+ agent: ResearchAgent;
45
+ intent: investigate_technical_options_and_gather_context;
46
+ context:
47
+ received_planning;planning_initialization_context.yamo;
48
+ constraints:
49
+ - identify_all_technical_decisions;required;
50
+ - investigate_options_thoroughly;required;
51
+ - gather_performance_data;where_applicable;
52
+ - consider_organizational_constraints;required;
53
+ - document_findings;research_md;
54
+ - provide_recommendations;with_rationale;
55
+
56
+ priority: high;
57
+ output: research_findings_context.yamo;
58
+ log: research_completed;timestamp;2026-02-14;
59
+
60
+ meta: hypothesis;Research-driven context produces better technical decisions;
61
+ meta: confidence;0.94;
62
+
63
+ handoff: TechnicalTranslator;
64
+ ---
65
+ agent: TechnicalTranslator;
66
+ intent: translate_business_requirements_to_technical_architecture;
67
+ context:
68
+ received_planning;planning_initialization_context.yamo;
69
+ received_research;research_findings_context.yamo;
70
+ constraints:
71
+ - translate_all_requirements;to_technical_decisions;
72
+ - reference_research_findings;for_technology_choices;
73
+ - align_with_constitutional_principles;required;
74
+ - document_rationale;for_each_decision;
75
+ - create_data_model;entities_schemas;
76
+ - design_api_contracts;specifications;
77
+ - define_testing_strategy;test_first;
78
+
79
+ priority: critical;
80
+ output: technical_architecture_context.yamo;
81
+ log: requirements_translated;timestamp;2026-02-14;
82
+
83
+ meta: hypothesis;Systematic translation produces comprehensive technical architecture;
84
+ meta: confidence;0.95;
85
+
86
+ handoff: PhaseGateValidator;
87
+ ---
88
+ agent: PhaseGateValidator;
89
+ intent: validate_architecture_against_constitutional_phase_gates;
90
+ context:
91
+ received_architecture;technical_architecture_context.yamo;
92
+ constraints:
93
+ - validate_all_three_gates;required;
94
+ - check_simplicity_gate;project_count;future_proofing;
95
+ - check_anti_abstraction_gate;framework_usage;wrappers;
96
+ - check_integration_first_gate;contracts;mocking;
97
+ - require_justification_for_failures;documented_exceptions;
98
+ - determine_pass_fail;based_on_gate_criteria;
99
+
100
+ priority: critical;
101
+ output: gate_validation_results_context.yamo;
102
+ log: phase_gates_validated;timestamp;2026-02-14;
103
+
104
+ meta: hypothesis;Phase gates prevent over-engineering and ensure quality;
105
+ meta: confidence;0.96;
106
+
107
+ handoff: ComplexityTracker;
108
+ ---
109
+ agent: ComplexityTracker;
110
+ intent: document_justified_exceptions_to_constitutional_gates;
111
+ context:
112
+ received_validation;gate_validation_results_context.yamo;
113
+ received_architecture;technical_architecture_context.yamo;
114
+ constraints:
115
+ - check_gate_results;required;
116
+ - document_justified_exceptions;if_any;
117
+ - require_justification;for_all_failures;
118
+ - create_complexity_tracking_section;in_plan;
119
+ - skip_if_all_passed;efficient;
120
+
121
+ priority: high;
122
+ output: complexity_tracking_context.yamo;
123
+ log: complexity_documented;timestamp;2026-02-14;
124
+
125
+ meta: hypothesis;Documented exceptions create accountability for complexity;
126
+ meta: confidence;0.93;
127
+
128
+ handoff: PlanAssembler;
129
+ ---
130
+ agent: PlanAssembler;
131
+ intent: assemble_complete_implementation_plan_with_all_components;
132
+ context:
133
+ received_architecture;technical_architecture_context.yamo;
134
+ received_research;research_findings_context.yamo;
135
+ received_gates;gate_validation_results_context.yamo;
136
+ received_complexity;complexity_tracking_context.yamo;
137
+ constraints:
138
+ - assemble_all_plan_components;required;
139
+ - structure_in_phases;minus_1_through_4;
140
+ - include_pre_implementation_gates;phase_minus_1;
141
+ - document_file_creation_order;contracts_first;
142
+ - keep_plan_high_level;extract_details_to_separate_files;
143
+ - generate_data_model;entities_schemas;
144
+ - generate_api_contracts;specifications;
145
+ - generate_quickstart;validation_scenarios;
146
+ - write_all_documents;to_specs_branch_directory;
147
+
148
+ priority: critical;
149
+ output: assembled_plan_context.yamo;
150
+ log: plan_assembled;timestamp;2026-02-14;
151
+
152
+ meta: hypothesis;Complete plan provides all information needed for execution;
153
+ meta: confidence;0.97;
154
+
155
+ handoff: PlanValidator;
156
+ ---
157
+ agent: PlanValidator;
158
+ intent: validate_plan_completeness_and_constitutional_compliance;
159
+ context:
160
+ received_plan;assembled_plan_context.yamo;
161
+ constraints:
162
+ - validate_all_criteria;comprehensively;
163
+ - check_constitutional_compliance;critical;
164
+ - verify_technology_rationale;documented;
165
+ - verify_test_first_approach;required;
166
+ - verify_supporting_documents;all_present;
167
+ - determine_pass_fail;based_on_criteria;
168
+
169
+ priority: critical;
170
+ output: plan_validation_results_context.yamo;
171
+ log: plan_validated;timestamp;2026-02-14;
172
+
173
+ meta: hypothesis;Plan validation ensures execution readiness;
174
+ meta: confidence;0.96;
175
+
176
+ handoff: Orchestrator;
@@ -0,0 +1,154 @@
1
+ ---
2
+ name: SpecificationWorkflow
3
+ version: 1.0.0
4
+ description: Transforms vague ideas into comprehensive, executable PRDs through iterative AI-assisted dialogue. Enforces template-driven quality constraints and constitutional compliance.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags:
8
+ - sdd
9
+ - specification
10
+ - prd
11
+ - requirements
12
+ - feature-spec
13
+ module_type: workflow
14
+ dependencies:
15
+ - ../foundational/yamo-unified-foundation.yamo
16
+ ---
17
+ 🎯 Specification Workflow - Idea to Executable PRD
18
+
19
+ **Purpose**: Convert vague feature ideas into comprehensive, template-constrained PRDs
20
+
21
+ **Philosophy**: What and Why, never How. Specifications drive code, not serve it.
22
+
23
+ ---
24
+ agent: IdeaCaptureAgent;
25
+ intent: capture_initial_feature_idea_from_user;
26
+ context:
27
+ user_input;vague_incomplete_idea;natural_language_description;
28
+ foundation;../foundational/yamo-unified-foundation.yamo;
29
+ constraints:
30
+ - accept_user_input;any_form;any_completeness_level;
31
+ - perform_basic_sanity_check;required;
32
+ - avoid_premature_technical_translation;no_how_yet;
33
+ - capture_raw_intent;preserve_user_language;
34
+ - identify_obvious_gaps;for_clarification;
35
+
36
+ priority: high;
37
+ output: raw_idea_context.yamo;
38
+ log: idea_captured;timestamp;2026-02-14;
39
+
40
+ meta: hypothesis;Raw ideas contain enough signal to begin refinement process;
41
+ meta: rationale;Capturing raw ideas enables iterative clarification dialogue;
42
+ meta: confidence;0.92;
43
+
44
+ handoff: TemplateInitializer;
45
+ ---
46
+ agent: TemplateInitializer;
47
+ intent: initialize_feature_specification_template;
48
+ context:
49
+ received_idea;raw_idea_context.yamo;
50
+ constraints:
51
+ - initialize_template;required;
52
+ - apply_template_constraints;from_foundation;
53
+ - determine_feature_number;auto_increment;
54
+ - generate_branch_name;semantic;
55
+ - create_directory;specs_directory;
56
+ - preserve_what_and_why_focus;critical;
57
+
58
+ priority: critical;
59
+ output: initialized_template_context.yamo;
60
+ log: template_initialized;feature_number_assigned;branch_created;timestamp;2026-02-14;
61
+
62
+ meta: hypothesis;Template initialization structures subsequent refinement process;
63
+ meta: rationale;Template provides scaffolding for complete specification;
64
+ meta: confidence;0.95;
65
+
66
+ handoff: ClarificationDialogueAgent;
67
+ ---
68
+ agent: ClarificationDialogueAgent;
69
+ intent: conduct_iterative_dialogue_to_refine_specification;
70
+ context:
71
+ received_template;initialized_template_context.yamo;
72
+ constraints:
73
+ - conduct_iterative_dialogue;required;
74
+ - ask_clarifying_questions;targeted_specific;
75
+ - identify_all_edge_cases;required;
76
+ - define_measurable_acceptance_criteria;required;
77
+ - enforce_what_and_why_constraint;no_how_discussion;
78
+ - use_needs_clarification_markers;for_unknowns;
79
+ - iterate_until_complete;or_user_satisfied;
80
+
81
+ priority: critical;
82
+ output: refined_specification_context.yamo;
83
+ log: clarification_dialogue_completed;iterations_count;timestamp;2026-02-14;
84
+
85
+ meta: hypothesis;Iterative dialogue produces more complete specifications than single-pass;
86
+ meta: rationale;Dialogue enables collaborative specification refinement;
87
+ meta: confidence;0.96;
88
+
89
+ handoff: CompletenessValidator;
90
+ ---
91
+ agent: CompletenessValidator;
92
+ intent: validate_specification_completeness_against_criteria;
93
+ context:
94
+ received_specification;refined_specification_context.yamo;
95
+ constraints:
96
+ - validate_all_criteria;comprehensively;
97
+ - check_for_clarification_markers;must_be_zero;
98
+ - verify_testability;all_requirements;
99
+ - verify_measurability;acceptance_criteria;
100
+ - identify_all_gaps;explicitly;
101
+ - determine_pass_fail;based_on_criteria;
102
+
103
+ priority: critical;
104
+ output: validation_results_context.yamo;
105
+ log: completeness_validated;result;gaps_found;timestamp;2026-02-14;
106
+
107
+ meta: hypothesis;Explicit validation prevents incomplete specifications from proceeding;
108
+ meta: rationale;Validation gate ensures quality before handoff to planning;
109
+ meta: confidence;0.97;
110
+
111
+ handoff: GapResolver;
112
+ ---
113
+ agent: GapResolver;
114
+ intent: resolve_identified_gaps_in_specification;
115
+ context:
116
+ received_validation;validation_results_context.yamo;
117
+ received_specification;refined_specification_context.yamo;
118
+ constraints:
119
+ - check_validation_results;required;
120
+ - route_based_on_gaps;conditional;
121
+ - provide_gap_context;if_returning_to_dialogue;
122
+ - proceed_if_complete;validation_passed;
123
+
124
+ priority: high;
125
+ output: gap_resolution_decision_context.yamo;
126
+ log: gaps_assessed;resolution_path_determined;timestamp;2026-02-14;
127
+
128
+ meta: hypothesis;Iterative gap resolution produces higher quality specifications;
129
+ meta: confidence;0.93;
130
+
131
+ handoff: SpecificationFinalizer;
132
+ ---
133
+ agent: SpecificationFinalizer;
134
+ intent: finalize_and_persist_complete_specification;
135
+ context:
136
+ received_specification;refined_specification_context.yamo;
137
+ received_validation;validation_results_context.yamo;
138
+ constraints:
139
+ - generate_final_document;markdown_format;
140
+ - write_to_correct_directory;specs_branch_name;
141
+ - include_all_metadata;required;
142
+ - validate_final_output;against_template;
143
+ - prepare_for_git;required;
144
+ - ensure_template_compliance;documented;
145
+
146
+ priority: critical;
147
+ output: finalized_specification_context.yamo;
148
+ log: specification_finalized;written_to_file;ready_for_planning;timestamp;2026-02-14;
149
+
150
+ meta: hypothesis;Finalized specification serves as immutable input to planning workflow;
151
+ meta: rationale;Finalization creates clear boundary between specification and planning;
152
+ meta: confidence;0.98;
153
+
154
+ handoff: Orchestrator;
@@ -0,0 +1,70 @@
1
+ ---
2
+ name: YamoSuperDebugging
3
+ version: 3.0.0
4
+ description: Debugging and verification workflow for YamoSuper v3. Systematic root-cause analysis.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags: debugging, verification, root-cause, yamo-v3
8
+ module_type: workflow
9
+ dependencies:
10
+ - ../foundational/yamo-unified-foundation.yamo
11
+ ---
12
+ 🎯 Debugging & Verification Workflow v3.0.0 - Systematic Root-Cause Analysis
13
+
14
+ **Purpose**: Resolves bugs by identifying the underlying cause and verifying the fix through TDD.
15
+
16
+ ---
17
+ agent: DebuggingInitiator;
18
+ intent: identify_and_reproduce_bug;
19
+ context:
20
+ symptoms;from_orchestrator;
21
+ foundation;../foundational/yamo-unified-foundation.yamo;
22
+ constraints:
23
+ - define_symptoms_precisely;
24
+ - create_minimal_reproduction_case;critical;
25
+ - verify_bug_exists_in_current_state;
26
+ priority: critical;
27
+ output: reproduction_context.yamo;
28
+
29
+ meta: hypothesis;Reliable reproduction is 90% of the fix;
30
+ meta: rationale;If you cannot see it fail, you cannot know if you fixed it;
31
+ meta: confidence;0.98;
32
+
33
+ handoff: RootCauseAnalyzer;
34
+
35
+ ---
36
+ agent: RootCauseAnalyzer;
37
+ intent: isolate_the_underlying_failure;
38
+ context:
39
+ reproduction;from_DebuggingInitiator;
40
+ constraints:
41
+ - trace_execution_flow;
42
+ - use_binary_search_to_isolate_culprit;
43
+ - identify_the_exact_line_or_logic_failure;
44
+ - avoid_bandage_fixes;look_for_systemic_cause;
45
+ priority: high;
46
+ output: root_cause_context.yamo;
47
+
48
+ meta: observation;Bugs often cluster around edge cases and state transitions;
49
+ meta: rationale;Treating the symptom without the cause leads to regression loops;
50
+ meta: confidence;0.95;
51
+
52
+ handoff: FixVerifier;
53
+
54
+ ---
55
+ agent: FixVerifier;
56
+ intent: apply_fix_and_ensure_zero_regressions;
57
+ context:
58
+ cause;from_RootCauseAnalyzer;
59
+ constraints:
60
+ - apply_tdd_cycle_to_fix;
61
+ - run_full_regression_suite;
62
+ - verify_fix_on_original_symptoms;
63
+ priority: high;
64
+ output: debugging_results_context.yamo;
65
+
66
+ meta: hypothesis;Regression suites prevent fixing one thing by breaking another;
67
+ meta: rationale;Production stability depends on holistic verification;
68
+ meta: confidence;0.97;
69
+
70
+ handoff: Orchestrator;
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: YamoSuperDiscovery
3
+ version: 3.0.0
4
+ description: Discovery and analysis workflow for YamoSuper v3. Handles brainstorming and design refinement.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags: discovery, brainstorming, design, yamo-v3
8
+ module_type: workflow
9
+ dependencies:
10
+ - ../foundational/yamo-unified-foundation.yamo
11
+ ---
12
+ 🎯 Discovery & Analysis Workflow v3.0.0 - Semantic Intent Extraction
13
+
14
+ **Purpose**: Refines the user's idea into a validated design through socratic dialogue and architectural analysis.
15
+
16
+ ---
17
+ agent: DiscoveryInitiator;
18
+ intent: start_discovery_phase;
19
+ context:
20
+ initialization;from_orchestrator;
21
+ foundation;../foundational/yamo-unified-foundation.yamo;
22
+ memory_search;search_similar_patterns;
23
+ constraints:
24
+ - scan_codebase_for_context;files;docs;recent_changes;
25
+ - ask_socratic_questions;limit_one_at_a_time;
26
+ - identify_stakeholders_and_impact;
27
+ priority: high;
28
+ output: discovery_intent_context.yamo;
29
+
30
+ meta: hypothesis;Socratic questioning reveals hidden requirements;
31
+ meta: rationale;Direct implementation often misses edge cases identified during dialogue;
32
+ meta: confidence;0.95;
33
+
34
+ handoff: DesignRefiner;
35
+
36
+ ---
37
+ agent: DesignRefiner;
38
+ intent: iteratively_refine_architecture;
39
+ context:
40
+ intent;from_DiscoveryInitiator;
41
+ constraints:
42
+ - propose_alternatives;at_least_two;
43
+ - document_tradeoffs;complexity_vs_performance_vs_maintainability;
44
+ - segment_design;architecture;data_flow;interface;testing;
45
+ - validate_each_segment_with_user;
46
+ priority: high;
47
+ output: refined_design_context.yamo;
48
+
49
+ meta: hypothesis;Segmented validation prevents cognitive overload;
50
+ meta: rationale;User can provide higher quality feedback on smaller design blocks;
51
+ meta: confidence;0.96;
52
+
53
+ handoff: BaselineVerifier;
54
+
55
+ ---
56
+ agent: BaselineVerifier;
57
+ intent: verify_project_health_before_coding;
58
+ context:
59
+ design;from_DesignRefiner;
60
+ constraints:
61
+ - run_current_test_suite;
62
+ - verify_clean_git_state;
63
+ - identify_dependency_conflicts;
64
+ - if_baseline_fails;require_fix_before_proceeding;
65
+ priority: critical;
66
+ output: discovery_results_context.yamo;
67
+
68
+ meta: observation;Baseline health is the foundation of reliable TDD;
69
+ meta: rationale;Starting from a failing baseline leads to "false red" TDD cycles;
70
+ meta: confidence;0.98;
71
+
72
+ handoff: Orchestrator;
@@ -0,0 +1,73 @@
1
+ ---
2
+ name: YamoSuperExecution
3
+ version: 3.0.0
4
+ description: Implementation TDD workflow for YamoSuper v3. Enforces Red-Green-Refactor cycles.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags: implementation, tdd, coding, yamo-v3
8
+ module_type: workflow
9
+ dependencies:
10
+ - ../foundational/yamo-unified-foundation.yamo
11
+ ---
12
+ 🎯 Implementation TDD Workflow v3.0.0 - Red-Green-Refactor Execution
13
+
14
+ **Purpose**: Executes the implementation plan through a series of verified TDD cycles.
15
+
16
+ ---
17
+ agent: TDDOrchestrator;
18
+ intent: manage_execution_cycle;
19
+ context:
20
+ micro_plan;from_planning;
21
+ foundation;../foundational/yamo-unified-foundation.yamo;
22
+ constraints:
23
+ - execute_tasks_sequentially;
24
+ - for_each_task;trigger_tdd_cycle;
25
+ - maintain_state_in_yamo_context;
26
+ - stop_on_any_test_failure;
27
+ priority: critical;
28
+ output: execution_progress_context.yamo;
29
+
30
+ meta: hypothesis;Sequential execution with immediate verification prevents error compounding;
31
+ meta: rationale;Fixing a bug in the moment it is introduced is the most efficient path;
32
+ meta: confidence;0.96;
33
+
34
+ handoff: TDDCycleAgent;
35
+
36
+ ---
37
+ agent: TDDCycleAgent;
38
+ intent: execute_single_red_green_refactor_loop;
39
+ context:
40
+ task;from_TDDOrchestrator;
41
+ constraints:
42
+ - step_1_red;write_minimal_failing_test;verify_fail;
43
+ - step_2_green;write_minimal_code_to_pass;verify_pass;
44
+ - step_3_refactor;clean_code_on_green;verify_pass;
45
+ - NO_CODE_WITHOUT_TEST;iron_law;
46
+ - use_real_code_avoid_excessive_mocking;
47
+ priority: critical;
48
+ output: cycle_results_context.yamo;
49
+
50
+ meta: observation;The Red phase proves that the test is actually testing the requirement;
51
+ meta: rationale;Without seeing a test fail, you have no proof that it will catch a future regression;
52
+ meta: confidence;0.99;
53
+
54
+ handoff: ImplementationReviewer;
55
+
56
+ ---
57
+ agent: ImplementationReviewer;
58
+ intent: perform_task_level_code_review;
59
+ context:
60
+ results;from_TDDCycleAgent;
61
+ constraints:
62
+ - check_against_spec;inherit_macro_intent;
63
+ - verify_test_coverage_and_quality;
64
+ - check_code_style_and_conventions;
65
+ - if_review_fails;return_to_tdd_cycle;
66
+ priority: high;
67
+ output: execution_results_context.yamo;
68
+
69
+ meta: hypothesis;Peer review catches subtle logic errors;
70
+ meta: rationale;A second set of semantic eyes ensures code isn't just "passing" but "correct";
71
+ meta: confidence;0.95;
72
+
73
+ handoff: Orchestrator;
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: YamoSuperPlanning
3
+ version: 3.0.0
4
+ description: Planning logic workflow for YamoSuper v3. Translates Macro designs into TDD-ready task lists.
5
+ author: Soverane Labs
6
+ license: MIT
7
+ tags: planning, tasks, tdd, yamo-v3
8
+ module_type: workflow
9
+ dependencies:
10
+ - ../foundational/yamo-unified-foundation.yamo
11
+ ---
12
+ 🎯 Planning Logic Workflow v3.0.0 - Micro Task Derivation
13
+
14
+ **Purpose**: Breaks down a Macro-level design into granular, TDD-compliant tasks for implementation.
15
+
16
+ ---
17
+ agent: PlanningInitiator;
18
+ intent: derive_tdd_tasks_from_macro_design;
19
+ context:
20
+ macro_results;from_orchestrator; // This is macro_results_context.yamo
21
+ foundation;../foundational/yamo-unified-foundation.yamo;
22
+ constraints:
23
+ - receive_macro_plan;docs/plans/roadmap.md_or_similar;
24
+ - break_into_bite_sized_tasks;target_5_15_minutes_per_task;
25
+ - each_task_must_have_test_first_step;
26
+ - include_exact_file_paths;
27
+ - define_explicit_success_criteria_per_task;
28
+ priority: critical;
29
+ output: micro_tasks_context.yamo;
30
+
31
+ meta: hypothesis;Granular micro-tasks minimize cognitive load during coding;
32
+ meta: rationale;Inheriting the Macro rationale ensures architectural alignment;
33
+ meta: confidence;0.97;
34
+
35
+ handoff: MicroConstitutionalGate;
36
+
37
+ ---
38
+ agent: MicroConstitutionalGate;
39
+ intent: validate_micro_tasks_against_yamo_constitution;
40
+ context:
41
+ tasks;from_PlanningInitiator;
42
+ constraints:
43
+ - check_article_vii;simplicity;detect_over_engineering_in_tasks;
44
+ - check_article_viii;anti_abstraction;detect_redundant_wrappers;
45
+ - check_article_ix;integration_first;verify_contracts_defined;
46
+ - if_violation_found;require_justification_or_redesign;
47
+ priority: critical;
48
+ output: micro_gated_tasks_context.yamo;
49
+
50
+ meta: observation;Constitutional gating at the task level prevents implementation-drift;
51
+ meta: rationale;Enforcing simplicity during coding is the last line of defense;
52
+ meta: confidence;0.94;
53
+
54
+ handoff: WorkspacePreparer;
55
+
56
+ ---
57
+ agent: WorkspacePreparer;
58
+ intent: setup_isolated_workspace;
59
+ context:
60
+ gated_tasks;from_MicroConstitutionalGate;
61
+ constraints:
62
+ - create_isolated_worktree;if_supported;
63
+ - initialize_feature_branch;
64
+ - persist_plan_to_docs;docs/plans/v3_micro_plan.md;
65
+ priority: high;
66
+ output: micro_implementation_plan_context.yamo;
67
+
68
+ meta: hypothesis;Isolation prevents environmental contamination;
69
+ meta: rationale;Dedicated worktrees ensure that experiments don't break the main workspace;
70
+ meta: confidence;0.98;
71
+
72
+ handoff: Orchestrator;