@leclabs/agent-flow-navigator-mcp 1.7.0 → 1.9.0

package/catalog/workflows/agile-task.json

@@ -12,28 +12,32 @@
       "type": "task",
       "name": "Analyze",
       "description": "Understand requirements and plan approach",
-      "agent": "Planner",
+      "agent": "flow:Planner",
+      "emoji": "📋",
       "stage": "planning"
     },
     "implement": {
       "type": "task",
       "name": "Implement",
       "description": "Write the code or make changes",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "test": {
       "type": "task",
       "name": "Test",
       "description": "Verify the implementation works correctly",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "verification"
     },
     "review": {
       "type": "gate",
       "name": "Review",
       "description": "Review code quality and correctness",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "verification",
       "maxRetries": 2,
       "config": {
@@ -44,7 +48,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -52,7 +57,8 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit all changes with a descriptive message",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {

package/catalog/workflows/bug-fix.json

@@ -12,35 +12,40 @@
       "type": "task",
       "name": "Reproduce Bug",
       "description": "Understand the bug and create a reliable reproduction case",
-      "agent": "Investigator",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
       "stage": "investigation"
     },
     "investigate": {
       "type": "task",
       "name": "Investigate",
       "description": "Find root cause by tracing code paths and debugging",
-      "agent": "Investigator",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
       "stage": "investigation"
     },
     "write_fix": {
       "type": "task",
       "name": "Write Fix",
       "description": "Implement the fix with minimal changes",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "add_regression_test": {
       "type": "task",
       "name": "Add Regression Test",
       "description": "Write a test that would have caught this bug",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "development"
     },
     "verify_fix": {
       "type": "task",
       "name": "Verify Fix",
       "description": "Run all tests and verify the bug is fixed",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "verification",
       "maxRetries": 3
     },
@@ -48,7 +53,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -56,7 +62,8 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit the fix and regression test with a descriptive message",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {

package/catalog/workflows/bug-hunt.json

@@ -12,7 +12,8 @@
       "type": "task",
       "name": "Triage Report",
       "description": "Parse the vague report. Extract symptoms, affected area, timing, severity. Form 2-3 hypotheses to test.",
-      "agent": "Investigator",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
       "stage": "planning"
     },
     "fork_investigate": {
@@ -38,21 +39,24 @@
       "type": "task",
       "name": "Reproduce Bug",
       "description": "Try to trigger the bug. Document exact reproduction steps, environment, and observed vs expected behavior.",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "investigation"
     },
     "code_archaeology": {
       "type": "task",
       "name": "Code Archaeology",
       "description": "Trace the code paths related to the reported symptoms. Map data flow, identify suspect modules, check edge cases.",
-      "agent": "Investigator",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
       "stage": "investigation"
     },
     "git_forensics": {
       "type": "task",
       "name": "Git Forensics",
       "description": "Check recent commits touching affected areas. Run git blame on suspect files. Look for correlated changes or regressions.",
-      "agent": "Investigator",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
       "stage": "investigation"
     },
     "join_investigate": {
@@ -65,28 +69,32 @@
       "type": "task",
       "name": "Synthesize Findings",
       "description": "Combine findings from all investigation tracks into a root cause analysis. Identify the most likely cause, supporting evidence, and a fix strategy.",
-      "agent": "Architect",
+      "agent": "flow:Architect",
+      "emoji": "🏛️",
       "stage": "planning"
     },
     "write_fix": {
       "type": "task",
       "name": "Write Fix",
       "description": "Implement the fix with minimal changes",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "add_regression_test": {
       "type": "task",
       "name": "Add Regression Test",
       "description": "Write a test that would have caught this bug",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "development"
     },
     "verify_fix": {
       "type": "gate",
       "name": "Verify Fix",
       "description": "Run tests, verify fix addresses root cause",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "verification",
       "maxRetries": 3
     },
@@ -94,7 +102,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -102,7 +111,8 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit the fix and regression test with a descriptive message",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {

package/catalog/workflows/build-review-murder-board.json

@@ -12,14 +12,16 @@
       "type": "task",
       "name": "Build",
       "description": "Implement or revise the changes based on requirements or review feedback",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "review": {
       "type": "gate",
       "name": "Murder Board Review",
       "description": "Independent high-scrutiny review. Reviewer must be a fresh agent with no prior context of this build. Approval requires confidence score >= 80.",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "verification",
       "maxRetries": 3,
       "config": {
@@ -32,7 +34,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -40,7 +43,8 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit all changes with a descriptive message summarizing the work done",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {

package/catalog/workflows/build-review-quick.json

@@ -12,14 +12,16 @@
       "type": "task",
       "name": "Build",
       "description": "Implement or revise the changes based on requirements or review feedback",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "review": {
       "type": "gate",
       "name": "Quick Review",
       "description": "Lightweight review checking basic correctness and completeness",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "verification",
       "maxRetries": 2,
       "config": {
@@ -30,7 +32,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -38,7 +41,8 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit all changes with a descriptive message summarizing the work done",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {

package/catalog/workflows/context-gather.json

@@ -0,0 +1,105 @@
+{
+  "id": "context-gather",
+  "name": "Context Gather",
+  "description": "Toy workflow demonstrating fork/join. Fans out into three parallel information-gathering branches (system info, weather, repository), then synthesizes everything into a single summary.",
+  "nodes": {
+    "start": {
+      "type": "start",
+      "name": "Start",
+      "description": "Context gathering begins"
+    },
+    "fork_gather": {
+      "type": "fork",
+      "name": "Fork Gather",
+      "join": "join_gather",
+      "branches": {
+        "system": {
+          "entryStep": "system_info",
+          "description": "Gather system information"
+        },
+        "weather": {
+          "entryStep": "weather_info",
+          "description": "Get today's weather at current location"
+        },
+        "repo": {
+          "entryStep": "repo_info",
+          "description": "Get information about the current repository"
+        }
+      }
+    },
+    "system_info": {
+      "type": "task",
+      "name": "System Information",
+      "description": "Gather system information: OS, architecture, CPU, memory, disk, shell, environment. Run uname, hostname, and similar commands.",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
+      "stage": "investigation"
+    },
+    "weather_info": {
+      "type": "task",
+      "name": "Weather Report",
+      "description": "Get today's weather at the user's location. Use a web search or weather API to find current conditions, temperature, and forecast.",
+      "agent": "flow:Planner",
+      "emoji": "📋",
+      "stage": "investigation"
+    },
+    "repo_info": {
+      "type": "task",
+      "name": "Repository Information",
+      "description": "Gather information about the current git repository: remote URL, branch, recent commits, language breakdown, directory structure overview, and package metadata.",
+      "agent": "flow:Investigator",
+      "emoji": "🔍",
+      "stage": "investigation"
+    },
+    "repo_analyze": {
+      "type": "task",
+      "name": "Analyze Repository",
+      "description": "Analyze the repository structure and health: test coverage status, dependency freshness, code organization patterns, and any notable architectural decisions.",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
+      "stage": "investigation"
+    },
+    "join_gather": {
+      "type": "join",
+      "name": "Join Gather",
+      "fork": "fork_gather",
+      "strategy": "all-pass"
+    },
+    "summarize": {
+      "type": "task",
+      "name": "Summarize Context",
+      "description": "Combine findings from all three branches into a single context summary. Present system info, weather, and repo info in a clear, readable format.",
+      "agent": "flow:Architect",
+      "emoji": "🏛️",
+      "stage": "planning"
+    },
+    "end_success": {
+      "type": "end",
+      "result": "success",
+      "name": "Context Gathered",
+      "description": "All context gathered and summarized"
+    },
+    "hitl_failed": {
+      "type": "end",
+      "result": "blocked",
+      "escalation": "hitl",
+      "name": "Gather Failed",
+      "description": "One or more branches failed to gather information"
+    }
+  },
+  "edges": [
+    { "from": "start", "to": "fork_gather" },
+    { "from": "fork_gather", "to": "system_info", "label": "Branch: system" },
+    { "from": "fork_gather", "to": "weather_info", "label": "Branch: weather" },
+    { "from": "fork_gather", "to": "repo_info", "label": "Branch: repo" },
+    { "from": "system_info", "to": "join_gather" },
+    { "from": "weather_info", "to": "join_gather" },
+    { "from": "repo_info", "to": "repo_analyze", "on": "passed" },
+    { "from": "repo_info", "to": "join_gather", "on": "failed" },
+    { "from": "repo_analyze", "to": "join_gather" },
+    { "from": "join_gather", "to": "summarize", "on": "passed", "label": "All branches complete" },
+    { "from": "join_gather", "to": "hitl_failed", "on": "failed", "label": "One or more branches failed" },
+    { "from": "summarize", "to": "end_success" },
+    { "from": "hitl_failed", "to": "fork_gather", "on": "passed", "label": "Human resolved issue, retry" }
+  ]
+}

package/catalog/workflows/context-optimization.json

@@ -12,28 +12,32 @@
       "type": "task",
       "name": "Map Connections",
       "description": "Identify all connection points between components (MCP, skills, agents, subagents)",
-      "agent": "Context Engineer",
+      "agent": "flow:Context Engineer",
+      "emoji": "🧠",
       "stage": "analysis"
     },
     "identify_pathologies": {
       "type": "task",
       "name": "Identify Pathologies",
       "description": "Find context pathologies: specification bloat, attention dilution, redundant framing",
-      "agent": "Context Engineer",
+      "agent": "flow:Context Engineer",
+      "emoji": "🧠",
       "stage": "analysis"
     },
     "design_improvements": {
       "type": "task",
       "name": "Design Improvements",
       "description": "Apply compression techniques: lead with conclusions, causal chains, precise terminology",
-      "agent": "Context Engineer",
+      "agent": "flow:Context Engineer",
+      "emoji": "🧠",
       "stage": "design"
     },
     "review_design": {
       "type": "gate",
       "name": "Review Design",
       "description": "Verify improvements don't sacrifice meaning for brevity",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "design",
       "maxRetries": 2,
       "config": {
@@ -44,14 +48,16 @@
       "type": "task",
       "name": "Implement",
       "description": "Apply the optimizations to actual files and configurations",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "implementation"
     },
     "verify": {
       "type": "task",
       "name": "Verify",
       "description": "Test that agents still function correctly with optimized context",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "verification",
       "maxRetries": 2
     },

package/catalog/workflows/execute.json

@@ -0,0 +1,30 @@
+{
+  "id": "execute",
+  "name": "Execute",
+  "description": "Single-step workflow. Just do the thing.",
+  "nodes": {
+    "start": {
+      "type": "start",
+      "name": "Start",
+      "description": "Execute begins"
+    },
+    "execute": {
+      "type": "task",
+      "name": "Execute",
+      "description": "Do the work described in the task.",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
+      "stage": "development"
+    },
+    "end_success": {
+      "type": "end",
+      "result": "success",
+      "name": "Done",
+      "description": "Task completed"
+    }
+  },
+  "edges": [
+    { "from": "start", "to": "execute" },
+    { "from": "execute", "to": "end_success" }
+  ]
+}

package/catalog/workflows/feature-development.json

@@ -12,28 +12,32 @@
       "type": "task",
       "name": "Parse Requirements",
       "description": "Extract acceptance criteria and requirements from the issue or request",
-      "agent": "Planner",
+      "agent": "flow:Planner",
+      "emoji": "📋",
       "stage": "planning"
     },
     "explore_codebase": {
       "type": "task",
       "name": "Explore Codebase",
       "description": "Find relevant files, understand patterns, identify where changes are needed",
-      "agent": "Planner",
+      "agent": "flow:Planner",
+      "emoji": "📋",
       "stage": "planning"
     },
     "create_plan": {
       "type": "task",
       "name": "Create Plan",
       "description": "Write implementation plan with specific files and changes needed",
-      "agent": "Planner",
+      "agent": "flow:Planner",
+      "emoji": "📋",
       "stage": "planning"
     },
     "plan_review": {
       "type": "gate",
       "name": "Review Plan",
       "description": "Verify plan is complete and feasible",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "planning",
       "maxRetries": 2,
       "config": {
@@ -44,21 +48,24 @@
       "type": "task",
       "name": "Implement",
       "description": "Write the code following the plan",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "write_tests": {
       "type": "task",
       "name": "Write Tests",
       "description": "Add unit and integration tests for the new feature",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "development"
     },
     "run_tests": {
       "type": "task",
       "name": "Run Tests",
       "description": "Execute test suite and verify all tests pass",
-      "agent": "Tester",
+      "agent": "flow:Tester",
+      "emoji": "🧪",
       "stage": "verification",
       "maxRetries": 3
     },
@@ -66,7 +73,8 @@
       "type": "gate",
       "name": "Code Review",
       "description": "Review code quality, patterns, and correctness",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "verification",
       "maxRetries": 2,
       "config": {
@@ -77,7 +85,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -85,14 +94,16 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit all changes with a descriptive message summarizing the work done",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "create_pr": {
       "type": "task",
       "name": "Create PR",
       "description": "Create pull request with summary and test plan",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {

package/catalog/workflows/hitl-test.json

@@ -11,14 +11,16 @@
       "type": "task",
       "name": "Do Work",
       "description": "Do the thing",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "check": {
       "type": "gate",
       "name": "Check",
       "description": "Pass or fail",
-      "agent": "Reviewer",
+      "agent": "flow:Reviewer",
+      "emoji": "👀",
       "stage": "verification",
       "maxRetries": 1
     },

package/catalog/workflows/quick-task.json

@@ -12,21 +12,24 @@
       "type": "task",
       "name": "Understand",
       "description": "Clarify what needs to be done and identify the approach",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "planning"
     },
     "execute": {
       "type": "task",
       "name": "Execute",
       "description": "Make the changes or complete the work",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "development"
     },
     "verify": {
       "type": "task",
       "name": "Verify",
       "description": "Confirm the work is correct and complete",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "verification",
       "maxRetries": 1
     },
@@ -34,7 +37,8 @@
       "type": "gate",
       "name": "Lint & Format",
       "description": "Run lint and format checks. Auto-fix issues where possible.",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery",
       "maxRetries": 3
     },
@@ -42,7 +46,8 @@
       "type": "task",
       "name": "Commit Changes",
       "description": "Commit all changes with a descriptive message",
-      "agent": "Developer",
+      "agent": "flow:Developer",
+      "emoji": "🔧",
       "stage": "delivery"
     },
     "end_success": {