golem-cc 0.2.2 → 0.2.3

package/README.md

@@ -52,7 +52,7 @@ Golem is an autonomous coding loop that implements features while you watch (or
 │                  └────────────────────┘                         │
 │                              │                                  │
 │                              ▼                                  │
-│                        specs/*.md                               │
+│                      .golem/specs/*.md                          │
 │                              │                                  │
 ├──────────────────────────────┼──────────────────────────────────┤
 │                         GOLEM                                   │
@@ -63,7 +63,7 @@ Golem is an autonomous coding loop that implements features while you watch (or
 │                    └────────────────┘    vs. codebase           │
 │                              │                                  │
 │                              ▼                                  │
-│                   IMPLEMENTATION_PLAN.md                        │
+│               .golem/IMPLEMENTATION_PLAN.md                     │
 │                              │                                  │
 │                              ▼                                  │
 │                   ┌─────────────────┐                           │
@@ -126,7 +126,7 @@ golem run build
 Each iteration runs two separate sessions with fresh context:
 
 **Step 1: Implement**
-- Picks the next task from `IMPLEMENTATION_PLAN.md`
+- Picks the next task from `.golem/IMPLEMENTATION_PLAN.md`
 - Implements the feature/fix
 - Runs tests until they pass
 - Updates the plan
@@ -176,18 +176,18 @@ After running `golem --init`:
 
 ```
 my-project/
-├── .golem/
-│   ├── prompts/          # Loop instructions (customizable)
-│   │   ├── PROMPT_build.md
-│   │   └── PROMPT_plan.md
-│   └── agents/           # AI agent definitions
-│       ├── spec-builder.md
-│       └── code-simplifier.md
-├── specs/                # Your requirements (one file per topic)
-│   ├── authentication.md
-│   └── task-api.md
-├── AGENTS.md             # Test/build/lint commands
-└── IMPLEMENTATION_PLAN.md # Generated task list
+└── .golem/
+    ├── prompts/              # Loop instructions (customizable)
+    │   ├── PROMPT_build.md
+    │   └── PROMPT_plan.md
+    ├── agents/               # AI agent definitions
+    │   ├── spec-builder.md
+    │   └── code-simplifier.md
+    ├── specs/                # Your requirements (one file per topic)
+    │   ├── authentication.md
+    │   └── task-api.md
+    ├── AGENTS.md             # Test/build/lint commands
+    └── IMPLEMENTATION_PLAN.md  # Generated task list
 ```
 
 ## Writing Specs
@@ -223,7 +223,7 @@ User authentication for the API.
 
 ## Backpressure
 
-The loop uses your test suite as a quality gate. Configure in `AGENTS.md`:
+The loop uses your test suite as a quality gate. Configure in `.golem/AGENTS.md`:
 
 ```markdown
 # Operational Guide
@@ -256,7 +256,7 @@ If tests fail, it fixes and retries. If they pass, it moves on. Your tests are t
 
 **Simplification is not optional.** AI-written code tends toward verbosity. The simplifier pass keeps it clean.
 
-**You steer via specs, not prompts.** Change what you want by editing `specs/*.md`, not by micromanaging the AI.
+**You steer via specs, not prompts.** Change what you want by editing `.golem/specs/*.md`, not by micromanaging the AI.
 
 ## Based On
 

package/commands/golem/build.md

@@ -16,22 +16,22 @@ Execute the autonomous build loop: select a task, implement it, validate with te
 <context>
 Load specs:
 ```bash
-for f in specs/*.md; do echo "=== $f ==="; cat "$f"; echo; done 2>/dev/null
+for f in .golem/specs/*.md; do echo "=== $f ==="; cat "$f"; echo; done 2>/dev/null
 ```
 
 Load operational guide:
 ```bash
-cat AGENTS.md 2>/dev/null || echo "No AGENTS.md - run /golem:spec first"
+cat .golem/AGENTS.md 2>/dev/null || echo "No AGENTS.md - run /golem:spec first"
 ```
 
 Load implementation plan:
 ```bash
-cat IMPLEMENTATION_PLAN.md 2>/dev/null || echo "No plan - run /golem:plan first"
+cat .golem/IMPLEMENTATION_PLAN.md 2>/dev/null || echo "No plan - run /golem:plan first"
 ```
 
 Check remaining tasks:
 ```bash
-grep -c '^\- \[ \]' IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0"
+grep -c '^\- \[ \]' .golem/IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0"
 ```
 </context>
 
@@ -39,9 +39,9 @@ grep -c '^\- \[ \]' IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0"
 
 ## Pre-flight Checks
 
-1. Verify IMPLEMENTATION_PLAN.md exists
-2. Verify specs/ directory has files
-3. Verify AGENTS.md has test commands
+1. Verify .golem/IMPLEMENTATION_PLAN.md exists
+2. Verify .golem/specs/ directory has files
+3. Verify .golem/AGENTS.md has test commands
 4. Check for remaining tasks
 
 If missing prerequisites, instruct user to run appropriate command first.
@@ -51,7 +51,7 @@ If missing prerequisites, instruct user to run appropriate command first.
 For each iteration:
 
 ### 1. Orient
-- Read the current IMPLEMENTATION_PLAN.md
+- Read the current .golem/IMPLEMENTATION_PLAN.md
 - Review relevant specs for context
 
 ### 2. Select Task
@@ -71,17 +71,17 @@ For each iteration:
 - Keep changes minimal and focused
 
 ### 5. Validate (Backpressure)
-Run ALL gates from AGENTS.md. ALL must pass:
+Run ALL gates from .golem/AGENTS.md. ALL must pass:
 
 ```bash
 # Run test command
-{test_command from AGENTS.md}
+{test_command from .golem/AGENTS.md}
 
 # Run typecheck if configured
-{typecheck_command from AGENTS.md}
+{typecheck_command from .golem/AGENTS.md}
 
 # Run lint if configured
-{lint_command from AGENTS.md}
+{lint_command from .golem/AGENTS.md}
 ```
 
 If any gate fails:
@@ -103,7 +103,7 @@ Use the code-simplifier agent principles:
 Then re-run tests to confirm no regressions.
 
 ### 7. Update Plan
-Edit `IMPLEMENTATION_PLAN.md`:
+Edit `.golem/IMPLEMENTATION_PLAN.md`:
 - Change `[ ]` to `[x]` for completed task
 - Update status counts
 - Add notes about discoveries

package/commands/golem/help.md

@@ -33,7 +33,7 @@ WORKFLOW
 
   1. /golem:spec           Define requirements through conversation
   2. exit claude
-  3. golem run plan        Generate IMPLEMENTATION_PLAN.md (headless)
+  3. golem run plan        Generate .golem/IMPLEMENTATION_PLAN.md (headless)
   4. golem run build       Start autonomous coding loop (headless)
 
 Each build iteration:
@@ -43,12 +43,12 @@ Each build iteration:
   • Simplifies code
   • Commits and loops
 
-FILES
+FILES (all in .golem/ directory)
 
-  specs/                   Requirement files (one per topic)
-  AGENTS.md               Operational commands (test, build, lint)
-  IMPLEMENTATION_PLAN.md   Task list with priorities
-  .golem/                  Configuration and prompts
+  .golem/specs/                   Requirement files (one per topic)
+  .golem/AGENTS.md               Operational commands (test, build, lint)
+  .golem/IMPLEMENTATION_PLAN.md   Task list with priorities
+  .golem/prompts/                 Configuration and prompts
 
 CLI USAGE (outside Claude)
 

package/commands/golem/plan.md

@@ -5,7 +5,7 @@ allowed-tools: [Read, Write, Glob, Grep, Bash]
 ---
 
 <objective>
-Analyze specs versus existing code and create/update IMPLEMENTATION_PLAN.md with prioritized tasks.
+Analyze specs versus existing code and create/update .golem/IMPLEMENTATION_PLAN.md with prioritized tasks.
 </objective>
 
 <execution_context>
@@ -15,17 +15,17 @@ Analyze specs versus existing code and create/update IMPLEMENTATION_PLAN.md with
 <context>
 Load all specs:
 ```bash
-for f in specs/*.md; do echo "=== $f ==="; cat "$f"; echo; done 2>/dev/null || echo "No specs found - run /golem:spec first"
+for f in .golem/specs/*.md; do echo "=== $f ==="; cat "$f"; echo; done 2>/dev/null || echo "No specs found - run /golem:spec first"
 ```
 
 Load operational guide:
 ```bash
-cat AGENTS.md 2>/dev/null || echo "No AGENTS.md found"
+cat .golem/AGENTS.md 2>/dev/null || echo "No AGENTS.md found"
 ```
 
 Existing plan (if any):
 ```bash
-cat IMPLEMENTATION_PLAN.md 2>/dev/null || echo "No existing plan"
+cat .golem/IMPLEMENTATION_PLAN.md 2>/dev/null || echo "No existing plan"
 ```
 </context>
 
@@ -33,7 +33,7 @@ cat IMPLEMENTATION_PLAN.md 2>/dev/null || echo "No existing plan"
 
 ## 1. Read All Specs
 
-Read each file in `specs/` completely. Extract:
+Read each file in `.golem/specs/` completely. Extract:
 - Concrete requirements (must have, should have)
 - Acceptance criteria
 - Technical constraints
@@ -76,13 +76,13 @@ Order tasks by:
 
 ## 6. Write Plan
 
-Create or update `IMPLEMENTATION_PLAN.md`:
+Create or update `.golem/IMPLEMENTATION_PLAN.md`:
 
 ```markdown
 # Implementation Plan
 
 Generated: {ISO timestamp}
-Based on: specs/*.md
+Based on: .golem/specs/*.md
 
 ## Status
 - Total tasks: N
@@ -112,14 +112,14 @@ Notes: {notes}
 - [ ] Gap analysis completed
 - [ ] Tasks are atomic and testable
 - [ ] Dependencies mapped correctly
-- [ ] IMPLEMENTATION_PLAN.md written
+- [ ] .golem/IMPLEMENTATION_PLAN.md written
 - [ ] No code changes made (planning only)
 </success_criteria>
 
 <important>
 - Do NOT implement anything in planning mode
 - Do NOT modify source code
-- ONLY create/update IMPLEMENTATION_PLAN.md
+- ONLY create/update .golem/IMPLEMENTATION_PLAN.md
 - Be thorough - missing tasks cause problems later
 - Tasks should be achievable in one iteration
 </important>

package/commands/golem/status.md

@@ -21,23 +21,23 @@ echo ""
 # Specs
 echo "SPECS"
 echo "─────"
-if [ -d "specs" ]; then
-  count=$(ls -1 specs/*.md 2>/dev/null | wc -l | tr -d ' ')
+if [ -d ".golem/specs" ]; then
+  count=$(ls -1 .golem/specs/*.md 2>/dev/null | wc -l | tr -d ' ')
   echo "  Files: $count"
-  for f in specs/*.md; do
+  for f in .golem/specs/*.md; do
     [ -f "$f" ] && echo "    • $(basename "$f" .md)"
   done
 else
-  echo "  No specs/ directory - run /golem:spec"
+  echo "  No .golem/specs/ directory - run /golem:spec"
 fi
 echo ""
 
 # Plan
 echo "IMPLEMENTATION PLAN"
 echo "───────────────────"
-if [ -f "IMPLEMENTATION_PLAN.md" ]; then
-  total=$(grep -c '^\- \[' IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0")
-  done=$(grep -c '^\- \[x\]' IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0")
+if [ -f ".golem/IMPLEMENTATION_PLAN.md" ]; then
+  total=$(grep -c '^\- \[' .golem/IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0")
+  done=$(grep -c '^\- \[x\]' .golem/IMPLEMENTATION_PLAN.md 2>/dev/null || echo "0")
   remaining=$((total - done))
   pct=$((done * 100 / (total > 0 ? total : 1)))
 
@@ -49,7 +49,7 @@ if [ -f "IMPLEMENTATION_PLAN.md" ]; then
 
   # Show next few tasks
   echo "  Next tasks:"
-  grep '^\- \[ \]' IMPLEMENTATION_PLAN.md 2>/dev/null | head -3 | while read line; do
+  grep '^\- \[ \]' .golem/IMPLEMENTATION_PLAN.md 2>/dev/null | head -3 | while read line; do
     echo "    $line"
   done
 else
@@ -60,12 +60,12 @@ echo ""
 # AGENTS.md
 echo "OPERATIONAL GUIDE"
 echo "─────────────────"
-if [ -f "AGENTS.md" ]; then
-  echo "  ✓ AGENTS.md exists"
-  test_cmd=$(grep -A1 '### Testing' AGENTS.md 2>/dev/null | tail -1 | tr -d '`')
+if [ -f ".golem/AGENTS.md" ]; then
+  echo "  ✓ .golem/AGENTS.md exists"
+  test_cmd=$(grep -A1 '### Testing' .golem/AGENTS.md 2>/dev/null | tail -1 | tr -d '`')
   [ -n "$test_cmd" ] && echo "  Test: $test_cmd"
 else
-  echo "  No AGENTS.md - run /golem:spec"
+  echo "  No .golem/AGENTS.md - run /golem:spec"
 fi
 echo ""
 

package/golem/agents/code-simplifier.md

@@ -41,7 +41,7 @@ You simplify code and create a single, well-documented commit that covers both t
 - `*.test.ts`, `*.spec.ts` - test files
 - `*.d.ts` - type definitions
 - `*.config.*` - configuration
-- `IMPLEMENTATION_PLAN.md` - just stage it, don't simplify
+- `.golem/IMPLEMENTATION_PLAN.md` - just stage it, don't simplify
 
 ## Commit Message Format
 
@@ -95,7 +95,7 @@ Simplified:
 
 3. Run tests to verify:
    ```bash
-   {test_command from AGENTS.md}
+   {test_command from .golem/AGENTS.md}
    ```
 
 4. Stage any simplification changes:

package/golem/prompts/PROMPT_build.md

@@ -5,13 +5,13 @@ You are in BUILD MODE. Implement ONE task from the plan, then exit.
 ## Phase 0: Orient
 
 Study these files to understand context:
-- @specs/* - All specification files
-- @AGENTS.md - Operational commands (test/build/lint)
-- @IMPLEMENTATION_PLAN.md - Current task list
+- @.golem/specs/* - All specification files
+- @.golem/AGENTS.md - Operational commands (test/build/lint)
+- @.golem/IMPLEMENTATION_PLAN.md - Current task list
 
 ## Phase 1: Select Task
 
-1. Read IMPLEMENTATION_PLAN.md
+1. Read .golem/IMPLEMENTATION_PLAN.md
 2. Pick the first incomplete task (marked `- [ ]`)
 3. Do NOT assume something is not implemented - search first
 
@@ -24,7 +24,7 @@ Study these files to understand context:
 
 ## Phase 3: Validate (Backpressure)
 
-Run commands from AGENTS.md in order. ALL must pass:
+Run commands from .golem/AGENTS.md in order. ALL must pass:
 1. Tests
 2. Type check (if configured)
 3. Lint (if configured)
@@ -33,8 +33,8 @@ If ANY fails: fix the issue, then re-run ALL validation from the beginning.
 
 ## Phase 4: Complete
 
-1. Update IMPLEMENTATION_PLAN.md - mark task `- [x]`
-2. Update AGENTS.md learnings if you discovered something useful
+1. Update .golem/IMPLEMENTATION_PLAN.md - mark task `- [x]`
+2. Update .golem/AGENTS.md learnings if you discovered something useful
 3. Commit changes with descriptive message
 4. Exit
 

package/golem/prompts/PROMPT_plan.md

@@ -1,13 +1,13 @@
 # Planning Mode
 
-You are in PLANNING MODE. Analyze specs vs existing code and create IMPLEMENTATION_PLAN.md.
+You are in PLANNING MODE. Analyze specs vs existing code and create .golem/IMPLEMENTATION_PLAN.md.
 
 ## Phase 0: Orient
 
 Study these files first:
-- @specs/* - All specification files
-- @AGENTS.md - Operational commands
-- @IMPLEMENTATION_PLAN.md - Current plan (if exists)
+- @.golem/specs/* - All specification files
+- @.golem/AGENTS.md - Operational commands
+- @.golem/IMPLEMENTATION_PLAN.md - Current plan (if exists)
 
 ## Phase 1: Gap Analysis
 
@@ -19,7 +19,7 @@ Study these files first:
 
 ## Phase 2: Create Plan
 
-Write `IMPLEMENTATION_PLAN.md` with prioritized tasks:
+Write `.golem/IMPLEMENTATION_PLAN.md` with prioritized tasks:
 
 ```markdown
 # Implementation Plan

package/package.json

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