prjct-cli 0.18.0 → 0.18.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.18.2] - 2025-12-15
+
+### Fix: Agents Write to Global Storage
+
+Fixed critical bug where sub-agents were being written to project's local `.claude/agents/` directory instead of global storage.
+
+- **Bug**: `/p:sync` created agents in `{projectPath}/.claude/agents/` polluting local projects
+- **Fix**: Agents now correctly write to `~/.prjct-cli/projects/{projectId}/agents/`
+
+**Files Modified:**
+- `templates/commands/sync.md` - Changed all agent paths from `{cwd}/.claude/agents/` to `{globalPath}/agents/`
+- `templates/agentic/subagent-generation.md` - Updated paths and added critical rules
+
 ## [0.16.0] - 2025-12-15
 
 ### Dead Code Cleanup

package/core/agentic/agent-router.ts

@@ -2,14 +2,13 @@
  * Agent Router
  * Orchestrates agent loading and context building for Claude delegation.
  *
- * Loads agents from two locations:
- * 1. {projectPath}/.claude/agents/ - Claude Code sub-agents (PRIMARY, per-project)
- * 2. ~/.prjct-cli/projects/{id}/agents/ - Legacy agents (fallback)
+ * Loads agents from global storage:
+ * ~/.prjct-cli/projects/{id}/agents/
  *
- * Claude Code sub-agents are prioritized as they're more specific to the project.
+ * Agents are dynamically generated by /p:sync based on project tech stack.
  *
  * @module agentic/agent-router
- * @version 3.0.0
+ * @version 4.0.0
  */
 
 import fs from 'fs/promises'
@@ -20,7 +19,6 @@ import pathManager from '../infrastructure/path-manager'
 interface Agent {
   name: string
   content: string
-  source: 'claude-code' | 'legacy'
 }
 
 interface AssignmentContext {
@@ -38,15 +36,7 @@ interface AssignmentContext {
 class AgentRouter {
   projectId: string | null = null
   projectPath: string | null = null
-  legacyAgentsPath: string | null = null
-
-  /**
-   * Get path to Claude Code sub-agents directory
-   */
-  getClaudeCodeAgentsPath(): string | null {
-    if (!this.projectPath) return null
-    return path.join(this.projectPath, '.claude', 'agents')
-  }
+  agentsPath: string | null = null
 
   /**
    * Initialize router with project context
@@ -54,25 +44,24 @@ class AgentRouter {
   async initialize(projectPath: string): Promise<void> {
     this.projectId = await configManager.getProjectId(projectPath)
     this.projectPath = projectPath
-    this.legacyAgentsPath = pathManager.getFilePath(this.projectId!, 'agents', '')
+    this.agentsPath = pathManager.getFilePath(this.projectId!, 'agents', '')
   }
 
   /**
-   * Load agents from a specific directory
+   * Load all available agents from global storage
    */
-  private async loadAgentsFromPath(
-    agentsPath: string,
-    source: 'claude-code' | 'legacy'
-  ): Promise<Agent[]> {
+  async loadAvailableAgents(): Promise<Agent[]> {
+    if (!this.agentsPath) return []
+
     try {
-      const files = await fs.readdir(agentsPath)
+      const files = await fs.readdir(this.agentsPath)
       const agents: Agent[] = []
 
       for (const file of files) {
         if (file.endsWith('.md')) {
           const name = file.replace('.md', '')
-          const content = await fs.readFile(path.join(agentsPath, file), 'utf-8')
-          agents.push({ name, content, source })
+          const content = await fs.readFile(path.join(this.agentsPath, file), 'utf-8')
+          agents.push({ name, content })
         }
       }
 
@@ -82,33 +71,6 @@ class AgentRouter {
     }
   }
 
-  /**
-   * Load all available agents from both Claude Code and legacy locations
-   * Claude Code sub-agents take priority over legacy agents with same name
-   */
-  async loadAvailableAgents(): Promise<Agent[]> {
-    const agentMap = new Map<string, Agent>()
-
-    // Load legacy agents first (lower priority)
-    if (this.legacyAgentsPath) {
-      const legacyAgents = await this.loadAgentsFromPath(this.legacyAgentsPath, 'legacy')
-      for (const agent of legacyAgents) {
-        agentMap.set(agent.name, agent)
-      }
-    }
-
-    // Load Claude Code sub-agents (higher priority - overwrites legacy)
-    const claudeCodePath = this.getClaudeCodeAgentsPath()
-    if (claudeCodePath) {
-      const claudeCodeAgents = await this.loadAgentsFromPath(claudeCodePath, 'claude-code')
-      for (const agent of claudeCodeAgents) {
-        agentMap.set(agent.name, agent)
-      }
-    }
-
-    return Array.from(agentMap.values())
-  }
-
   /**
    * Get list of available agent names
    */
@@ -118,34 +80,18 @@ class AgentRouter {
   }
 
   /**
-   * Load a specific agent by name
-   * Checks Claude Code sub-agents first, then falls back to legacy
+   * Load a specific agent by name from global storage
    */
   async loadAgent(name: string): Promise<Agent | null> {
-    // Try Claude Code sub-agents first (higher priority)
-    const claudeCodePath = this.getClaudeCodeAgentsPath()
-    if (claudeCodePath) {
-      try {
-        const filePath = path.join(claudeCodePath, `${name}.md`)
-        const content = await fs.readFile(filePath, 'utf-8')
-        return { name, content, source: 'claude-code' }
-      } catch {
-        // Not found in Claude Code path, try legacy
-      }
-    }
+    if (!this.agentsPath) return null
 
-    // Fall back to legacy agents
-    if (this.legacyAgentsPath) {
-      try {
-        const filePath = path.join(this.legacyAgentsPath, `${name}.md`)
-        const content = await fs.readFile(filePath, 'utf-8')
-        return { name, content, source: 'legacy' }
-      } catch {
-        // Not found
-      }
+    try {
+      const filePath = path.join(this.agentsPath, `${name}.md`)
+      const content = await fs.readFile(filePath, 'utf-8')
+      return { name, content }
+    } catch {
+      return null
     }
-
-    return null
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.ts",
   "bin": {

package/templates/agentic/subagent-generation.md

@@ -11,7 +11,7 @@ You have access to:
 
 ## Output Location
 
-Write sub-agents to: `{projectPath}/.claude/agents/`
+Write sub-agents to: `{globalPath}/agents/` (global storage, NOT local project)
 
 ## Sub-Agent Format (Claude Code)
 
@@ -70,29 +70,29 @@ Each generated agent should include:
 
 1. **Read Analysis**
    ```
-   Read("{projectPath}/.prjct-cli/projects/{projectId}/analysis/repo-summary.md")
+   Read("{globalPath}/analysis/repo-summary.md")
    ```
 
 2. **Create Directory**
    ```
-   Bash("mkdir -p {projectPath}/.claude/agents")
+   Bash("mkdir -p {globalPath}/agents")
    ```
 
 3. **Generate Workflow Agents** (always)
    - Read template from `templates/subagents/workflow/prjct-workflow.md`
    - Adapt with project context
-   - Write to `{projectPath}/.claude/agents/prjct-workflow.md`
+   - Write to `{globalPath}/agents/prjct-workflow.md`
    - Repeat for prjct-planner.md and prjct-shipper.md
 
 4. **Generate Domain Agents** (based on analysis)
    - For each detected technology stack:
      - Read corresponding template from `templates/subagents/domain/`
      - Adapt with project-specific details
-     - Write to `{projectPath}/.claude/agents/`
+     - Write to `{globalPath}/agents/`
 
 5. **Report Generated Agents**
    ```
-   Generated sub-agents in .claude/agents/:
+   Generated sub-agents in {globalPath}/agents/:
    - prjct-workflow.md (workflow)
    - prjct-planner.md (workflow)
    - prjct-shipper.md (workflow)
@@ -102,6 +102,8 @@ Each generated agent should include:
 
 ## Critical Rules
 
+- **NEVER write agents to local project directories** (`.claude/`, `.prjct/`)
+- **ALWAYS write agents to `{globalPath}/agents/`** (global storage)
 - NEVER hardcode technology detection in TypeScript
 - ALWAYS read and analyze repo-summary.md
 - ADAPT templates to project context

package/templates/commands/sync.md

@@ -54,6 +54,42 @@ Git Analysis → Storage (JSON) → Context (MD) → Project Metadata
 
 ---
 
+## Step 0: Migration Check (Legacy Projects)
+
+CHECK: Does `.prjct/prjct.config.json` exist?
+
+IF file exists:
+  READ: `.prjct/prjct.config.json`
+  CHECK: Does `projectId` exist and is it a valid UUID?
+
+  IF projectId is missing OR not a UUID:
+    MIGRATE to UUID:
+    1. Generate new UUID: `{newProjectId}`
+    2. Create global structure: `~/.prjct-cli/projects/{newProjectId}/`
+    3. Create subdirectories: storage/, context/, agents/, memory/, analysis/
+    4. IF legacy data exists in `.prjct/`:
+       - Migrate core/now.md → storage/state.json
+       - Migrate planning/ideas.md → storage/ideas.json
+       - Migrate progress/shipped.md → storage/shipped.json
+    5. Update `.prjct/prjct.config.json` with new `projectId`
+    OUTPUT: "🔄 Migrated to UUID format: {newProjectId}"
+
+IF file not found:
+  CHECK: Does `.prjct/` directory exist? (legacy project without config)
+
+  IF `.prjct/` exists:
+    MIGRATE:
+    1. Generate new UUID: `{newProjectId}`
+    2. Create `.prjct/prjct.config.json` with `projectId`
+    3. Create global structure
+    4. Migrate legacy data
+    OUTPUT: "🔄 Migrated legacy project to UUID: {newProjectId}"
+  ELSE:
+    OUTPUT: "No prjct project. Run /p:init first."
+    STOP
+
+---
+
 ## Step 1: Read Config
 
 READ: `.prjct/prjct.config.json`
@@ -338,12 +374,12 @@ WRITE: `{globalPath}/project.json`
 
 ## Step 7: Generate Claude Code Sub-Agents (AGENTIC)
 
-Generate sub-agents for Claude Code in the PROJECT's `.claude/agents/` directory.
+Generate sub-agents for Claude Code in the GLOBAL storage `{globalPath}/agents/` directory.
 
 ### 7.1 Create Directory
 
 ```bash
-mkdir -p {cwd}/.claude/agents
+mkdir -p {globalPath}/agents
 ```
 
 ### 7.2 Read Generation Instructions
@@ -362,17 +398,17 @@ These 3 agents are ALWAYS created for every prjct project:
 **prjct-workflow.md** - Handles: /p:now, /p:done, /p:next, /p:pause, /p:resume
 READ template: `templates/subagents/workflow/prjct-workflow.md`
 ADAPT with: projectId, projectPath
-WRITE to: `{cwd}/.claude/agents/prjct-workflow.md`
+WRITE to: `{globalPath}/agents/prjct-workflow.md`
 
 **prjct-planner.md** - Handles: /p:feature, /p:idea, /p:spec, /p:bug
 READ template: `templates/subagents/workflow/prjct-planner.md`
 ADAPT with: projectId, projectPath
-WRITE to: `{cwd}/.claude/agents/prjct-planner.md`
+WRITE to: `{globalPath}/agents/prjct-planner.md`
 
 **prjct-shipper.md** - Handles: /p:ship
 READ template: `templates/subagents/workflow/prjct-shipper.md`
 ADAPT with: projectId, projectPath, detected test/lint commands
-WRITE to: `{cwd}/.claude/agents/prjct-shipper.md`
+WRITE to: `{globalPath}/agents/prjct-shipper.md`
 
 ### 7.4 Generate Domain Agents (Based on Stack)
 
@@ -389,7 +425,7 @@ Analyze `{techStack}` from Step 3 and generate ONLY relevant domain agents:
 For EACH detected stack:
 1. READ template from `templates/subagents/domain/{name}.md`
 2. ADAPT description with detected frameworks (e.g., "React specialist" not just "frontend")
-3. WRITE to `{cwd}/.claude/agents/{name}.md`
+3. WRITE to `{globalPath}/agents/{name}.md`
 
 ### 7.5 Report Generated Agents
 
@@ -537,7 +573,7 @@ Next: /p:now to start a new task
 │   └── events.jsonl
 └── project.json             # Metadata
 
-{cwd}/.claude/agents/         # Claude Code Sub-Agents (PER PROJECT)
+# Sub-Agents are in {globalPath}/agents/ (NOT in project .claude/)
 ├── prjct-workflow.md        # /p:now, /p:done, /p:next
 ├── prjct-planner.md         # /p:feature, /p:idea, /p:spec
 ├── prjct-shipper.md         # /p:ship