golem-cc 0.1.10 → 0.1.12

package/README.md

@@ -46,9 +46,10 @@ Golem is an autonomous coding loop that implements features while you watch (or
 │   "I need user auth, a REST API for tasks, and filtering"      │
 │                              │                                  │
 │                              ▼                                  │
-│                      ┌──────────────┐                           │
-│                      │  golem spec  │  ← Interactive            │
-│                      └──────────────┘    conversation           │
+│                  ┌────────────────────┐                         │
+│                  │ claude             │  ← Interactive          │
+│                  │   → /golem:spec    │    conversation         │
+│                  └────────────────────┘                         │
 │                              │                                  │
 │                              ▼                                  │
 │                        specs/*.md                               │
@@ -57,17 +58,17 @@ Golem is an autonomous coding loop that implements features while you watch (or
 │                         GOLEM                                   │
 │                              │                                  │
 │                              ▼                                  │
-│                      ┌──────────────┐                           │
-│                      │  golem plan  │  ← Analyzes specs         │
-│                      └──────────────┘    vs. codebase           │
+│                    ┌────────────────┐                           │
+│                    │ golem run plan │  ← Analyzes specs         │
+│                    └────────────────┘    vs. codebase           │
 │                              │                                  │
 │                              ▼                                  │
 │                   IMPLEMENTATION_PLAN.md                        │
 │                              │                                  │
 │                              ▼                                  │
-│                      ┌──────────────┐                           │
-│                      │ golem build  │  ← Autonomous loop        │
-│                      └──────────────┘                           │
+│                   ┌─────────────────┐                           │
+│                   │ golem run build │  ← Autonomous loop        │
+│                   └─────────────────┘                           │
 │                              │                                  │
 │            ┌─────────────────┼─────────────────┐                │
 │            ▼                 ▼                 ▼                │
@@ -109,7 +110,9 @@ cd my-project
 golem --install
 
 # 2. Define what you're building (interactive)
-golem spec
+claude
+> /golem:spec
+> exit
 
 # 3. Generate the task list
 golem run plan
@@ -141,15 +144,25 @@ Then it loops. Fresh context each time. No degradation.
 
 ## Commands
 
+### CLI Commands
 | Command | Description |
 |---------|-------------|
 | `golem --install` | Initialize golem in current project |
-| `golem spec` | Build specs through guided conversation |
 | `golem run plan` | Create implementation plan from specs |
 | `golem run build` | Run the autonomous build loop |
 | `golem simplify` | Run code simplifier on demand |
 | `golem status` | Show progress |
 
+### Slash Commands (inside Claude)
+| Command | Description |
+|---------|-------------|
+| `/golem:spec` | Build specs through guided conversation |
+| `/golem:plan` | Create implementation plan |
+| `/golem:build` | Run build loop (single iteration) |
+| `/golem:simplify` | Run code simplifier |
+| `/golem:status` | Show project status |
+| `/golem:help` | Show all commands |
+
 ### Options
 
 ```bash

package/bin/golem

@@ -50,7 +50,6 @@ print_usage() {
     echo -e "${BLUE}Usage:${NC} golem <command> [options]"
     echo ""
     echo -e "${BLUE}Commands:${NC}"
-    echo "  spec              Build specs through guided conversation"
     echo "  run plan          Create implementation plan from specs"
     echo "  run build         Run autonomous build loop"
     echo "  simplify [path]   Run code simplifier"
@@ -63,9 +62,9 @@ print_usage() {
     echo "  --no-simplify     Skip code simplification in build loop"
     echo ""
     echo -e "${BLUE}Workflow:${NC}"
-    echo "  1. golem spec              Define requirements"
-    echo "  2. golem run plan          Generate task list"
-    echo "  3. golem run build         Autonomous implementation"
+    echo "  1. claude → /golem:spec    Define requirements (interactive)"
+    echo "  2. golem run plan          Generate implementation plan"
+    echo "  3. golem run build         Autonomous build loop"
 }
 
 # Check if golem is installed in current project
@@ -145,7 +144,7 @@ EOF
     echo -e "${GREEN}✓${NC} Created specs/ directory"
     echo ""
     echo -e "${BLUE}Next steps:${NC}"
-    echo -e "  1. Run ${CYAN}golem spec${NC} to define requirements"
+    echo -e "  1. Run ${CYAN}claude${NC} then ${CYAN}/golem:spec${NC} to define requirements"
     echo -e "  2. Run ${CYAN}golem run plan${NC} to create implementation plan"
     echo -e "  3. Run ${CYAN}golem run build${NC} to start autonomous coding"
 }
@@ -212,104 +211,20 @@ EOF
     fi
 }
 
-# Build specs through conversation
+# Show spec workflow hint
 cmd_spec() {
-    check_installed
     print_banner
     echo -e "${BLUE}Spec Builder${NC}"
-    echo -e "${DIM}Type 'done' when finished, Ctrl+C to exit${NC}"
     echo ""
-
-    local spec_prompt="You are a spec-builder agent helping define project requirements.
-
-Your workflow:
-1. Ask what they're building and the core problem it solves
-2. Break down the project into distinct topics of concern (3-7 topics)
-3. For each topic, ask clarifying questions then create a spec file in specs/
-4. Finally, create/update AGENTS.md with test/build/lint commands
-
-Spec file format (save to specs/{topic-name}.md):
-# {Topic Name}
-## Purpose
-## Requirements (Must Have, Should Have, Must Not)
-## Acceptance Criteria
-
-Keep responses concise. Ask one question at a time."
-
-    local tmp_err=$(mktemp)
-    trap "rm -f $tmp_err" EXIT
-
-    # Helper to run claude and handle errors
-    run_claude() {
-        local output
-        local exit_code
-
-        output=$(claude "$@" 2>"$tmp_err")
-        exit_code=$?
-
-        if [[ $exit_code -ne 0 ]] || grep -q "API Error" "$tmp_err" 2>/dev/null; then
-            local err_msg=$(cat "$tmp_err")
-            if [[ "$err_msg" == *"tool_use"* ]] || [[ "$err_msg" == *"invalid_request_error"* ]]; then
-                echo ""
-                echo -e "${YELLOW}Session corrupted. Starting fresh...${NC}"
-                echo ""
-                return 1
-            else
-                echo -e "${RED}Error: $err_msg${NC}"
-                return 1
-            fi
-        fi
-
-        echo "$output"
-        return 0
-    }
-
-    # First message - starts a new session
-    echo -e "${CYAN}Claude:${NC}"
-    if ! run_claude -p --dangerously-skip-permissions --append-system-prompt "$spec_prompt" \
-        "Start the spec-building conversation. Ask what I'm building."; then
-        echo -e "${RED}Failed to start session${NC}"
-        return 1
-    fi
+    echo -e "To build specs, run ${CYAN}claude${NC} and use the ${CYAN}/golem:spec${NC} command."
+    echo ""
+    echo -e "${DIM}Workflow:${NC}"
+    echo -e "  1. ${CYAN}claude${NC}              - Start Claude Code"
+    echo -e "  2. ${CYAN}/golem:spec${NC}         - Build specs through conversation"
+    echo -e "  3. ${CYAN}exit${NC}                - Exit when done"
+    echo -e "  4. ${CYAN}golem run plan${NC}      - Generate implementation plan"
+    echo -e "  5. ${CYAN}golem run build${NC}     - Run autonomous build loop"
     echo ""
-
-    # Conversation loop
-    local restart_needed=false
-    while true; do
-        echo -ne "${GREEN}You:${NC} "
-        read -r user_input
-
-        [[ -z "$user_input" ]] && continue
-        [[ "$user_input" == "done" ]] && {
-            echo ""
-            echo -e "${GREEN}Done!${NC} Specs saved to specs/"
-            echo -e "Next: Run ${CYAN}golem run plan${NC} to create implementation plan"
-            break
-        }
-
-        echo ""
-        echo -e "${CYAN}Claude:${NC}"
-        if ! run_claude -p --continue --dangerously-skip-permissions "$user_input"; then
-            # Session error - offer to restart
-            echo -e "${YELLOW}Would you like to start a new session? (y/n)${NC} "
-            read -r restart_choice
-            if [[ "$restart_choice" == "y" ]]; then
-                echo ""
-                echo -e "${BLUE}Starting new session...${NC}"
-                echo -e "${DIM}Paste your previous context to continue where you left off.${NC}"
-                echo ""
-                echo -e "${CYAN}Claude:${NC}"
-                if ! run_claude -p --dangerously-skip-permissions --append-system-prompt "$spec_prompt" \
-                    "Start the spec-building conversation. Ask what I'm building."; then
-                    echo -e "${RED}Failed to start new session${NC}"
-                    return 1
-                fi
-            else
-                echo -e "${DIM}Type 'done' to exit or try again${NC}"
-            fi
-        fi
-        echo ""
-    done
 }
 
 # Run the loop (plan or build mode)

package/bin/install.cjs

@@ -53,15 +53,18 @@ if (hasHelp) {
 
   ${yellow}After Installation:${reset}
     golem --install    Install golem to current project
-    golem spec         Build specs through conversation
     golem run plan     Create implementation plan
     golem run build    Run autonomous build loop
     golem simplify     Simplify code
     golem status       Show project status
 
   ${yellow}Slash Commands (inside Claude):${reset}
-    /golem:help        Show all commands
+    /golem:spec        Build specs through conversation
+    /golem:plan        Create implementation plan
+    /golem:build       Run build loop iteration
+    /golem:simplify    Simplify code
     /golem:status      Show project status
+    /golem:help        Show all commands
 `);
   process.exit(0);
 }
@@ -278,9 +281,9 @@ function install(isGlobal) {
   2. Run ${cyan}golem --install${reset} in your project directory
 
   ${yellow}Workflow:${reset}
-  golem spec        → Define requirements through conversation
-  golem run plan    → Generate implementation plan
-  golem run build   → Run autonomous coding loop
+  claude → /golem:spec  → Define requirements (interactive)
+  golem run plan        → Generate implementation plan
+  golem run build       → Run autonomous coding loop
 `);
 }
 

package/commands/golem/help.md

@@ -31,9 +31,10 @@ UTILITY COMMANDS
 
 WORKFLOW
 
-  1. Run /golem:spec to define requirements through conversation
-  2. Run /golem:plan to generate IMPLEMENTATION_PLAN.md
-  3. Run /golem:build to start the autonomous coding loop
+  1. /golem:spec           Define requirements through conversation
+  2. exit claude
+  3. golem run plan        Generate IMPLEMENTATION_PLAN.md (headless)
+  4. golem run build       Start autonomous coding loop (headless)
 
 Each build iteration:
   • Selects highest-priority task
@@ -49,10 +50,12 @@ FILES
   IMPLEMENTATION_PLAN.md   Task list with priorities
   .golem/                  Configuration and prompts
 
-CLI USAGE
+CLI USAGE (outside Claude)
 
-  golem                    Launch Claude Code
-  golem --yolo             Launch with --dangerously-skip-permissions
-  golem --install          Install/update golem in a project
+  golem --install          Install golem in a project
+  golem run plan           Generate implementation plan
+  golem run build          Run autonomous build loop
+  golem simplify           Simplify code
+  golem status             Show project status
 ```
 </process>

package/golem/agents/spec-builder.md

@@ -140,8 +140,8 @@ When all specs and AGENTS.md are written:
    ```
    Next steps:
    1. Review specs/ files and adjust if needed
-   2. Run 'golem-ralph run plan' to create implementation plan
-   3. Run 'golem-ralph run build' to start autonomous coding
+   2. Exit Claude, then run 'golem run plan' to create implementation plan
+   3. Run 'golem run build' to start autonomous coding
    ```
 3. Ask if they want to make any changes before proceeding
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "golem-cc",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Autonomous coding loop with Claude - structured specs, ralph loop execution, code simplification",
   "bin": {
     "golem-cc": "./bin/install.cjs"