cmp-standards 2.0.0

package/templates/hooks/settings.local.json.template

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.json",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory session-context"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory pre-tool-guard"
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory inject-knowledge"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx cmp-memory checkpoint"
+          }
+        ]
+      }
+    ]
+  },
+  "allowedTools": [
+    "Read",
+    "Glob",
+    "Grep",
+    "WebSearch",
+    "WebFetch"
+  ],
+  "denyTools": [],
+  "contextWindow": 200000,
+  "model": "opus"
+}

package/templates/memory-config.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "./memory-config.schema.json",
+  "system": "SWARMSCALE",
+  "projectName": "SwarmScale",
+  "description": "AI-powered marketing agency platform",
+  "domains": [
+    "video-studio",
+    "avatars",
+    "content-ideas",
+    "campaigns",
+    "knowledge-base",
+    "social-media",
+    "ai-services",
+    "infrastructure"
+  ],
+  "guards": {
+    "enabled": true,
+    "rules": [
+      {
+        "id": "schema-protection",
+        "type": "block",
+        "filePattern": "src/server/schema/auth.ts",
+        "contentTrigger": ".*",
+        "message": "PANEL_* tables are READ-ONLY. Do not modify auth.ts.",
+        "allowOverride": false
+      },
+      {
+        "id": "dev-items-filter",
+        "type": "warn",
+        "filePattern": "**/*.ts",
+        "contentTrigger": "from\\(devItems\\)(?!.*\\.where.*system)",
+        "message": "Always filter DEV_Items by system='SWARMSCALE'",
+        "allowOverride": true
+      },
+      {
+        "id": "marketing-tables-only",
+        "type": "warn",
+        "filePattern": "src/server/schema/*.ts",
+        "contentTrigger": "mysqlTable\\(['\"](?!MARKETING_)",
+        "excludeFiles": ["marketing.ts", "dev.ts", "index.ts"],
+        "message": "SwarmScale only owns MARKETING_* tables",
+        "allowOverride": true
+      }
+    ]
+  },
+  "embedding": {
+    "enabled": true,
+    "threshold": 0.60,
+    "maxSections": 3,
+    "prioritizeCritical": true,
+    "providers": ["openai", "gemini"]
+  },
+  "checkpoint": {
+    "enabled": true,
+    "minLinesChanged": 20,
+    "criticalPaths": [
+      "src/server/schema/**",
+      "src/server/api/routers/**"
+    ],
+    "excludePaths": [
+      "**/*.test.ts",
+      "**/*.spec.ts",
+      "**/*.d.ts",
+      "**/node_modules/**"
+    ],
+    "autoTagging": true,
+    "patternDetection": true
+  },
+  "autoImprovement": {
+    "enabled": true,
+    "violationThreshold": 3,
+    "generateEslintRules": true,
+    "createMemoryEntries": true,
+    "updateClaudeMd": false
+  },
+  "sessionContext": {
+    "loadMemoriesOnStart": true,
+    "maxMemoriesLoaded": 5,
+    "cacheTimeout": 3600,
+    "showAvailableCommands": true
+  }
+}

package/templates/memory-config.schema.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MetaNautical Memory Configuration",
+  "description": "Configuration schema for the MetaNautical Memory Plugin",
+  "type": "object",
+  "required": ["system", "domains"],
+  "properties": {
+    "system": {
+      "type": "string",
+      "description": "System identifier for data isolation (e.g., SWARMSCALE, PANEL)",
+      "enum": ["SWARMSCALE", "PANEL", "ECOSYSTEM", "ELLIOT", "CONNECTA_HOTEL", "CONNECTA_CREW", "EASYCHARTER", "EASYYACHTS", "GMB", "CLIENT"]
+    },
+    "projectName": {
+      "type": "string",
+      "description": "Human-readable project name"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief project description"
+    },
+    "domains": {
+      "type": "array",
+      "description": "List of domain/module identifiers for this project",
+      "items": {
+        "type": "string"
+      }
+    },
+    "guards": {
+      "type": "object",
+      "description": "Pre-tool guard configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "type", "filePattern", "message"],
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique rule identifier"
+              },
+              "type": {
+                "type": "string",
+                "enum": ["block", "warn", "suggest"],
+                "description": "Action type: block stops operation, warn allows with message, suggest shows optional advice"
+              },
+              "filePattern": {
+                "type": "string",
+                "description": "Glob pattern for matching files"
+              },
+              "contentTrigger": {
+                "type": "string",
+                "description": "Regex pattern for matching content"
+              },
+              "excludeFiles": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Files to exclude from this rule"
+              },
+              "message": {
+                "type": "string",
+                "description": "Message to display when rule triggers"
+              },
+              "allowOverride": {
+                "type": "boolean",
+                "default": false,
+                "description": "Whether @guard-ignore comment can bypass this rule"
+              }
+            }
+          }
+        }
+      }
+    },
+    "embedding": {
+      "type": "object",
+      "description": "Embedding-based progressive disclosure configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "threshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.60,
+          "description": "Minimum similarity threshold for section matching"
+        },
+        "maxSections": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 3,
+          "description": "Maximum number of sections to inject"
+        },
+        "prioritizeCritical": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether to prioritize CRITICAL sections over similarity"
+        },
+        "providers": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["openai", "gemini"]
+          },
+          "description": "Embedding providers in order of preference"
+        }
+      }
+    },
+    "checkpoint": {
+      "type": "object",
+      "description": "Memory checkpoint configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "minLinesChanged": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 20,
+          "description": "Minimum lines changed to trigger checkpoint"
+        },
+        "criticalPaths": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns for critical paths that always trigger checkpoint"
+        },
+        "excludePaths": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns for paths to exclude from checkpoints"
+        },
+        "autoTagging": {
+          "type": "boolean",
+          "default": true,
+          "description": "Automatically tag checkpoints based on content"
+        },
+        "patternDetection": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable pattern detection for auto-improvement"
+        }
+      }
+    },
+    "autoImprovement": {
+      "type": "object",
+      "description": "Auto-improvement system configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "violationThreshold": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 3,
+          "description": "Number of violations before auto-improvement triggers"
+        },
+        "generateEslintRules": {
+          "type": "boolean",
+          "default": true,
+          "description": "Automatically generate ESLint rules for repeated violations"
+        },
+        "createMemoryEntries": {
+          "type": "boolean",
+          "default": true,
+          "description": "Create memory entries for patterns"
+        },
+        "updateClaudeMd": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically update CLAUDE.md with new rules"
+        }
+      }
+    },
+    "sessionContext": {
+      "type": "object",
+      "description": "Session start context configuration",
+      "properties": {
+        "loadMemoriesOnStart": {
+          "type": "boolean",
+          "default": true,
+          "description": "Load relevant memories at session start"
+        },
+        "maxMemoriesLoaded": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 20,
+          "default": 5,
+          "description": "Maximum memories to load per session"
+        },
+        "cacheTimeout": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 3600,
+          "description": "Cache timeout in seconds"
+        },
+        "showAvailableCommands": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show available commands at session start"
+        }
+      }
+    }
+  }
+}

package/templates/settings.json

@@ -0,0 +1,58 @@
+{
+  "$comment": "Template settings.json for MetaNautical Memory Plugin",
+  "claudeMdPath": "CLAUDE.md",
+  "mcpConfigPath": ".claude/mcp-minimal.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx tsx .claude/hooks/pre-tool-use-embedding.ts"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "file://.claude/hooks/pre-tool-use-guards.md"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "file://.claude/hooks/pre-tool-use-guards.md"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "file://.claude/hooks/session-start-context-loader.md"
+          }
+        ]
+      }
+    ]
+  },
+  "plugins": {
+    "metanautical-memory": {
+      "version": "1.0.0",
+      "enabled": true,
+      "configPath": ".claude/memory-config.json"
+    },
+    "claude-mem": {
+      "autoSync": true,
+      "syncOnSessionStart": true
+    }
+  }
+}

package/templates/workflows/business-improvement.md

@@ -0,0 +1,264 @@
+---
+description: "/business-improvement - Self-improving research system that enhances business documents through web research"
+---
+
+# /business-improvement - Self-Improving Research System
+
+> **Purpose**: Continuously improve business knowledge base through iterative web research
+> **Philosophy**: Research -> Learn -> Document -> Generate Follow-ups -> Repeat
+
+---
+
+## Overview
+
+The `/business-improvement` command is a **self-improving research engine** that:
+
+1. **Researches** - Executes web searches on business/marketing topics
+2. **Learns** - Extracts key insights and facts from results
+3. **Documents** - Updates or creates files with new knowledge
+4. **Generates** - Produces derived queries for next research cycle
+5. **Tracks** - Logs every search, learning, and improvement for meta-analysis
+
+---
+
+## Execution Protocol
+
+### Phase 1: Pre-Research Analysis
+
+1. **Review current knowledge state**
+   - Check existing business documentation
+   - Identify knowledge gaps and stale content
+
+2. **Identify improvement opportunities**
+   - Review documents for incomplete sections
+   - Check dates of last updates (stale content = improvement opportunity)
+   - Identify documents with completeness < 80%
+
+3. **Select focus area** based on priority:
+   | Priority | Topic Area | Documents |
+   |:---|:---|:---|
+   | HIGH | Strategic | Business Plan, SWOT, Value Proposition |
+   | MEDIUM | Market Intel | Competitor Analysis, Market Trends |
+   | LOW | Campaign | Content Pillars, Messaging Framework |
+
+---
+
+### Phase 2: Research Execution
+
+4. **Initial Research Query**
+   - Start with a focused, specific query related to the focus area
+   - Example: `"[industry] management software trends [year]"`
+
+5. **Execute web search**
+   - Use WebSearch tool with focused query
+   - Capture top 5-7 results
+
+6. **Extract Knowledge**
+   For each search result, extract:
+   ```json
+   {
+     "query": "original search query",
+     "source": "URL of the source",
+     "learnings": [
+       "Key fact or insight 1",
+       "Key fact or insight 2"
+     ],
+     "confidence": 85,
+     "derivedQueries": [
+       "Follow-up query based on learning 1",
+       "Follow-up query based on learning 2"
+     ]
+   }
+   ```
+
+7. **Log to Research Tracker**
+   - Track: Query -> Results -> Learnings -> Follow-ups
+
+---
+
+### Phase 3: Knowledge Integration
+
+8. **Update existing documents** (PREFERRED)
+   - If learning fits existing document section -> enhance it
+   - Add new data points, statistics, competitor info
+   - Update timestamps
+
+9. **Create new section** (if appropriate)
+   - Only if learning reveals entirely new topic area
+   - Must be extremely relevant to the business
+
+10. **Format documents beautifully**
+    - Use structured markdown for visual appeal
+    - Include tables for comparative data
+    - Use H1/H2/H3, lists, quotes
+    - Add emojis sparingly for scanability
+
+---
+
+### Phase 4: Session Documentation
+
+11. **Create Research Session Report**
+    ```json
+    {
+      "sessionId": "ULID",
+      "date": "YYYY-MM-DD",
+      "topic": "Research Focus Area",
+      "queriesExecuted": 5,
+      "learningsAcquired": 12,
+      "documentsUpdated": ["value_proposition", "swot"],
+      "derivedQueriesPending": [
+        "Follow-up query 1",
+        "Follow-up query 2"
+      ],
+      "nextSessionPriority": "HIGH"
+    }
+    ```
+
+12. **Update task tracker**
+    - Mark improvements in task list
+    - Add new items for pending derived queries
+
+---
+
+## Research Query Framework
+
+### Query Templates by Topic
+
+**Competitor Analysis:**
+- `"[Competitor] pricing [year]"`
+- `"[Competitor] features comparison"`
+- `"[Competitor] customer reviews [year]"`
+
+**Market Trends:**
+- `"[industry] market size [year]"`
+- `"[industry] software trends"`
+- `"B2B SaaS [industry]"`
+
+**Audience Research:**
+- `"[target audience] pain points"`
+- `"[industry] software needs"`
+- `"[user type] app features"`
+
+**Product Positioning:**
+- `"all-in-one [industry] management"`
+- `"[product type] software comparison"`
+- `"[industry] operations automation"`
+
+---
+
+## Expert Review Integration
+
+After completing research, invoke `/experts` for validation:
+
+- **Security Expert**: No sensitive data exposed
+- **Architecture Expert**: Document structure valid
+- **UX Expert**: Content follows brand voice
+- **Memory Expert**: Patterns detected, auto-improvements triggered
+
+---
+
+## Document Quality Standards
+
+### Visual Format Requirements
+
+Every document must have:
+- Clear H1 title
+- Executive summary (2-3 sentences)
+- Structured sections with H2/H3
+- Tables for comparative data
+- Bullet lists for quick scanning
+- Timestamps (created/updated)
+- Source citations where applicable
+
+### Content Quality Checks
+- No placeholder text ("lorem ipsum", "TBD")
+- No outdated data (> 6 months old)
+- No unsupported claims
+- Specific numbers and dates
+- Competitor names and products
+- Actionable insights
+
+---
+
+## Example Session Output
+
+```
+## Business Improvement Session
+
+Date: YYYY-MM-DD
+Focus: Competitor Pricing Update
+
+### Queries Executed
+1. "[Competitor A] pricing model [year]" -> 3 learnings
+2. "[Competitor B] subscription tiers" -> 2 learnings
+3. "[Competitor A] vs [Competitor B]" -> 4 learnings
+
+### Knowledge Acquired
+- Competitor A uses flat monthly fee (no commission)
+- Competitor B: $99-499/month based on usage
+- Competitor C: Legacy pricing, higher cost
+- Market trend: Moving away from per-transaction %
+
+### Documents Updated
+- Value Proposition Canvas - Added competitive pricing section
+- SWOT Analysis - Updated threats with pricing pressure
+
+### Derived Queries (Next Session)
+- "[Competitor A] API capabilities"
+- "[Industry] software free trial comparison"
+- "[Market segment] market share [year]"
+
+### Session Score: 4/5
+Learnings: 9 | Documents: 2 | Next queries: 3
+```
+
+---
+
+## Automation Hooks
+
+### Recommended Schedule
+- **Weekly**: Run basic improvement cycle (1 focus area)
+- **Monthly**: Deep dive on all priority areas
+- **Quarterly**: Full competitive landscape refresh
+
+### Integration with CLI
+```bash
+# Future enhancement
+cmp-memory improve --topic "competitors"
+cmp-memory improve --pending  # Process derived queries
+cmp-memory improve --status   # Show improvement metrics
+```
+
+---
+
+## Success Metrics
+
+The system is working correctly if:
+
+- **Query coverage** - All topic areas researched quarterly
+- **Learning rate** - 5+ new insights per session
+- **Document freshness** - No content older than 3 months
+- **Derived query backlog** - Always have next topics ready
+- **Pattern detection** - Memory Expert finds recurring themes
+
+---
+
+## When to Use /business-improvement
+
+### Use When:
+- Need to update market intelligence
+- Competitor released new features/pricing
+- Preparing for investor/client presentations
+- Monthly knowledge refresh cycle
+- After major product launch by competitor
+
+### Don't Use For:
+- Quick fact-checking (use direct web search)
+- Creating new documents from scratch (use `/experts implement`)
+- Trivial content updates (edit directly)
+
+---
+
+The `/business-improvement` command transforms your business knowledge base into a **living, self-improving system**. Each research session makes the next one more targeted through derived queries.
+
+**Pro tip**: Run `/business-improvement` weekly on rotating topics to maintain fresh, competitive intelligence.