cm-how-it-work

name	cm-how-it-work
description	Complete guide to vibe coding with the CodyMaster skill kit — from idea to deploy. Covers the full workflow, skills used at each phase, and common use cases. Read this first if you are new; reference it whenever you're unsure which skill to invoke.

CodyMaster Kit — The Ultimate Vibe Coding Guide

Overview

The CodyMaster (CM) kit transforms ideas into production code through 13 specialized, optimized skills. This workflow ensures the highest quality, absolute security, and maximum execution speed.

💡 Idea → 🔍 Analysis → 📐 Design → 🧪 Test-first (TDD) → 💻 Code → ✅ Verify → 🚀 Deploy → 🔄 Iterate

---

Workflow

Phase 0: Identity & Safety 🔒

Rule #1: Always verify identity before performing any action that could change the project state.

• Skill: cm-identity-guard
• When: At the start of a work session, before git push, deploy, or database operations.
• Action: Run node check-identity.js (or similar script) to verify GitHub/Cloudflare/Supabase accounts.

---

Phase 0.3: Knowledge Infrastructure Setup 🧠

For large codebases, establish the memory foundation before planning.

• Skills: cm-codeintell + cm-dockit + cm-deep-search + cm-notebooklm
• When: When onboarding to a new codebase or starting a massive refactoring initiative.
• Action:
  1. Scan structure with cm-codeintell to build the Skeleton Index.
  2. Generate missing architectural docs with cm-dockit.
  3. Index the docs for fast local retrieval with cm-deep-search (qmd).
  4. Sync high-value patterns to the Cloud Brain with cm-notebooklm.
• Output: A fully indexed 5-tier memory ecosystem ready for precise, low-token AI problem solving.

---

Phase 0.5: Strategic Analysis 🔍

For complex initiatives and enhancements on existing products.

• Skills: cm-brainstorm-idea + cm-codeintell
• When: When the task is complex and requires multi-dimensional analysis (tech, product, design, business) before planning.
• Action:
  1. Scan codebase with code intelligence (AST graph + architecture diagram via cm-codeintell).
  2. Interview user and analyze with 9 Windows (TRIZ).
  3. Propose 2-3 options, evaluate multi-dimensionally, recommend the best option.
• Output: OpenSpec openspec/changes/[initiative]/proposal.md — qualified problem + recommended option → passes to cm-planning.

---

Phase 1: Planning & Design 📐

Understand the 'Job to be Done' (JTBD) and architecture before writing code.

• Skill: cm-planning (Combines brainstorming + writing-plans)
• Action:
  1. Brainstorm requirements and analyze i18n.
  2. Propose architecture and tech stack.
  3. Write detailed OpenSpec docs (openspec/changes/[init]/design.md and tasks.md).
• Output: Design docs and execution plan (OpenSpec tasks) approved by user.

---

Phase 2: Implementation (TDD & Execution) 💻

Turn the plan into actual source code safely.

• Skills:
  • cm-tdd: Red-Green-Refactor cycle. No production code without a failing test first.
  • cm-execution: Execute plans intelligently (Manual, Parallel, or Subagent mode).
  • cm-project-bootstrap: For new projects — setup repo, i18n, SEO, and deploy pipeline from Day 0.
  • cm-git-worktrees: Isolate different work items to avoid state mixing.

---

Phase 3: Quality Control & Verification ✅

Prove with evidence, not words.

• Skills:
  • cm-quality-gate: Setup test infrastructure (test:gate) and verify output before claiming "done".
  • cm-debugging: When tests fail, use systematic investigation framework to find root cause.
  • cm-code-review: Professional request and feedback review process.

---

Phase 4: Safe Deployment 🚀

Ship code without fear of incidents.

• Skills:
  • cm-safe-deploy: Run 8-gate pipeline (Secret → Syntax → Test → Build → Deploy → Smoke).
  • cm-safe-i18n: Translate and synchronize languages consistently across the entire project.
  • cm-terminal: Monitor all terminal commands to detect errors immediately.

---

CodyMaster Kit — 34 Skills Summary

🔧 Engineering

Skill	Primary Function
cm-tdd	Strict Red-Green-Refactor TDD — no code without failing test first.
cm-debugging	Systematic 5-phase error investigation (root cause first).
cm-quality-gate	6-gate verification: static analysis → blind review → ship.
cm-test-gate	Setup 4-layer test infrastructure (unit → integration → e2e → security).
cm-code-review	Manage PR lifecycle: request → receive feedback → complete branch.
cm-codeintell	AST knowledge graph + architecture diagrams + smart context (30% fewer tokens).

⚙️ Operations

Skill	Primary Function
cm-safe-deploy	Multi-gate deploy pipeline with rollback strategy.
cm-identity-guard	Verify account before push/deploy to prevent wrong-project incidents.
cm-git-worktrees	Isolate feature work in separate worktrees — no state mixing.
cm-terminal	Safe terminal execution with progress logging and error capture.
cm-secret-shield	Defense-in-depth: pre-commit hooks, repo scanning, token lifecycle.
cm-safe-i18n	Safe multi-language management with multi-pass batching and 8-gate audit.

🎨 Product

Skill	Primary Function
cm-project-bootstrap	Full project setup: design system → CI → staging → deploy from Day 0.
cm-brainstorm-idea	Strategic analysis gate: 9 Windows + Double Diamond → 2-3 qualified options.
cm-planning	Brainstorm intent → write implementation plan → coordinate execution.
cm-ux-master	48 UX Laws + 37 Design Tests + Figma/Stitch + BM25 semantic design search.
cm-ui-preview	Live UI concept generation via Google Stitch or Pencil MCP.
cm-dockit	Generate complete knowledge bases, SOPs, and API docs from codebase.
cm-readit	Web audio engine: TTS reader, MP3 audio player, Voice CRO trigger system.
cm-jtbd	JTBD customer discovery: Switch Interview → Canvas → Opportunity Scoring.

📈 Growth

Skill	Primary Function
cm-content-factory	Self-learning content engine: research → generate → audit → deploy.
cm-ads-tracker	Conversion tracking setup: GTM, Meta CAPI, TikTok, Google Ads.
cm-cro-methodology	CRO audit: funnel mapping → persuasion assets → A/B test design.

🎯 Orchestration

Skill	Primary Function
cm-execution	Execute plans: Manual / Parallel / Subagent / RARV batch modes.
cm-continuity	Working memory protocol: read at session start, update at session end.
cm-skill-mastery	Meta-skill: when to invoke which skill, how to create new skills.
cm-skill-chain	Compose skills into automated multi-step pipelines (5 built-in chains).
cm-skill-index	Progressive disclosure index — 90% token savings on skill discovery.
cm-deep-search	Semantic search via qmd for large codebases (>200 src / >50 docs files).
cm-notebooklm	Cloud Brain sync — cross-machine knowledge persistence via NotebookLM.
cm-how-it-work	Full vibe coding guide — phases, skills per phase, use cases.

🖥️ Workflow Commands

Skill	Primary Function
cm-start	Orchestrate full workflow from objective to production code.
cm-dashboard	Render Kanban board from cm-tasks.json — visual status overview.
cm-status	Ultra-concise 1-2 sentence progress summary (what's done, what's next).

🚀 Autonomous Workflow System

The kit supports autonomous mode by applying the Reason → Act → Reflect → Verify (RARV) loop.

How to Use the Workflow:

1. /cm-start [objective]: Start work. The system will automatically initialize the OpenSpec structure (openspec/changes/[objective]/), break down tasks into tasks.md and sync with cm-tasks.json, launch the tracking interface, and autonomously use CM skills to complete them.
2. /cm-dashboard: Open the visual tracking Dashboard in browser (shows Kanban board, reasoning log, and progress).
3. /cm-status: View quick progress summary in Terminal.

---

💡 Activation Guide by Use Cases

There are 2 ways to use CodyMaster: Fully autonomous (Via Workflows) or Manual skill activation (Via Prompting).

1. Build New Feature / New Project (Autonomous)

Best way to delegate complete work packages.

• Command: /cm-start "Build user management feature with list screen and CRUD form"
• Implicit flow: Planning → create Task JSON → sub-agents continuously run cm-tdd and cm-quality-gate for each task until done.

2. Fix Production Bug (Manual)

Bugs need close supervision and AI should not blindly change too much code.

• Step 1: Activate cm-debugging to find Root Cause.
• Step 2: Activate cm-tdd to write test reproducing the bug and fix it.
• Step 3: Activate cm-safe-deploy to ship code safely.

3. Setup New Project From Scratch

Establish a solid foundation to avoid technical debt later.

• Command: "Use cm-identity-guard to ensure correct account, then run cm-project-bootstrap to setup a new Next.js project."

4. Batch Multi-Language Translation

Tedious work that's error-prone if AI loses focus.

• Command: "Use cm-safe-i18n to extract all hardcoded text in /components directory to vi.json and en.json files."

---

9 Golden Rules

1. Identity First: Verify account (cm-identity-guard) before push/deploy.
2. Design Before Code: Always have an approved plan before typing.
3. i18n Day 0: Always consider multi-language from the brainstorm step.
4. Test Before Code: RED → GREEN → REFACTOR. No exceptions (cm-tdd).
5. Evidence Over Claims: Only trust terminal/test results output, not AI "saying" it's done.
6. Deploy via Gates: 8 gates must pass sequentially. Any gate fails = STOP (cm-safe-deploy).
7. Safe Secrets: Never commit secrets. Pre-commit hooks protect every push (cm-secret-shield).
8. Parallel Power: Use parallel execution for i18n or multi-bug fixes (cm-execution).
9. Working Memory: Read CONTINUITY.md at session start, update at session end (cm-continuity).