msd-core/docs/commands.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>GSD Commands</title>
  <style>
    * {
      box-sizing: border-box;
    }
    body {
      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
      line-height: 1.6;
      max-width: 900px;
      margin: 0 auto;
      padding: 2rem 1rem;
      background: #fafafa;
      color: #333;
    }
    h1 {
      font-size: 2rem;
      margin-bottom: 0.5rem;
      color: #111;
    }
    .subtitle {
      color: #666;
      margin-bottom: 2rem;
      font-size: 1.1rem;
    }
    h2 {
      font-size: 1.25rem;
      margin-top: 2rem;
      margin-bottom: 1rem;
      padding-bottom: 0.5rem;
      border-bottom: 2px solid #e0e0e0;
      color: #222;
    }
    .command-list {
      list-style: none;
      padding: 0;
      margin: 0;
    }
    .command-item {
      display: flex;
      flex-wrap: wrap;
      gap: 0.5rem 1rem;
      padding: 0.75rem 0;
      border-bottom: 1px solid #eee;
      align-items: baseline;
    }
    .command-item:last-child {
      border-bottom: none;
    }
    .command-name {
      font-family: "SF Mono", Monaco, "Cascadia Code", "Roboto Mono", Consolas, monospace;
      font-size: 0.9rem;
      background: #e8f4fd;
      color: #0066cc;
      padding: 0.2rem 0.5rem;
      border-radius: 4px;
      white-space: nowrap;
      font-weight: 500;
    }
    .command-desc {
      color: #555;
      flex: 1;
      min-width: 200px;
    }
    footer {
      margin-top: 3rem;
      padding-top: 1rem;
      border-top: 1px solid #ddd;
      color: #888;
      font-size: 0.85rem;
    }
    @media (max-width: 600px) {
      body {
        padding: 1rem;
      }
      h1 {
        font-size: 1.5rem;
      }
      .command-item {
        flex-direction: column;
        gap: 0.25rem;
      }
      .command-name {
        align-self: flex-start;
      }
    }
  </style>
</head>
<body>
  <h1>GSD Commands</h1>
  <p class="subtitle">Quick reference for all Get Shit Done slash commands</p>

  <h2>Project Setup</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:new-project</code>
      <span class="command-desc">Initialize a new project with deep context gathering and PROJECT.md</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:new-milestone</code>
      <span class="command-desc">Start a new milestone cycle — update PROJECT.md and route to requirements</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:map-codebase</code>
      <span class="command-desc">Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents</span>
    </li>
  </ul>

  <h2>Planning</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:discuss-phase</code>
      <span class="command-desc">Gather phase context through adaptive questioning before planning</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:list-phase-assumptions</code>
      <span class="command-desc">Surface Claude's assumptions about a phase approach before planning</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:research-phase</code>
      <span class="command-desc">Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:plan-phase</code>
      <span class="command-desc">Create detailed execution plan for a phase (PLAN.md) with verification loop</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:add-phase</code>
      <span class="command-desc">Add phase to end of current milestone in roadmap</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:insert-phase</code>
      <span class="command-desc">Insert urgent work as decimal phase (e.g., 72.1) between existing phases</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:remove-phase</code>
      <span class="command-desc">Remove a future phase from roadmap and renumber subsequent phases</span>
    </li>
  </ul>

  <h2>Execution</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:execute-phase</code>
      <span class="command-desc">Execute all plans in a phase with wave-based parallelization</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:quick</code>
      <span class="command-desc">Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:debug</code>
      <span class="command-desc">Systematic debugging with persistent state across context resets</span>
    </li>
  </ul>

  <h2>Progress & Status</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:progress</code>
      <span class="command-desc">Check project progress, show context, and route to next action (execute or plan)</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:verify-work</code>
      <span class="command-desc">Validate built features through conversational UAT</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:audit-milestone</code>
      <span class="command-desc">Audit milestone completion against original intent before archiving</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:plan-milestone-gaps</code>
      <span class="command-desc">Create phases to close all gaps identified by milestone audit</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:complete-milestone</code>
      <span class="command-desc">Archive completed milestone and prepare for next version</span>
    </li>
  </ul>

  <h2>Task Management</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:add-todo</code>
      <span class="command-desc">Capture idea or task as todo from current conversation context</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:check-todos</code>
      <span class="command-desc">List pending todos and select one to work on</span>
    </li>
  </ul>

  <h2>Session Management</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:pause-work</code>
      <span class="command-desc">Create context handoff when pausing work mid-phase</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:resume-work</code>
      <span class="command-desc">Resume work from previous session with full context restoration</span>
    </li>
  </ul>

  <h2>Utilities</h2>
  <ul class="command-list">
    <li class="command-item">
      <code class="command-name">/gsd:help</code>
      <span class="command-desc">Show available GSD commands and usage guide</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:update</code>
      <span class="command-desc">Update GSD to latest version with changelog display</span>
    </li>
    <li class="command-item">
      <code class="command-name">/gsd:whats-new</code>
      <span class="command-desc">See what's new in GSD since your installed version</span>
    </li>
  </ul>

  <footer>
    <p>GSD (Get Shit Done) — <a href="https://www.npmjs.com/package/get-shit-done-cc">get-shit-done-cc</a></p>
  </footer>
</body>
</html>