sinapse-ai 7.1.0 → 7.3.0

package/squads/claude-code-mastery/data/mcp-integration-catalog.yaml

@@ -0,0 +1,323 @@
+# MCP Integration Catalog — Recommended Servers by Use Case
+# Squad: claude-code-mastery
+# Last updated: 2026-03-02
+
+version: "1.0.0"
+
+# MCP (Model Context Protocol) servers extend Claude Code with external capabilities.
+# This catalog organizes servers by use case with installation and cost estimates.
+
+categories:
+
+  # ---------------------------------------------------------------------------
+  # DEVELOPMENT — Core dev workflow tools
+  # ---------------------------------------------------------------------------
+  development:
+    description: "Core development workflow tools"
+    servers:
+      - name: filesystem
+        package: "@modelcontextprotocol/server-filesystem"
+        transport: stdio
+        context_cost_estimate: low
+        install_command: "npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir"
+        use_cases:
+          - "Read/write files in sandboxed directories"
+          - "List directory contents"
+          - "Search files by pattern"
+        config_example: |
+          {
+            "mcpServers": {
+              "filesystem": {
+                "command": "npx",
+                "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
+              }
+            }
+          }
+        notes: "Redundant with native Read/Write/Glob tools in Claude Code. Use only for sandboxed access."
+
+      - name: git
+        package: "@modelcontextprotocol/server-git"
+        transport: stdio
+        context_cost_estimate: low
+        install_command: "npx -y @modelcontextprotocol/server-git"
+        use_cases:
+          - "Git operations (status, diff, log, commit)"
+          - "Branch management"
+          - "Blame and history analysis"
+        notes: "Native Bash tool with git CLI is usually sufficient."
+
+      - name: docker
+        package: "@modelcontextprotocol/server-docker"
+        transport: stdio
+        context_cost_estimate: low
+        install_command: "npx -y @modelcontextprotocol/server-docker"
+        use_cases:
+          - "Container management (start, stop, list)"
+          - "Image management"
+          - "Docker Compose operations"
+
+      - name: github
+        package: "@modelcontextprotocol/server-github"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @modelcontextprotocol/server-github"
+        use_cases:
+          - "PR management (create, review, merge)"
+          - "Issue tracking"
+          - "Repository operations"
+          - "Code search across repos"
+        env_vars:
+          - GITHUB_PERSONAL_ACCESS_TOKEN
+        notes: "Alternative to gh CLI. Provides structured API access."
+
+  # ---------------------------------------------------------------------------
+  # RESEARCH — Information gathering and documentation
+  # ---------------------------------------------------------------------------
+  research:
+    description: "Information gathering and documentation lookup"
+    servers:
+      - name: exa
+        package: "exa-mcp-server"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y exa-mcp-server"
+        use_cases:
+          - "Web search with AI-optimized results"
+          - "Research and competitive analysis"
+          - "Finding code examples and documentation"
+          - "Current events and news"
+        env_vars:
+          - EXA_API_KEY
+        config_example: |
+          {
+            "mcpServers": {
+              "exa": {
+                "command": "npx",
+                "args": ["-y", "exa-mcp-server"],
+                "env": { "EXA_API_KEY": "your-key-here" }
+              }
+            }
+          }
+
+      - name: context7
+        package: "@upstash/context7-mcp"
+        transport: stdio
+        context_cost_estimate: low
+        install_command: "npx -y @upstash/context7-mcp"
+        use_cases:
+          - "Library documentation lookup (React, Next.js, etc.)"
+          - "API reference for any npm/pip package"
+          - "Up-to-date docs without web search"
+        config_example: |
+          {
+            "mcpServers": {
+              "context7": {
+                "command": "npx",
+                "args": ["-y", "@upstash/context7-mcp"]
+              }
+            }
+          }
+        notes: "No API key required. Free tier available."
+
+      - name: web-search
+        package: "@anthropic-ai/web-search-mcp"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @anthropic-ai/web-search-mcp"
+        use_cases:
+          - "General web search"
+          - "Real-time information lookup"
+
+  # ---------------------------------------------------------------------------
+  # COMMUNICATION — Team notifications and messaging
+  # ---------------------------------------------------------------------------
+  communication:
+    description: "Team communication and notification tools"
+    servers:
+      - name: slack
+        package: "@modelcontextprotocol/server-slack"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @modelcontextprotocol/server-slack"
+        use_cases:
+          - "Send messages to Slack channels"
+          - "Read channel history for context"
+          - "Post build/deploy notifications"
+          - "Team standup automation"
+        env_vars:
+          - SLACK_BOT_TOKEN
+          - SLACK_TEAM_ID
+
+      - name: email
+        package: "mcp-server-email"
+        transport: stdio
+        context_cost_estimate: low
+        install_command: "npx -y mcp-server-email"
+        use_cases:
+          - "Send email notifications"
+          - "Read emails for context"
+          - "Draft email responses"
+        env_vars:
+          - EMAIL_SMTP_HOST
+          - EMAIL_SMTP_USER
+          - EMAIL_SMTP_PASS
+
+  # ---------------------------------------------------------------------------
+  # DATABASE — Data storage and query
+  # ---------------------------------------------------------------------------
+  database:
+    description: "Database access and management"
+    servers:
+      - name: supabase
+        package: "@supabase/mcp-server-supabase"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @supabase/mcp-server-supabase"
+        use_cases:
+          - "Database queries and mutations"
+          - "Schema inspection"
+          - "Migration management"
+          - "RLS policy management"
+          - "Edge function deployment"
+        env_vars:
+          - SUPABASE_ACCESS_TOKEN
+        config_example: |
+          {
+            "mcpServers": {
+              "supabase": {
+                "command": "npx",
+                "args": ["-y", "@supabase/mcp-server-supabase", "--access-token", "your-token"]
+              }
+            }
+          }
+
+      - name: postgres
+        package: "@modelcontextprotocol/server-postgres"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @modelcontextprotocol/server-postgres"
+        use_cases:
+          - "Direct PostgreSQL queries"
+          - "Schema inspection and analysis"
+          - "Data exploration"
+        env_vars:
+          - POSTGRES_CONNECTION_STRING
+
+      - name: sqlite
+        package: "@modelcontextprotocol/server-sqlite"
+        transport: stdio
+        context_cost_estimate: low
+        install_command: "npx -y @modelcontextprotocol/server-sqlite"
+        use_cases:
+          - "Local SQLite database queries"
+          - "Embedded database development"
+          - "Prototyping data models"
+
+  # ---------------------------------------------------------------------------
+  # BROWSER — Web automation and testing
+  # ---------------------------------------------------------------------------
+  browser:
+    description: "Browser automation, testing, and web interaction"
+    servers:
+      - name: playwright
+        package: "@anthropic-ai/mcp-server-playwright"
+        transport: stdio
+        context_cost_estimate: high
+        install_command: "npx -y @anthropic-ai/mcp-server-playwright"
+        use_cases:
+          - "Browser automation and testing"
+          - "Screenshot capture for visual verification"
+          - "Form filling and interaction testing"
+          - "Console log inspection"
+          - "E2E test execution"
+        notes: "High context cost due to DOM snapshots. Use judiciously."
+        config_example: |
+          {
+            "mcpServers": {
+              "playwright": {
+                "command": "npx",
+                "args": ["-y", "@anthropic-ai/mcp-server-playwright"]
+              }
+            }
+          }
+
+      - name: puppeteer
+        package: "@anthropic-ai/mcp-server-puppeteer"
+        transport: stdio
+        context_cost_estimate: high
+        install_command: "npx -y @anthropic-ai/mcp-server-puppeteer"
+        use_cases:
+          - "Headless browser automation"
+          - "PDF generation"
+          - "Screenshot capture"
+        notes: "Playwright is generally preferred over Puppeteer for new projects."
+
+  # ---------------------------------------------------------------------------
+  # DESIGN — UI/UX tools
+  # ---------------------------------------------------------------------------
+  design:
+    description: "Design and UI/UX tools"
+    servers:
+      - name: 21st-dev-magic
+        package: "@21st-dev/magic-mcp"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @21st-dev/magic-mcp"
+        use_cases:
+          - "Generate UI components from descriptions"
+          - "Design system integration"
+          - "Component library search"
+        env_vars:
+          - TWENTY_FIRST_API_KEY
+
+      - name: figma
+        package: "figma-mcp-server"
+        transport: stdio
+        context_cost_estimate: high
+        install_command: "npx -y figma-mcp-server"
+        use_cases:
+          - "Extract design tokens from Figma files"
+          - "Read component specifications"
+          - "Design-to-code translation"
+        env_vars:
+          - FIGMA_ACCESS_TOKEN
+
+  # ---------------------------------------------------------------------------
+  # MONITORING — Observability and error tracking
+  # ---------------------------------------------------------------------------
+  monitoring:
+    description: "Application monitoring and error tracking"
+    servers:
+      - name: sentry
+        package: "@sentry/mcp-server"
+        transport: stdio
+        context_cost_estimate: medium
+        install_command: "npx -y @sentry/mcp-server"
+        use_cases:
+          - "Query error events and stack traces"
+          - "Analyze error frequency and impact"
+          - "Debug production issues with context"
+        env_vars:
+          - SENTRY_AUTH_TOKEN
+
+# ---------------------------------------------------------------------------
+# TRANSPORT SELECTION GUIDE
+# ---------------------------------------------------------------------------
+transport_guide:
+  stdio:
+    description: "Local process communication via stdin/stdout"
+    when_to_use: "Local servers, npm packages, most common"
+    pros: ["Simple setup", "No network overhead", "Works offline"]
+    cons: ["Cannot share across machines", "Process lifecycle management"]
+
+  http_streamable:
+    description: "HTTP-based communication (newer protocol)"
+    when_to_use: "Remote servers, cloud-hosted services, team-shared servers"
+    pros: ["Shareable", "Language agnostic", "Stateless"]
+    cons: ["Network latency", "Requires running server"]
+
+  sse:
+    description: "Server-Sent Events (legacy)"
+    when_to_use: "Legacy servers not yet migrated to HTTP Streamable"
+    pros: ["Wide support"]
+    cons: ["Being deprecated", "One-directional streaming"]

package/squads/claude-code-mastery/data/project-type-signatures.yaml

@@ -0,0 +1,335 @@
+# Project Type Signatures — Detection & Configuration Recommendations
+# Squad: claude-code-mastery
+# Last updated: 2026-03-02
+
+version: "1.0.0"
+
+# Each project type defines detection signals and recommended Claude Code configuration.
+# Used by config-engineer and project-integrator agents to bootstrap projects.
+
+project_types:
+
+  # ---------------------------------------------------------------------------
+  monorepo:
+    display_name: "Monorepo (Turborepo / Nx / Lerna)"
+    detection_files:
+      - turbo.json
+      - nx.json
+      - lerna.json
+      - pnpm-workspace.yaml
+    detection_patterns:
+      - file: package.json
+        field: workspaces
+        description: "Has 'workspaces' field in root package.json"
+      - file: package.json
+        field: "scripts.build"
+        contains: "turbo"
+    recommended_claude_md_template: claude-md-monorepo.md
+    recommended_rules:
+      - name: monorepo-boundaries
+        description: "Enforce package boundaries, prevent cross-package direct imports"
+        path_pattern: "packages/**"
+      - name: shared-deps
+        description: "Validate shared dependency versions across packages"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+        description: "Run eslint on modified files after edits"
+      - pattern: damage-control
+        event: PreToolUse
+        description: "Block destructive commands"
+
+  # ---------------------------------------------------------------------------
+  fullstack-nextjs:
+    display_name: "Fullstack Next.js (App Router)"
+    detection_files:
+      - next.config.js
+      - next.config.mjs
+      - next.config.ts
+    detection_patterns:
+      - file: package.json
+        field: "dependencies.next"
+        description: "Has 'next' in dependencies"
+      - file: package.json
+        field: "dependencies.react"
+        description: "Has 'react' in dependencies"
+      - directory: app/
+        description: "Uses App Router (app/ directory)"
+      - directory: src/app/
+        description: "Uses App Router with src/ prefix"
+    recommended_claude_md_template: claude-md-fullstack.md
+    recommended_rules:
+      - name: server-client-boundary
+        description: "Enforce 'use client' / 'use server' directives"
+        path_pattern: "src/app/**"
+      - name: api-route-patterns
+        description: "Validate API route handler signatures"
+        path_pattern: "src/app/api/**"
+      - name: component-patterns
+        description: "Enforce component file structure and naming"
+        path_pattern: "src/components/**"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+      - playwright
+      - supabase
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+        description: "Run eslint + prettier on save"
+      - pattern: damage-control
+        event: PreToolUse
+        description: "Block rm -rf, git push --force"
+
+  # ---------------------------------------------------------------------------
+  react-library:
+    display_name: "React Component Library / Design System"
+    detection_files:
+      - rollup.config.js
+      - rollup.config.mjs
+      - tsup.config.ts
+      - vite.config.ts
+    detection_patterns:
+      - file: package.json
+        field: "peerDependencies.react"
+        description: "React as peer dependency (library pattern)"
+      - file: package.json
+        field: main
+        description: "Has 'main' entry point for distribution"
+      - file: package.json
+        field: exports
+        description: "Has 'exports' map for ESM/CJS"
+      - directory: src/components/
+        description: "Component source directory"
+    recommended_claude_md_template: claude-md-library.md
+    recommended_rules:
+      - name: public-api-surface
+        description: "Track public exports, prevent breaking changes"
+        path_pattern: "src/index.ts"
+      - name: peer-dep-ranges
+        description: "Validate peer dependency version ranges"
+      - name: storybook-coverage
+        description: "Ensure every exported component has a story"
+        path_pattern: "src/**/*.stories.tsx"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+      - pattern: api-surface-check
+        event: PostToolUse
+        description: "Warn if public API changes detected"
+
+  # ---------------------------------------------------------------------------
+  python-api:
+    display_name: "Python API (FastAPI / Django / Flask)"
+    detection_files:
+      - requirements.txt
+      - pyproject.toml
+      - setup.py
+      - Pipfile
+      - poetry.lock
+    detection_patterns:
+      - file: pyproject.toml
+        field: "tool.poetry"
+        description: "Uses Poetry for dependency management"
+      - file: requirements.txt
+        contains: "fastapi"
+        description: "FastAPI dependency detected"
+      - file: requirements.txt
+        contains: "django"
+        description: "Django dependency detected"
+      - file: requirements.txt
+        contains: "flask"
+        description: "Flask dependency detected"
+      - directory: app/
+        description: "Application directory"
+    recommended_claude_md_template: claude-md-python-api.md
+    recommended_rules:
+      - name: type-hints
+        description: "Enforce type hints on all function signatures"
+        path_pattern: "**/*.py"
+      - name: docstrings
+        description: "Require docstrings on public functions/classes"
+        path_pattern: "**/*.py"
+      - name: migration-safety
+        description: "Validate Alembic/Django migrations"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+      - postgres
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+        description: "Run ruff/black on modified Python files"
+      - pattern: security-gate
+        event: PreToolUse
+        description: "Block exposure of .env, secrets"
+
+  # ---------------------------------------------------------------------------
+  mobile-react-native:
+    display_name: "Mobile (React Native / Expo)"
+    detection_files:
+      - app.json
+      - app.config.js
+      - app.config.ts
+      - metro.config.js
+      - react-native.config.js
+    detection_patterns:
+      - file: package.json
+        field: "dependencies.react-native"
+        description: "Has 'react-native' dependency"
+      - file: package.json
+        field: "dependencies.expo"
+        description: "Has 'expo' dependency"
+      - directory: ios/
+        description: "iOS native directory"
+      - directory: android/
+        description: "Android native directory"
+    recommended_claude_md_template: claude-md-mobile.md
+    recommended_rules:
+      - name: platform-imports
+        description: "Validate platform-specific imports (.ios.ts, .android.ts)"
+        path_pattern: "src/**"
+      - name: navigation-patterns
+        description: "Enforce React Navigation patterns"
+        path_pattern: "src/navigation/**"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+    recommended_hooks:
+      - pattern: damage-control
+        event: PreToolUse
+        description: "Block destructive native directory operations"
+
+  # ---------------------------------------------------------------------------
+  rust-project:
+    display_name: "Rust Project (Cargo)"
+    detection_files:
+      - Cargo.toml
+      - Cargo.lock
+    detection_patterns:
+      - directory: src/
+        description: "Rust source directory"
+      - file: Cargo.toml
+        field: "[workspace]"
+        description: "Cargo workspace (monorepo)"
+    recommended_claude_md_template: claude-md-rust.md
+    recommended_rules:
+      - name: unsafe-audit
+        description: "Flag all unsafe blocks for review"
+        path_pattern: "src/**/*.rs"
+      - name: clippy-compliance
+        description: "Ensure clippy warnings are addressed"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+        description: "Run cargo fmt on modified .rs files"
+      - pattern: damage-control
+        event: PreToolUse
+
+  # ---------------------------------------------------------------------------
+  go-project:
+    display_name: "Go Project"
+    detection_files:
+      - go.mod
+      - go.sum
+    detection_patterns:
+      - file: go.mod
+        field: module
+        description: "Go module declaration"
+      - directory: cmd/
+        description: "Go command directory pattern"
+      - directory: internal/
+        description: "Go internal packages"
+    recommended_claude_md_template: claude-md-go.md
+    recommended_rules:
+      - name: go-conventions
+        description: "Enforce Go naming and package conventions"
+        path_pattern: "**/*.go"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+        description: "Run gofmt on modified .go files"
+
+  # ---------------------------------------------------------------------------
+  static-site:
+    display_name: "Static Site (Astro / Hugo / Gatsby / 11ty)"
+    detection_files:
+      - astro.config.mjs
+      - gatsby-config.js
+      - hugo.toml
+      - .eleventy.js
+      - eleventy.config.js
+    detection_patterns:
+      - file: package.json
+        field: "dependencies.astro"
+      - directory: content/
+        description: "Content directory for static sites"
+      - directory: src/pages/
+        description: "Pages directory"
+    recommended_claude_md_template: claude-md-static-site.md
+    recommended_rules:
+      - name: content-frontmatter
+        description: "Validate frontmatter in markdown content files"
+        path_pattern: "content/**/*.md"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+    recommended_hooks:
+      - pattern: auto-lint
+        event: PostToolUse
+
+  # ---------------------------------------------------------------------------
+  sinapse-project:
+    display_name: "SINAPSE-Managed Project"
+    detection_files:
+      - .sinapse-ai/core-config.yaml
+      - .sinapse-ai/constitution.md
+    detection_patterns:
+      - directory: .sinapse-ai/
+        description: "SINAPSE core framework directory"
+      - directory: .claude/commands/SINAPSE/
+        description: "SINAPSE agent commands for Claude"
+      - file: .claude/settings.json
+        contains: "SINAPSE"
+    recommended_claude_md_template: null
+    note: "SINAPSE projects already have CLAUDE.md managed by the framework"
+    recommended_rules:
+      - name: framework-boundary
+        description: "Enforce L1-L4 layer protection"
+      - name: agent-authority
+        description: "Enforce agent delegation matrix"
+      - name: story-lifecycle
+        description: "Enforce story status transitions"
+    recommended_mcp_servers:
+      - filesystem
+      - git
+      - context7
+      - coderabbit
+      - supabase
+    recommended_hooks:
+      - pattern: damage-control
+        event: PreToolUse
+      - pattern: auto-lint
+        event: PostToolUse
+      - pattern: context-preservation
+        event: PreCompact