@metabob/minibob 0.1.2

package/templates/understanding/diagnose-problem.json

@@ -0,0 +1,32 @@
+{
+  "id": "diagnose-problem-v1",
+  "name": "Diagnose Application Problem",
+  "description": "Root cause analysis for application issues",
+  "category": "tool",
+  "variables": [],
+  "tasks": [
+    {
+      "id": "analyze_problem",
+      "description": "Analyze the problem and identify root cause",
+      "prompt": {
+        "template": "Problem reported:\n{{problem}}\n\nRelevant files to examine:\n{{files}}\n\nPerform comprehensive root cause analysis and provide your findings in the following JSON format:\n\n```json\n{\n  \"symptoms\": [\n    \"<observable symptom 1>\",\n    \"<observable symptom 2>\"\n  ],\n  \"rootCause\": \"<detailed explanation of the underlying cause>\",\n  \"affectedFiles\": [\n    \"<file 1 that needs changes>\",\n    \"<file 2 that needs changes>\"\n  ],\n  \"recommendedFix\": \"<step-by-step fix recommendations>\",\n  \"validationSteps\": [\n    \"<how to verify fix works step 1>\",\n    \"<how to verify fix works step 2>\"\n  ],\n  \"confidence\": \"<low|medium|high>\"\n}\n```\n\nBase your analysis on:\n1. The problem description\n2. Code patterns you can infer from the file names\n3. Common causes of similar issues\n4. Best practices for the technology stack\n\nProvide specific, actionable recommendations.",
+        "variables": [
+          {
+            "name": "problem",
+            "type": "string",
+            "source": "variable"
+          },
+          {
+            "name": "files",
+            "type": "string",
+            "source": "variable"
+          }
+        ]
+      },
+      "validation": {
+        "requireOutput": true,
+        "requiredPatterns": ["rootCause", "recommendedFix"]
+      }
+    }
+  ]
+}

package/templates/understanding/explore-codebase-v2.json

@@ -0,0 +1,57 @@
+{
+  "activity_id": "explore-codebase-v2",
+  "variant_name": "Explore Codebase Structure v2 - Simplified & Modular",
+  "variant_id": "explore-codebase-v2",
+  "description": "Improved modular codebase analysis with flexible validation and graceful degradation",
+  "category": "tool",
+  "scope": "global",
+  "task_steps": [
+    {
+      "id": "scan-directory-structure",
+      "description": "Scan and understand basic directory structure",
+      "dependencies": [],
+      "subagent": "general-purpose",
+      "prompt": {
+        "template": "Analyze the directory structure of the current codebase. Use the 'list' tool to explore key directories and provide a simple overview.\\n\\nStart by listing the root directory, then explore important subdirectories like src/, lib/, components/, etc.\\n\\nProvide your findings in this simple format:\\n\\nDirectory Structure Overview:\\n- Root files: [list key files]\\n- Key directories: [list important directories]\\n- Project type: [best guess of project type]\\n- Language(s): [detected languages]\\n\\nKeep it concise and factual.",
+        "variables": [],
+        "maxTokens": 4000
+      },
+      "retry": {
+        "maxAttempts": 2,
+        "strategy": "simple"
+      }
+    },
+    {
+      "id": "identify-entry-points",
+      "description": "Find main entry points and configuration files",
+      "dependencies": ["scan-directory-structure"],
+      "subagent": "general-purpose",
+      "prompt": {
+        "template": "Based on the directory structure analysis, identify the main entry points of this codebase.\\n\\nLook for files like:\\n- package.json, bun.json, deno.json (for dependency info)\\n- index.js/ts, main.js/ts, app.js/ts (for entry points)\\n- README.md (for project info)\\n- tsconfig.json, webpack.config.js (for build config)\\n\\nUse the 'read' tool to examine these files (first 50 lines each to stay within token limits).\\n\\nProvide a simple summary:\\n\\nEntry Points Found:\\n- Main executable: [file]\\n- Package manager: [npm/bun/deno/etc]\\n- Key dependencies: [list 3-5 important ones]\\n- Runtime: [Node.js/Bun/Deno/Browser]\\n\\nFocus on facts, not detailed analysis.",
+        "variables": [],
+        "maxTokens": 6000
+      },
+      "retry": {
+        "maxAttempts": 2,
+        "strategy": "simple"
+      }
+    },
+    {
+      "id": "analyze-architecture",
+      "description": "Provide high-level architectural assessment",
+      "dependencies": ["scan-directory-structure", "identify-entry-points"],
+      "subagent": "general-purpose",
+      "prompt": {
+        "template": "Based on the previous analysis, provide a high-level architectural assessment of this codebase.\\n\\nSummarize your findings:\\n\\nArchitecture Summary:\\n- Project type: [web app/CLI tool/library/service/etc]\\n- Architecture pattern: [MVC/microservice/monolith/SPA/etc or 'mixed/unclear']\\n- Key components: [list 3-5 main components]\\n- Tech stack: [runtime + major frameworks/libraries]\\n\\nData Flow (if observable):\\n- Input: [how data enters the system]\\n- Processing: [main processing components]\\n- Output: [how results are delivered]\\n\\nDependencies:\\n- External: [3-5 key external dependencies]\\n- Internal: [major internal modules if visible]\\n\\nKeep this high-level and practical. If something is unclear, say 'unclear' rather than guessing.",
+        "variables": [],
+        "maxTokens": 4000
+      },
+      "retry": {
+        "maxAttempts": 2,
+        "strategy": "simple"
+      }
+    }
+  ],
+  "updated_at": "2026-03-23T10:00:00.000000000Z",
+  "created_at": "2026-03-23T10:00:00.000000000Z"
+}

package/templates/understanding/explore-codebase.json

@@ -0,0 +1,37 @@
+{
+  "id": "explore-codebase-v1",
+  "name": "Explore Codebase Structure",
+  "description": "Analyze codebase structure, identify entry points, and map dependencies",
+  "category": "tool",
+  "variables": [],
+  "tasks": [
+    {
+      "id": "analyze_structure",
+      "description": "Analyze the codebase structure and provide comprehensive understanding",
+      "prompt": {
+        "template": "You are analyzing a codebase with the following structure:\n\n```json\n{{structure}}\n```\n\nAnalysis Focus: {{focus}}\nDepth: {{depth}}\n\nProvide a comprehensive analysis in the following JSON format:\n\n```json\n{\n  \"architecture\": {\n    \"pattern\": \"<architecture pattern name (e.g., MVC, microservices, SPA, monolith)>\",\n    \"description\": \"<detailed description of the architecture>\",\n    \"layers\": [\"<list of architectural layers>\"]\n  },\n  \"components\": {\n    \"summary\": \"<overview of key components>\",\n    \"keyModules\": [\n      {\n        \"name\": \"<module name>\",\n        \"purpose\": \"<what this module does>\",\n        \"files\": [\"<related files>\"]\n      }\n    ]\n  },\n  \"dataFlow\": {\n    \"description\": \"<how data flows through the application>\",\n    \"flows\": [\n      {\n        \"source\": \"<data source>\",\n        \"destination\": \"<data destination>\",\n        \"dataType\": \"<type of data>\"\n      }\n    ]\n  },\n  \"entryPoints\": {\n    \"main\": [\"<main entry points>\"],\n    \"server\": \"<server entry if applicable>\",\n    \"client\": \"<client entry if applicable>\",\n    \"cli\": \"<CLI entry if applicable>\"\n  },\n  \"dependencies\": {\n    \"external\": [\n      {\n        \"name\": \"<dependency name>\",\n        \"version\": \"<version>\",\n        \"purpose\": \"<why it's used>\"\n      }\n    ],\n    \"internal\": [\n      {\n        \"module\": \"<internal module>\",\n        \"dependsOn\": [\"<other modules it depends on>\"]\n      }\n    ]\n  },\n  \"techStack\": {\n    \"runtime\": \"<runtime environment (Bun, Node.js, Deno, etc.)>\",\n    \"framework\": [\"<frameworks used>\"],\n    \"language\": [\"<languages used>\"],\n    \"tools\": [\"<build tools, testing tools, etc.>\"]\n  }\n}\n```\n\nBe thorough and specific. Use the structure data to inform your analysis.",
+        "variables": [
+          {
+            "name": "structure",
+            "type": "string",
+            "source": "variable"
+          },
+          {
+            "name": "focus",
+            "type": "string",
+            "source": "variable"
+          },
+          {
+            "name": "depth",
+            "type": "string",
+            "source": "variable"
+          }
+        ]
+      },
+      "validation": {
+        "requireOutput": true,
+        "requiredPatterns": ["architecture", "components", "dataFlow"]
+      }
+    }
+  ]
+}