prjct-cli 0.56.0 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "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

@@ -5,15 +5,17 @@
 
 ## HOW TO USE PRJCT (Read This First)
 
-When user types `p. <command>`, load the template from `templates/commands/{command}.md` and execute it.
+When user types `p. <command>`, **READ the template** from `~/.claude/commands/p/{command}.md` and execute it step by step.
 
 ```
-p. sync     → templates/commands/sync.md
-p. task X   → templates/commands/task.md
-p. done     → templates/commands/done.md
-p. ship X   → templates/commands/ship.md
+p. sync     → ~/.claude/commands/p/sync.md
+p. task X   → ~/.claude/commands/p/task.md
+p. done     → ~/.claude/commands/p/done.md
+p. ship X   → ~/.claude/commands/p/ship.md
 ```
 
+**⚠️ ALWAYS use the Read tool on the template file first. Templates contain mandatory workflows.**
+
 ---
 
 ## ⚡ FAST vs 🧠 SMART COMMANDS (CRITICAL)
@@ -389,17 +391,31 @@ Next: [suggested action]
 
 ---
 
-## LOADING DOMAIN AGENTS
+## LOADING DOMAIN AGENTS (CRITICAL)
+
+**Before starting any 🧠 SMART command (task, ship, bug, done):**
+
+```
+1. Read .prjct/prjct.config.json → get projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Read relevant agents from {globalPath}/agents/:
+   - prjct-planner.md → for task planning (p. task)
+   - prjct-shipper.md → for shipping (p. ship)
+   - prjct-workflow.md → for task lifecycle (p. done, p. pause)
+   - backend.md, frontend.md → for domain-specific coding
+```
 
-When working on tasks, load relevant agents from `{globalPath}/agents/`:
+**Available agents** (read the ones relevant to your task):
+- `prjct-planner.md` - Task planning, subtask breakdown
+- `prjct-shipper.md` - PR creation, version bumping
+- `prjct-workflow.md` - Task state management
 - `frontend.md` - Frontend patterns, components
 - `backend.md` - Backend patterns, APIs
 - `database.md` - Database patterns, queries
-- `uxui.md` - UX/UI guidelines
 - `testing.md` - Testing patterns
 - `devops.md` - CI/CD, containers
 
-These agents contain project-specific patterns. **USE THEM**.
+**USE the agent context when working.** Agents contain project-specific patterns.
 
 ---
 

package/templates/global/modules/CLAUDE-core.md

@@ -4,15 +4,34 @@
 
 ## HOW TO USE PRJCT
 
-When user types `p. <command>`, load the template from `templates/commands/{command}.md` and execute it.
+When user types `p. <command>`, **READ the template** from `~/.claude/commands/p/{command}.md` and execute it step by step.
 
 ```
-p. sync     → templates/commands/sync.md
-p. task X   → templates/commands/task.md
-p. done     → templates/commands/done.md
-p. ship X   → templates/commands/ship.md
+p. sync     → ~/.claude/commands/p/sync.md
+p. task X   → ~/.claude/commands/p/task.md
+p. done     → ~/.claude/commands/p/done.md
+p. ship X   → ~/.claude/commands/p/ship.md
 ```
 
+**⚠️ ALWAYS Read() the template file first. Templates contain mandatory workflows.**
+
+---
+
+## LOADING DOMAIN AGENTS (CRITICAL)
+
+**Before starting any 🧠 SMART command (task, ship, bug, done):**
+
+```
+1. Read .prjct/prjct.config.json → get projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Read {globalPath}/agents/*.md for domain expertise:
+   - prjct-planner.md → for task planning
+   - prjct-shipper.md → for shipping
+   - backend.md, frontend.md, etc → for domain-specific work
+```
+
+**USE the agent context when working.** Agents contain project-specific patterns.
+
 ---
 
 ## CRITICAL RULES