specstocode 0.5.0 → 0.6.1

package/README.md

@@ -1,218 +1,162 @@
-# ProductBuilders CLI
+# specstocode
 
-Plan, validate, and build products — from your terminal. Turn a problem into a structured product blueprint with AI-powered story mapping.
+Write structured specs, map your user stories, and let your AI coding agent do the rest.
 
-```
-   ██████╗ ██████╗
-   ██╔══██╗██╔══██╗   ProductBuilders
-   ██████╔╝██████╔╝   Stop building for nobody.
-   ██╔═══╝ ██╔══██╗
-   ██║     ██████╔╝
-   ╚═╝     ╚═════╝
+## Install
+
+```bash
+npm install -g specstocode
 ```
 
-## Install
+Or use without installing:
 
 ```bash
-npm install -g productbuilders
+npx specstocode init
 ```
 
-## Getting Started
+## How it works
 
-### 1. Log in
+1. **Plan on the web** — create a project on [specstocode.com](https://specstocode.com), map your user stories, and write Gherkin specs for each one
+2. **Connect your codebase** — run `specstocode init` in your project directory
+3. **Build with AI** — your AI coding agent reads `SPECSTOCODE.md` for full product context: stories, acceptance criteria, decisions, and notes
 
-```bash
-productbuilders login
+```
+specstocode.com                        Your project
+┌─────────────────┐                   ┌─────────────────┐
+│  Story map UI   │◄── sync API ─────►│  CLI / MCP      │
+│  Specs editor   │                   │  SPECSTOCODE.md │
+│  (plan here)    │  GET /context     │  (build here)   │
+│                 │──────────────────►│                 │
+│  Stories        │  PATCH /stories   │  Claude Code    │
+│  Acceptance     │◄──────────────────│  Cursor / etc   │
+│  criteria       │                   │                 │
+└─────────────────┘                   └─────────────────┘
 ```
 
-Opens your browser to authenticate with [ProductBuilders.pro](https://productbuilders.pro). You only need to do this once per machine.
+---
+
+## Getting Started
 
-### 2. Start a new project
+### 1. Log in
 
 ```bash
-productbuilders start
+specstocode login
 ```
 
-Interactive guided flow:
-1. **Describe your problem** — what are you trying to solve?
-2. **AI discovery questions** — sharpens your thinking with targeted questions
-3. **Pitch synthesis** — generates a one-liner pitch and target user
-4. **Name your product** — pick from AI-suggested names or type your own
-5. **Validate** — publish to Explore to get feedback before building
-6. **Scope** — generates a blueprint, story map, and optional HTML mockup
+Opens your browser to authenticate. One-time per machine.
 
-### 3. Connect to your codebase
+### 2. Connect your codebase
 
-After scoping, connect the story map to your project directory:
+Run this inside your project directory after creating a project on [specstocode.com](https://specstocode.com):
 
 ```bash
-productbuilders init pb_sync_<your-token>
+specstocode init
 ```
 
-Your project now has:
-- `PRODUCTBUILDERS.md` — product context (personas, stories, acceptance criteria)
-- `.productbuilders/config.json` — sync config (auto-gitignored)
+This creates:
+- `SPECSTOCODE.md` — product context file (stories, acceptance criteria, personas, decisions)
+- `.specstocode/config.json` — sync config (auto-gitignored)
 
-### 4. Configure your AI tool
+### 3. Set up your AI tool
 
 ```bash
-productbuilders setup
+specstocode setup
 ```
 
-Sets up [Claude Code](https://claude.com/claude-code) and/or [Cursor](https://cursor.com) with:
-- `CLAUDE.md` / `.cursorrules` with product context
-- Slash commands for the development workflow (inside Claude Code, not the terminal)
+Configures [Claude Code](https://claude.com/claude-code) or [Cursor](https://cursor.com) with:
+- `CLAUDE.md` / `.cursorrules` pointing to your specs
 - `ARCHITECTURE.md` and `CONVENTIONS.md` scaffolding
 
-### 5. Build
+### 4. Build
 
 ```bash
-productbuilders next          # See what to build first
-productbuilders done <id>     # Mark a story as complete
-productbuilders stories       # List all stories
-productbuilders status        # View progress dashboard
+specstocode next          # What to build next (highest priority story + acceptance criteria)
+specstocode done <id>     # Mark a story complete
+specstocode stories       # List all stories
+specstocode status        # Progress dashboard
 ```
 
 ---
 
 ## All Commands
 
-### Project Creation
+### Setup
 
 | Command | Description |
 |---------|-------------|
-| `productbuilders login` | Authenticate (opens browser) |
-| `productbuilders logout` | Log out |
-| `productbuilders start` | New project — guided flow from problem to pitch |
-| `productbuilders scope [id]` | Scope a project — blueprint, story map, mockup |
-| `productbuilders setup` | Configure Claude Code / Cursor |
-| `productbuilders templates [name]` | Browse starter templates |
-
-### Story Management
+| `specstocode login` | Authenticate (opens browser) |
+| `specstocode logout` | Log out |
+| `specstocode init` | Connect project directory to a story map |
+| `specstocode sync` | Refresh `SPECSTOCODE.md` with latest from the web |
+| `specstocode setup` | Configure Claude Code / Cursor |
 
-| Command | Description |
-|---------|-------------|
-| `productbuilders init [token]` | Connect project to a story map |
-| `productbuilders sync` | Refresh PRODUCTBUILDERS.md |
-| `productbuilders status` | Progress dashboard |
-| `productbuilders stories [-f filter]` | List stories (filter: todo/done/keyword) |
-| `productbuilders next` | Next priority story with acceptance criteria |
-| `productbuilders done <id>` | Mark story as done (accepts ID prefix) |
-| `productbuilders add <title>` | Create a new story |
-| `productbuilders decide [title]` | Log an architectural decision |
-| `productbuilders note <id> [note]` | Add implementation notes |
-
-### Analysis (coming soon)
+### Story management
 
 | Command | Description |
 |---------|-------------|
-| `productbuilders complexity [id]` | AI complexity scoring |
-| `productbuilders research [query]` | Research with project context |
-| `productbuilders import [file]` | Import PRD as stories |
+| `specstocode status` | Progress dashboard |
+| `specstocode stories [-f filter]` | List stories (filter: `todo` / `done` / keyword) |
+| `specstocode next` | Next priority story with acceptance criteria |
+| `specstocode done <id>` | Mark a story done (accepts ID prefix) |
+| `specstocode add <title>` | Create a new story |
+| `specstocode decide [title]` | Log an architectural decision |
+| `specstocode note <id> [text]` | Add implementation notes to a story |
 
-### Integration
+### MCP server
 
 | Command | Description |
 |---------|-------------|
-| `productbuilders mcp [--mode]` | Start MCP server (core/standard/all) |
+| `specstocode mcp [--mode]` | Start MCP server (`core` / `standard` / `all`) |
 
 ---
 
 ## MCP Server
 
-Give Claude Code or Cursor native access to your story map.
+Give Claude Code or Cursor native access to your story map and specs.
 
-### Setup
+Add to `~/.claude/settings.json` (Claude Code) or your Cursor MCP config:
 
 ```json
 {
   "mcpServers": {
-    "productbuilders": {
+    "specstocode": {
       "command": "npx",
-      "args": ["productbuilders", "mcp"],
+      "args": ["specstocode", "mcp"],
       "cwd": "/path/to/your/project"
     }
   }
 }
 ```
 
-Add to `~/.claude/settings.json` (Claude Code) or your Cursor MCP config.
-
-### Tool Modes
+### Tool modes
 
 Control token usage with `--mode`:
 
 | Mode | Tools | Use case |
 |------|-------|----------|
-| `core` | 5 | Day-to-day dev (list, mark done, status, notes) |
-| `standard` | 8 | Active dev (+ create, context, decisions) |
-| `all` | 11 | Full power (+ complexity, research, import) |
+| `core` | 5 | Day-to-day dev — list, mark done, status, notes |
+| `standard` | 8 | Active dev — + create, context, decisions |
+| `all` | 11 | Full access — + complexity, research, import |
 
-### Available Tools
+### Available tools
 
 | Tool | Mode | Description |
 |------|------|-------------|
 | `list_stories` | core | List stories with optional filter |
-| `mark_done` | core | Mark a story as complete |
-| `mark_in_progress` | core | Mark a story as in progress |
+| `mark_done` | core | Mark a story complete |
+| `mark_in_progress` | core | Mark a story in progress |
 | `get_status` | core | Progress summary |
 | `add_note` | core | Add implementation notes |
 | `create_story` | standard | Create a new story |
-| `get_context` | standard | Fetch PRODUCTBUILDERS.md |
+| `get_context` | standard | Fetch full product context |
 | `log_decision` | standard | Log an architectural decision |
 | `analyze_complexity` | all | AI complexity scoring |
 | `research` | all | AI research with project context |
-| `import_prd` | all | Parse PRD into stories |
-
----
-
-## Templates
-
-Starter story maps for common product types:
-
-```bash
-productbuilders templates          # List all
-productbuilders templates saas     # View details
-```
-
-| Template | Description | Stories |
-|----------|-------------|---------|
-| `saas` | Multi-tenant SaaS with auth, billing, dashboards | 16 |
-| `marketplace` | Two-sided marketplace with payments | 13 |
-| `mobile-app` | Consumer app with feed, social, notifications | 12 |
-| `ai-tool` | AI-powered tool with streaming and billing | 12 |
-
----
-
-## How It Works
-
-```
-ProductBuilders.pro                    Your Project
-┌──────────────────┐                  ┌──────────────────┐
-│                  │                  │                  │
-│  Story Map UI    │◄── sync API ───►│  CLI / MCP       │
-│  (plan here)     │                  │  (build here)    │
-│                  │                  │                  │
-│  ┌────────────┐  │   GET /context   │  PRODUCTBUILDERS │
-│  │ Activities │  │ ───────────────► │  .md             │
-│  │ Steps      │  │                  │                  │
-│  │ Stories    │  │  PATCH /stories  │  Claude Code /   │
-│  │ Personas   │  │ ◄─────────────── │  Cursor / etc    │
-│  └────────────┘  │                  │                  │
-└──────────────────┘                  └──────────────────┘
-```
-
-1. **Start** — describe your problem, AI generates discovery questions and a pitch
-2. **Validate** — publish to Explore, get feedback and intent signals
-3. **Scope** — AI generates blueprint, story map, and mockup
-4. **Connect** — `productbuilders init` links your codebase to the story map
-5. **Build** — your AI tool reads PRODUCTBUILDERS.md for context
-6. **Track** — mark stories done, log decisions, add notes — all flows back to the map
+| `import_prd` | all | Parse a PRD into stories |
 
 ---
 
 ## Links
 
-- [ProductBuilders.pro](https://productbuilders.pro) — the web app
-- [Explore](https://productbuilders.pro/explore) — discover what others are building
-- [Community](https://productbuilders.pro/community) — connect with builders
+- [specstocode.com](https://specstocode.com) — web app
+- [npm](https://www.npmjs.com/package/specstocode) — this package

package/bin/stc.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/{chunk-P4M7CVDK.js → chunk-2FQUCTDE.js}

@@ -1,7 +1,7 @@
 import {
   API_BASE,
   requireAuth
-} from "./chunk-CYA6I7NV.js";
+} from "./chunk-WJOIFYIA.js";
 import {
   getContext
 } from "./chunk-QKMZ2SBR.js";
@@ -12,7 +12,7 @@ import {
 } from "./chunk-WPVDURTJ.js";
 import {
   writeConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/commands/scope.ts
 import { writeFileSync, existsSync } from "fs";
@@ -31,7 +31,7 @@ async function scope(projectId) {
   const auth = requireAuth();
   const { token } = auth;
   if (!projectId) {
-    projectId = await ask("  Project ID (from `npx specstocode start`): ");
+    projectId = await ask("  Project ID (from `stc start`): ");
   }
   if (!projectId?.trim()) {
     console.log("  Project ID required.");
@@ -195,7 +195,7 @@ async function scope(projectId) {
     "  Configure your AI tool (Claude Code / Cursor) with specstocode agent workflows?"
   );
   if (wantSetup) {
-    const { setup } = await import("./setup-VBFEFGTK.js");
+    const { setup } = await import("./setup-ZJCK6JB4.js");
     await setup();
     return;
   }
@@ -203,10 +203,10 @@ async function scope(projectId) {
   \u2705 Your project is scoped and ready to build!
 
   Next steps:
-    \u2022 npx specstocode setup     \u2014 configure your AI tool
-    \u2022 npx specstocode status    \u2014 see your story map progress
-    \u2022 npx specstocode next      \u2014 see what to build first
-    \u2022 npx specstocode done <id> \u2014 mark stories as you complete them
+    \u2022 stc setup          \u2014 configure your AI tool
+    \u2022 stc status         \u2014 see your story map progress
+    \u2022 stc next           \u2014 see what to build first
+    \u2022 stc done <id>      \u2014 mark stories as you complete them
 
   Your story map is also live at ${API_BASE}
   Seek advice from the community and our resources.

package/dist/{chunk-J22FYEMI.js → chunk-CNJK6J3P.js}

@@ -33,11 +33,11 @@ function writeStoryContext(story) {
     ``,
     `## Implementation notes`,
     ``,
-    `_Notes added via \`npx specstocode note ${story.id.slice(0, 8)} "..."\`_`,
+    `_Notes added via \`stc note ${story.id.slice(0, 8)} "..."\`_`,
     ``,
     `## Decisions`,
     ``,
-    `_Log decisions via \`npx specstocode decide "..." -s ${story.id.slice(0, 8)}\`_`,
+    `_Log decisions via \`stc decide "..." -s ${story.id.slice(0, 8)}\`_`,
     ``,
     `## Relevant files`,
     ``,
@@ -45,7 +45,7 @@ function writeStoryContext(story) {
     ``,
     `---`,
     ``,
-    `Mark done: \`npx specstocode done ${story.id.slice(0, 8)}\``
+    `Mark done: \`stc done ${story.id.slice(0, 8)}\``
   ].join("\n");
   const path = storyContextPath(story.id);
   writeFileSync(path, md);

package/dist/{chunk-55DTUCLY.js → chunk-T46QKLGM.js}

@@ -1,6 +1,6 @@
 import {
   requireAuth
-} from "./chunk-CYA6I7NV.js";
+} from "./chunk-WJOIFYIA.js";
 import {
   choose,
   closePrompt
@@ -8,7 +8,7 @@ import {
 import {
   hasConfig,
   requireConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/commands/setup.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
@@ -17,7 +17,7 @@ import { join } from "path";
 async function setup() {
   requireAuth();
   if (!hasConfig()) {
-    console.log("  Not connected to a project. Run `npx specstocode init` first.");
+    console.log("  Not connected to a project. Run `stc init` first.");
     closePrompt();
     return;
   }
@@ -55,11 +55,11 @@ async function setup() {
     /pb-context     Load focused context for the current story
 
   Terminal commands (use anywhere):
-    specstocode status       Show story map progress
-    specstocode next         Next priority story
-    specstocode done <id>    Mark a story as done
-    specstocode stories      List all stories
-    specstocode sync         Refresh SPECSTOCODE.md
+    stc status       Show story map progress
+    stc next         Next priority story
+    stc done <id>    Mark a story as done
+    stc stories      List all stories
+    stc sync         Refresh SPECSTOCODE.md
   `);
   closePrompt();
 }
@@ -78,12 +78,12 @@ Read SPECSTOCODE.md for the full product context: personas, user journey, storie
 2. **ARCHITECTURE.md** \u2014 how the system is structured (decisions, patterns, trade-offs)
 3. **CONVENTIONS.md** \u2014 how to write code (naming, file structure, testing patterns)
 
-Refresh product context anytime: \`npx specstocode sync\`
+Refresh product context anytime: \`stc sync\`
 
 ## Development workflow
 
 ### Starting work
-1. Run \`npx specstocode next\` to get the highest-priority story
+1. Run \`stc next\` to get the highest-priority story
 2. Read the acceptance criteria \u2014 these define "done"
 3. Check ARCHITECTURE.md for relevant technical decisions
 4. Plan your approach before writing code
@@ -91,22 +91,22 @@ Refresh product context anytime: \`npx specstocode sync\`
 ### During development
 - Follow patterns in CONVENTIONS.md
 - If you discover a new requirement, create a story:
-  \`npx specstocode add "Story title" --activity "Activity name" --priority must\`
+  \`stc add "Story title" --activity "Activity name" --priority must\`
 - If you make an architectural decision, log it:
-  \`npx specstocode decide "Decision title" -d "What was decided and why"\`
+  \`stc decide "Decision title" -d "What was decided and why"\`
 
 ### Completing work
 1. Verify all acceptance criteria are met
 2. Add implementation notes:
-   \`npx specstocode note <story-id> "How this was implemented, gotchas"\`
-3. Mark done: \`npx specstocode done <story-id>\`
+   \`stc note <story-id> "How this was implemented, gotchas"\`
+3. Mark done: \`stc done <story-id>\`
 4. Commit: \`git commit -m "feat: description [SC-<id>]"\`
 
 ### Writing back to specstocode
 Everything you record flows back to the story map so the team has context:
-- **Stories**: \`npx specstocode add\` / \`done\` / \`note\`
-- **Decisions**: \`npx specstocode decide\`
-- **Context refresh**: \`npx specstocode sync\`
+- **Stories**: \`stc add\` / \`done\` / \`note\`
+- **Decisions**: \`stc decide\`
+- **Context refresh**: \`stc sync\`
 `;
   if (existsSync(claudeMdPath)) {
     const existing = readFileSync(claudeMdPath, "utf-8");
@@ -126,7 +126,7 @@ Everything you record flows back to the story map so the team has context:
     join(commandsDir, "pb-next.md"),
     `# Pick up the next story
 
-1. Run \`npx specstocode next\` to get the highest-priority story
+1. Run \`stc next\` to get the highest-priority story
 2. Read the acceptance criteria carefully \u2014 these define "done"
 3. Check ARCHITECTURE.md for relevant technical decisions
 4. Read CONVENTIONS.md for coding patterns to follow
@@ -139,7 +139,7 @@ Everything you record flows back to the story map so the team has context:
     `# Implement a story
 
 ## Process
-1. Run \`npx specstocode next\` to identify the story (or use the story ID provided)
+1. Run \`stc next\` to identify the story (or use the story ID provided)
 2. Read SPECSTOCODE.md for full product context
 3. Read the story's acceptance criteria \u2014 each one is a requirement
 4. Check ARCHITECTURE.md for technical decisions that affect this work
@@ -150,14 +150,14 @@ Everything you record flows back to the story map so the team has context:
 
 ## Write back to specstocode
 9. Add implementation notes:
-   \`npx specstocode note <story-id> "How this was implemented"\`
+   \`stc note <story-id> "How this was implemented"\`
 10. Log any significant decisions:
-    \`npx specstocode decide "Decision title" -d "What and why" -c architecture\`
+    \`stc decide "Decision title" -d "What and why" -c architecture\`
 11. Log any trade-offs:
-    \`npx specstocode decide "Trade-off" -d "What and why" -c trade-off\`
+    \`stc decide "Trade-off" -d "What and why" -c trade-off\`
 12. If you discovered new requirements:
-    \`npx specstocode add "title" --activity "Activity" --priority should\`
-13. Mark done: \`npx specstocode done <story-id>\`
+    \`stc add "title" --activity "Activity" --priority should\`
+13. Mark done: \`stc done <story-id>\`
 14. Commit: \`git commit -m "feat: description [SC-<id>]"\`
 
 ## Rules
@@ -190,9 +190,9 @@ Everything you record flows back to the story map so the team has context:
    - Decisions made and trade-offs
    - How to test it manually
 4. Log decisions to specstocode:
-   \`npx specstocode decide "Title" -d "Description" -c architecture\`
+   \`stc decide "Title" -d "Description" -c architecture\`
 5. Add implementation notes:
-   \`npx specstocode note <story-id> "Summary of how it works"\`
+   \`stc note <story-id> "Summary of how it works"\`
 6. Update ARCHITECTURE.md if needed
 7. Update CONVENTIONS.md if new patterns were introduced
 `
@@ -201,7 +201,7 @@ Everything you record flows back to the story map so the team has context:
     join(commandsDir, "pb-test.md"),
     `# Write tests for a story
 
-1. Get the story details: \`npx specstocode next\` or provided story ID
+1. Get the story details: \`stc next\` or provided story ID
 2. Each acceptance criterion becomes at least one test
 3. Also consider: error cases, boundary conditions, integration points
 4. Follow testing patterns in CONVENTIONS.md
@@ -210,15 +210,15 @@ Everything you record flows back to the story map so the team has context:
   );
   writeFileSync(
     join(commandsDir, "pb-status.md"),
-    `Run \`npx specstocode status\` and \`npx specstocode stories --filter todo\` to show current progress and remaining backlog. Summarise what's done and what's left.`
+    `Run \`stc status\` and \`stc stories --filter todo\` to show current progress and remaining backlog. Summarise what's done and what's left.`
   );
   writeFileSync(
     join(commandsDir, "pb-done.md"),
-    `Ask which story was just completed, then run \`npx specstocode done <id>\`. Also ask if there are any implementation notes to add: \`npx specstocode note <id> "..."\``
+    `Ask which story was just completed, then run \`stc done <id>\`. Also ask if there are any implementation notes to add: \`stc note <id> "..."\``
   );
   writeFileSync(
     join(commandsDir, "pb-sync.md"),
-    `Run \`npx specstocode sync\` to refresh SPECSTOCODE.md with the latest story map. Then re-read SPECSTOCODE.md to update your context.`
+    `Run \`stc sync\` to refresh SPECSTOCODE.md with the latest story map. Then re-read SPECSTOCODE.md to update your context.`
   );
   writeFileSync(
     join(commandsDir, "pb-propose.md"),
@@ -231,18 +231,18 @@ stories there AND saves a local spec for the AI to reference during implementati
 ## Process
 1. Ask the user: "What do you want to build or change? Describe the problem and the solution."
 2. Help them break it into 2-5 stories with clear acceptance criteria (each AC is testable)
-3. Run: \`npx specstocode propose <change-name>\`
+3. Run: \`stc propose <change-name>\`
    - The CLI will guide through: problem, solution, activity, priority, stories + ACs
    - Stories are created in the live story map at specstocode.com
    - A local spec is saved to \`pb-changes/<name>/proposal.md\`
-4. Once done: \`npx specstocode sync\` to pull the new stories into SPECSTOCODE.md
-5. Run \`npx specstocode next\` to start implementing
+4. Once done: \`stc sync\` to pull the new stories into SPECSTOCODE.md
+5. Run \`stc next\` to start implementing
 
 ## Tips
 - Change names should be kebab-case: add-dark-mode, fix-auth-flow, onboarding-revamp
 - Keep stories small \u2014 one story = one deployable increment
 - Write ACs as testable outcomes: "Given X, when Y, then Z" or "User can..."
-- If the change is already defined in the UI, just run \`npx specstocode sync\` instead
+- If the change is already defined in the UI, just run \`stc sync\` instead
 `
   );
   writeFileSync(
@@ -257,13 +257,13 @@ Use this to focus on a single story without loading the full story map.
 - When you need a clean, focused view of ACs and notes
 
 ## Process
-1. Run \`npx specstocode next\` to get the active story \u2014 this automatically writes the context file to \`.specstocode/stories/<id>.md\`
+1. Run \`stc next\` to get the active story \u2014 this automatically writes the context file to \`.specstocode/stories/<id>.md\`
 2. Read that file \u2014 it contains: title, user story, acceptance criteria (as checkboxes), notes, and space for relevant files
 3. Use it as your working document throughout implementation:
    - Check off ACs as you satisfy them
    - Add file paths under "Relevant files" as you discover them
-   - Run \`npx specstocode note <id> "..."\` to log notes (updates both remote map and local file)
-4. When all ACs are checked: \`npx specstocode done <id>\`
+   - Run \`stc note <id> "..."\` to log notes (updates both remote map and local file)
+4. When all ACs are checked: \`stc done <id>\`
 
 ## If you already know the story ID
 The file is at \`.specstocode/stories/<full-story-id>.md\` \u2014 read it directly.
@@ -293,7 +293,7 @@ The file is at \`.specstocode/stories/<full-story-id>.md\` \u2014 read it direct
     }
   }
 
-  Or if you use OpenClaw: npx specstocode openclaw-register
+  Or if you use OpenClaw: stc openclaw-register
 `);
   }
 }
@@ -309,12 +309,12 @@ function setupCursor(syncToken) {
 3. **CONVENTIONS.md** \u2014 coding patterns, naming, file structure
 
 ## Workflow
-- Next story: \`npx specstocode next\`
-- Mark done: \`npx specstocode done <id>\`
-- Add notes: \`npx specstocode note <id> "..."\`
-- Log decisions: \`npx specstocode decide "Title" -d "Why"\`
-- Create stories: \`npx specstocode add "title" --activity "Name"\`
-- Refresh context: \`npx specstocode sync\`
+- Next story: \`stc next\`
+- Mark done: \`stc done <id>\`
+- Add notes: \`stc note <id> "..."\`
+- Log decisions: \`stc decide "Title" -d "Why"\`
+- Create stories: \`stc add "title" --activity "Name"\`
+- Refresh context: \`stc sync\`
 
 ## Rules
 - Read acceptance criteria before implementing

package/dist/{chunk-CYA6I7NV.js → chunk-WJOIFYIA.js}

@@ -19,7 +19,7 @@ function saveAuth(data) {
 function requireAuth() {
   const auth = getAuth();
   if (!auth) {
-    console.error("Not logged in. Run: npx specstocode login");
+    console.error("Not logged in. Run: stc login");
     process.exit(1);
   }
   return auth;

package/dist/{chunk-NAOZWXOF.js → chunk-ZLSV4CRF.js}

@@ -25,7 +25,7 @@ function writeConfig(config) {
 function requireConfig() {
   const config = readConfig();
   if (!config) {
-    console.error("Not initialized. Run: npx specstocode init");
+    console.error("Not initialized. Run: stc init");
     process.exit(1);
   }
   return config;

package/dist/{complexity-TUS6F2UI.js → complexity-27JMHAD2.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-QKMZ2SBR.js";
 import {
   requireConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/commands/complexity.ts
 import ora from "ora";

package/dist/{import-prd-HP66GKRA.js → import-prd-IOV3SEQV.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-WPVDURTJ.js";
 import {
   requireConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/commands/import-prd.ts
 import { readFileSync, existsSync } from "fs";

package/dist/index.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-55DTUCLY.js";
+} from "./chunk-T46QKLGM.js";
 import {
   scope
-} from "./chunk-P4M7CVDK.js";
+} from "./chunk-2FQUCTDE.js";
 import {
   API_BASE,
   getAuth,
   requireAuth,
   saveAuth
-} from "./chunk-CYA6I7NV.js";
+} from "./chunk-WJOIFYIA.js";
 import {
   storyContextPath,
   writeStoryContext
-} from "./chunk-J22FYEMI.js";
+} from "./chunk-CNJK6J3P.js";
 import {
   createStories,
   getContext,
@@ -32,7 +32,7 @@ import {
   readConfig,
   requireConfig,
   writeConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -55,7 +55,7 @@ function sleep(ms) {
 async function login() {
   const existing = getAuth();
   if (existing) {
-    console.log("Already logged in. Run `npx specstocode logout` to switch accounts.");
+    console.log("Already logged in. Run `stc logout` to switch accounts.");
     return;
   }
   console.log("Logging in to specstocode...\n");
@@ -80,11 +80,11 @@ async function login() {
       if (data.status === "approved" && data.token) {
         saveAuth({ token: data.token, apiBase: API_BASE });
         console.log("\u2705 Logged in to specstocode!\n");
-        console.log("You can now run: npx specstocode init");
+        console.log("You can now run: stc init");
         return;
       }
       if (data.status === "expired") {
-        console.error("Login request expired. Run `npx specstocode login` to try again.");
+        console.error("Login request expired. Run `stc login` to try again.");
         process.exit(1);
       }
       process.stdout.write(".");
@@ -92,7 +92,7 @@ async function login() {
       process.stdout.write(".");
     }
   }
-  console.error("\nLogin timed out. Run `npx specstocode login` to try again.");
+  console.error("\nLogin timed out. Run `stc login` to try again.");
   process.exit(1);
 }
 async function logout() {
@@ -203,7 +203,7 @@ Connecting to "${map.title}"...`);
     }
     writeConfig(config);
     await setupFiles(config);
-    console.log("\n\u2705 Ready! Try: npx specstocode status");
+    console.log("\n\u2705 Ready! Try: stc status");
   } finally {
     rl.close();
   }
@@ -228,7 +228,7 @@ async function initWithSyncToken(syncToken) {
     process.exit(1);
   }
   await setupFiles(config);
-  console.log("\n\u2705 Ready! Try: npx specstocode status");
+  console.log("\n\u2705 Ready! Try: stc status");
 }
 async function setupFiles(config) {
   try {
@@ -472,10 +472,10 @@ async function next(opts = {}) {
 `);
       for (const s2 of inProgress) {
         console.log(`    \u{1F528} ${s2.title}`);
-        console.log(`       ID: ${s2.id.slice(0, 8)} | Mark done: npx specstocode done ${s2.id.slice(0, 8)}`);
+        console.log(`       ID: ${s2.id.slice(0, 8)} | Mark done: stc done ${s2.id.slice(0, 8)}`);
       }
       console.log(`
-  Finish those first, or run \`specstocode next --skip-wip\` to pick the next todo anyway.
+  Finish those first, or run \`stc next --skip-wip\` to pick the next todo anyway.
 `);
       return;
     }
@@ -515,7 +515,7 @@ async function next(opts = {}) {
   ID: ${s.id}`);
   console.log(`  Context: ${relPath}`);
   console.log(`  Spec:    ${specUrl}`);
-  console.log(`  Mark done: npx specstocode done ${s.id.slice(0, 8)}
+  console.log(`  Mark done: stc done ${s.id.slice(0, 8)}
 `);
   if (opts.open) {
     openBrowser2(specUrl);
@@ -680,7 +680,7 @@ async function start() {
   } catch (err) {
     spinner.fail("  Failed to connect");
     console.error(`  ${err.message}`);
-    console.error("  Make sure you're logged in: npx specstocode login");
+    console.error("  Make sure you're logged in: stc login");
     closePrompt();
     return;
   }
@@ -752,14 +752,14 @@ async function start() {
   Failed to create project: ${data.error ?? "unknown error"}`);
       }
     } else {
-      console.error("\n  Failed to create project. Try logging in again: npx specstocode login");
+      console.error("\n  Failed to create project. Try logging in again: stc login");
     }
     closePrompt();
     return;
   }
   const createContentType = createRes.headers.get("content-type") ?? "";
   if (!createContentType.includes("application/json")) {
-    console.error("\n  Unexpected response from server. Try logging in again: npx specstocode login");
+    console.error("\n  Unexpected response from server. Try logging in again: stc login");
     closePrompt();
     return;
   }
@@ -824,7 +824,7 @@ async function start() {
   if (!readyToScope) {
     console.log(`
   No worries! When you're ready:
-    \u2022 Run: npx specstocode scope ${projectId}
+    \u2022 Run: stc scope ${projectId}
     \u2022 Or visit: ${API_BASE}
 
   Your project is saved and waiting for you.
@@ -832,7 +832,7 @@ async function start() {
     closePrompt();
     return;
   }
-  const { scope: scope2 } = await import("./scope-BY5WSTPD.js");
+  const { scope: scope2 } = await import("./scope-NBFWSZEP.js");
   await scope2(projectId);
 }
 
@@ -842,7 +842,7 @@ import { join as join3 } from "path";
 async function propose(changeName, opts = {}) {
   requireAuth();
   if (!hasConfig()) {
-    console.log("  Not connected to a project. Run `npx specstocode init` first.");
+    console.log("  Not connected to a project. Run `stc init` first.");
     closePrompt();
     return;
   }
@@ -984,9 +984,9 @@ async function propose(changeName, opts = {}) {
   Local spec saved at: pb-changes/${slug}/proposal.md
 
   Next:
-    npx specstocode next           \u2014 pick up the first story
-    npx specstocode status         \u2014 see full progress
-    npx specstocode sync           \u2014 refresh SPECSTOCODE.md
+    stc next           \u2014 pick up the first story
+    stc status         \u2014 see full progress
+    stc sync           \u2014 refresh SPECSTOCODE.md
   `);
   closePrompt();
 }
@@ -1136,7 +1136,7 @@ async function proposeFromFile(filePath, config, nameOverride) {
   writeFileSync3(join3(changesDir, "proposal.md"), proposalMd);
   console.log(`  \u2713 Saved pb-changes/${slug}/proposal.md`);
   console.log(`
-  \u2705 Done! Run \`npx specstocode next\` to start building.
+  \u2705 Done! Run \`stc next\` to start building.
 `);
 }
 
@@ -1153,7 +1153,7 @@ async function show(idPrefix) {
   if (!story) {
     console.error(`
   No story found matching "${idPrefix}"
-  Run \`productbuilders stories\` to list IDs.
+  Run \`stc stories\` to list IDs.
 `);
     process.exit(1);
   }
@@ -1200,7 +1200,7 @@ async function show(idPrefix) {
   const relPath = contextPath.replace(process.cwd() + "/", "");
   console.log(`
   Context  : ${relPath}`);
-  console.log(`  Mark done: npx productbuilders done ${story.id.slice(0, 8)}
+  console.log(`  Mark done: stc done ${story.id.slice(0, 8)}
 `);
 }
 
@@ -1664,7 +1664,7 @@ async function startMcpServer(mode = "all") {
 import { execSync as execSync2 } from "child_process";
 async function openclawRegister() {
   if (!hasConfig()) {
-    console.error("Not initialised. Run: npx specstocode init");
+    console.error("Not initialised. Run: stc init");
     process.exit(1);
   }
   const config = readConfig();
@@ -1703,7 +1703,7 @@ Registering specstocode MCP with OpenClaw...`);
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var program = new Command();
-program.name("specstocode").description("Write specs, map stories, ship with AI \u2014 from your terminal").version(version);
+program.name("stc").description("Write specs, map stories, ship with AI \u2014 from your terminal").version(version);
 program.command("login").description("Log in to specstocode (opens browser)").action(() => void login());
 program.command("logout").description("Log out of specstocode").action(() => void logout());
 program.command("start").description("Start a new project \u2014 guided flow from problem to pitch").action(() => void start());
@@ -1717,12 +1717,12 @@ program.command("templates [name]").description("Browse story map templates").ac
       console.log(`    ${key.padEnd(20)} ${tmpl.description}`);
     }
     console.log(`
-  Usage: npx specstocode templates <name>
+  Usage: stc templates <name>
 `);
   } else {
     const tmpl = templates[name];
     if (!tmpl) {
-      console.error(`Unknown template: "${name}". Run \`npx specstocode templates\` to list.`);
+      console.error(`Unknown template: "${name}". Run \`stc templates\` to list.`);
     } else {
       console.log(`
   ${tmpl.name}: ${tmpl.description}`);
@@ -1744,19 +1744,19 @@ program.command("show <id>").description("Show the full spec for a story (accept
 program.command("done <id>").description("Mark a story as done (accepts ID prefix)").action((id) => void done(id));
 program.command("add <title>").description("Create a new story").option("-a, --activity <activity>", "Activity to add the story under").option("-p, --priority <priority>", "Priority: must, should, could", "should").option("-e, --effort <effort>", "Effort: S, M, L, XL", "M").action((title, opts) => void add(title, opts));
 program.command("decide [title]").description("Log an architectural or product decision").option("-d, --description <desc>", "Decision description").option("-c, --category <cat>", "Category: architecture, product, technical, trade-off", "technical").option("-s, --story <id>", "Link to a story ID").action((title, opts) => {
-  import("./log-GSWUQF6Z.js").then((m) => void m.logDecision(title, opts));
+  import("./log-4OBVVVVF.js").then((m) => void m.logDecision(title, opts));
 });
 program.command("note <storyId> [note]").description("Add implementation notes to a story").action((storyId, note) => {
-  import("./log-GSWUQF6Z.js").then((m) => void m.logNote(storyId, note));
+  import("./log-4OBVVVVF.js").then((m) => void m.logNote(storyId, note));
 });
 program.command("complexity [storyId]").description("Analyze story complexity with AI \u2014 scores, risks, effort estimates").action((id) => {
-  import("./complexity-TUS6F2UI.js").then((m) => void m.complexity(id));
+  import("./complexity-27JMHAD2.js").then((m) => void m.complexity(id));
 });
 program.command("research [query]").description("Research a topic with AI using your project context").action((query) => {
-  import("./research-UGNKVMZ5.js").then((m) => void m.research(query));
+  import("./research-NRHBPB5Q.js").then((m) => void m.research(query));
 });
 program.command("import [file]").description("Import a PRD or spec into your story map as stories").action((file) => {
-  import("./import-prd-HP66GKRA.js").then((m) => void m.importPrd(file));
+  import("./import-prd-IOV3SEQV.js").then((m) => void m.importPrd(file));
 });
 program.command("mcp").description("Start MCP server for Claude Code / Cursor integration").option("-m, --mode <mode>", "Tool mode: core, standard, all", "all").action((opts) => void startMcpServer(opts.mode));
 program.command("openclaw-register").description("Register this project with OpenClaw MCP \u2014 gives spawned coding agents access to your story map").action(() => void openclawRegister());

package/dist/{log-GSWUQF6Z.js → log-4OBVVVVF.js}

@@ -1,14 +1,14 @@
 import {
   appendNoteToContext,
   storyContextPath
-} from "./chunk-J22FYEMI.js";
+} from "./chunk-CNJK6J3P.js";
 import {
   ask,
   closePrompt
 } from "./chunk-WPVDURTJ.js";
 import {
   requireConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/commands/log.ts
 async function logDecision(title, opts) {

package/dist/{research-UGNKVMZ5.js → research-NRHBPB5Q.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-WPVDURTJ.js";
 import {
   requireConfig
-} from "./chunk-NAOZWXOF.js";
+} from "./chunk-ZLSV4CRF.js";
 
 // src/commands/research.ts
 import ora from "ora";

package/dist/{scope-BY5WSTPD.js → scope-NBFWSZEP.js}

@@ -1,10 +1,10 @@
 import {
   scope
-} from "./chunk-P4M7CVDK.js";
-import "./chunk-CYA6I7NV.js";
+} from "./chunk-2FQUCTDE.js";
+import "./chunk-WJOIFYIA.js";
 import "./chunk-QKMZ2SBR.js";
 import "./chunk-WPVDURTJ.js";
-import "./chunk-NAOZWXOF.js";
+import "./chunk-ZLSV4CRF.js";
 export {
   scope
 };

package/dist/setup-ZJCK6JB4.js

@@ -0,0 +1,9 @@
+import {
+  setup
+} from "./chunk-T46QKLGM.js";
+import "./chunk-WJOIFYIA.js";
+import "./chunk-WPVDURTJ.js";
+import "./chunk-ZLSV4CRF.js";
+export {
+  setup
+};

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "specstocode",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "CLI for specstocode.com — connect your codebase to your product story map",
   "bin": {
     "specstocode": "bin/specstocode.js",
-    "productbuilders": "bin/productbuilders.js"
+    "productbuilders": "bin/productbuilders.js",
+    "stc": "bin/stc.js"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --clean && chmod +x dist/index.js && chmod +x bin/specstocode.js && chmod +x bin/productbuilders.js",
+    "build": "tsup src/index.ts --format esm --clean && chmod +x dist/index.js && chmod +x bin/specstocode.js && chmod +x bin/productbuilders.js && chmod +x bin/stc.js",
     "dev": "tsup src/index.ts --format esm --watch",
     "test": "vitest run",
     "prepublishOnly": "npm run build"

package/dist/setup-VBFEFGTK.js

@@ -1,9 +0,0 @@
-import {
-  setup
-} from "./chunk-55DTUCLY.js";
-import "./chunk-CYA6I7NV.js";
-import "./chunk-WPVDURTJ.js";
-import "./chunk-NAOZWXOF.js";
-export {
-  setup
-};