prjct-cli 0.54.0 → 0.54.1

package/CHANGELOG.md

@@ -1,12 +1,21 @@
 # Changelog
 
-## [0.54.0] - 2026-01-30
+## [0.54.1] - 2026-01-30
 
-### Features
+### Bug Fixes
+
+- Claude over-plans simple commands like p. sync - PRJ-148 (#83)
+
+
+## [0.55.2] - 2026-01-30
+
+### Fixed
 
-- Add showMetrics config option - PRJ-70 (#82)
-- Selective memory retrieval based on task relevance - PRJ-107 (#81)
-- Add session stats to p. stats command - PRJ-89 (#80)
+- **Claude over-plans simple commands** (PRJ-148)
+  - Added "⚡ FAST vs 🧠 SMART COMMANDS" section to CLAUDE.md
+  - FAST commands (sync, next, dash, pause, resume) now execute immediately without exploration/planning
+  - SMART commands (task, ship, bug, done) continue to use intelligent behavior
+  - Clarified that "Key Intelligence Rules" only apply to SMART commands
 
 
 ## [0.55.1] - 2026-01-30

package/dist/bin/prjct.mjs

@@ -25016,7 +25016,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.54.0",
+      version: "0.54.1",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.54.0",
+  "version": "0.54.1",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {

package/templates/global/CLAUDE.md

@@ -16,6 +16,50 @@ p. ship X   → templates/commands/ship.md
 
 ---
 
+## ⚡ FAST vs 🧠 SMART COMMANDS (CRITICAL)
+
+**Some commands just run a CLI. Others need intelligence. Know the difference.**
+
+### ⚡ FAST COMMANDS (Execute Immediately - NO planning, NO exploration)
+
+| Command | Action | Time |
+|---------|--------|------|
+| `p. sync` | Run `prjct sync` | <5s |
+| `p. next` | Run `prjct next` | <2s |
+| `p. dash` | Run `prjct dash` | <2s |
+| `p. pause` | Run `prjct pause` | <2s |
+| `p. resume` | Run `prjct resume` | <2s |
+
+**For these commands:**
+```
+1. Read template
+2. Run the CLI command shown
+3. Done
+```
+
+**⛔ DO NOT:** explore codebase, create plans, ask questions, read project files
+
+### 🧠 SMART COMMANDS (Require intelligence)
+
+| Command | Why it needs intelligence |
+|---------|--------------------------|
+| `p. task` | Must explore codebase, break down work |
+| `p. ship` | Must validate changes, create PR |
+| `p. bug` | Must classify severity, find affected files |
+| `p. done` | Must verify completion, update state |
+
+**For these commands:** Follow the full INTELLIGENT BEHAVIOR rules below.
+
+### Decision Rule
+```
+IF template just says "run CLI command":
+  → Execute immediately, no planning
+ELSE:
+  → Use intelligent behavior (explore, ask, plan)
+```
+
+---
+
 ## ⛔ CRITICAL RULES - READ BEFORE EVERY COMMAND
 
 ### 0. FOLLOW TEMPLATES STEP BY STEP (NON-NEGOTIABLE)
@@ -264,13 +308,15 @@ User Action → Storage (JSON) → Context (MD) → Sync Events
 4. Update CHANGELOG
 5. Create git tag
 
-### Key Intelligence Rules
+### Key Intelligence Rules (For 🧠 SMART commands only)
 - **Read before write** - Always read existing files before modifying
 - **Explore before coding** - Use Task(Explore) to understand codebase
 - **Ask when uncertain** - Use AskUserQuestion to clarify
-- **Adapt templates** - Templates are guidance, not rigid scripts
 - **Log everything** - Append to memory/events.jsonl
 
+**⚠️ These rules apply ONLY to 🧠 SMART commands (task, ship, bug, done).**
+**⚡ FAST commands skip all of this - just run the CLI.**
+
 ---
 
 ## OUTPUT FORMAT