mosaic-buddy

Technical co-pilot for non-engineering teams — health checks, stack review, UX audits, brainstorming, documentation, debugging, and weekly coaching. Examples: "/mosaic-buddy" (what can I help with?), "/mosaic-buddy doctor" (check before sharing), "/mosaic-buddy brainstorm" (help me plan), "/mosaic-buddy 5x" (quick coaching), "/mosaic-buddy 10x" (deep coaching).

Idea companion that turns vague "I want to build X" into a structured 1-page spec through conversation. Senior product advisor personality — curious, encouraging, one question at a time. Challenges assumptions gently. Examples: "help me plan a feature", "brainstorm", "I want to build something"

Quick coaching report that preprocesses session transcripts with shell commands and uses Sonnet for fast, token-efficient analysis. Produces the same HTML coaching report as 10x but skips deep prompt style analysis. Examples: "5x", "quick coaching", "quick insights"

Deep coaching report that dispatches Sonnet subagents to analyze session transcripts in parallel, then synthesizes findings with Opus into a rich HTML coaching report. Includes prompt style personality analysis. Examples: "10x", "deep coaching", "full coaching report"

Structured 6-step debugging workflow for any error in the approved stack. Classifies errors, forms hypotheses, investigates systematically, and documents the trail for future reference. Examples: "help me fix a bug", "debug", "something is broken", "I'm getting an error"

Thorough health audit for internal tools. Runs 80+ checks across reliability, safety, code health, and user experience. Produces a narrative report with billboard status, tiered findings, and actionable fixes. Examples: "check before sharing", "health check", "is this ready to deploy?"

Rules and patterns for internal tools that call Claude API or build MCP servers. Covers model selection, cost management, security, prompt engineering, and MCP server conventions. Auto-activates when a project imports @anthropic-ai/sdk, uses Claude API, builds an MCP server, or when the user asks about AI features, prompt design, or token costs.

Foundation skill for all Mosaic internal tools. Defines the approved tech stack, project structure, security baseline, deployment requirements, and communication standards. Auto-activates for every agent in the plugin — this is the single source of truth for what "good" looks like when non-engineering teams build internal tools with Claude Code.

Templates and rules for creating project documentation: PRDs, tech specs, and Architecture Decision Records (ADRs). Includes mermaid diagram patterns, folder structure conventions, and document lifecycle rules (create, update, refresh). Auto-activates when the user asks to document, create a PRD, write a spec, record a decision, update docs, compare docs to code, or uses the document command.

Capture a rating + short title + description from the user and submit it to the beacon-telemetry dashboard. Three steps: rating (4-point AskUserQuestion), title (one-line text), description (1–3 sentences text). Submission is signed with the shared HMAC key. Honours MOSAIC_BUDDY_TELEMETRY_URL=off.

One-command session save and resume. `/mosaic-buddy handoff <sessionName>` auto-detects intent from the work-log folder: missing → write a fresh handoff; exists & last written by this session → save another checkpoint; exists & written by a different session → resume (read latest, verify repo, brief). NOT context compaction — these are hand-authored, durable files.

4 hooks across 4 events