prjct-cli 0.10.4 → 0.10.6

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [0.10.6] - 2025-11-27
+
+### Enhanced
+
+- **Global CLAUDE.md Template** - Improved to help Claude use prjct-cli better
+  - Quick command reference table with examples
+  - Recommended workflow (sync → feature → now → done → ship)
+  - Common usage patterns with examples
+  - Anti-patterns table (what NOT to do)
+  - Using agents effectively section
+  - Simplified file structure overview
+  - Error handling table
+
+## [0.10.5] - 2025-11-27
+
+### Enhanced
+
+- **Rich Project Context** - CLAUDE.md now includes comprehensive project info
+  - Quick reference table (project, stack, files, commits, contributors)
+  - Full tech stack details (languages, frameworks, dependencies)
+  - Project structure (directories)
+  - Agent summaries with roles and expertise
+  - Current task and priority queue (top 5)
+  - Active roadmap features
+  - Recent ideas (top 3)
+  - Git activity (last 5 commits)
+  - Deep dive section with file paths for detailed info
+
+- **Reduced LLM Context Overhead** - Claude gets all key info in one file instead of reading multiple
+
 ## [0.10.4] - 2025-11-27
 
 ### Fixed

package/core/context-sync.js

@@ -1,11 +1,14 @@
 /**
- * Context Sync - Generates dynamic project context for Claude
+ * Context Sync - Generates RICH dynamic project context for Claude
  *
  * Creates ~/.prjct-cli/projects/{id}/CLAUDE.md with:
- * - Stack info
- * - Available agents (dynamic, varies per project)
- * - Current task
- * - Priority queue
+ * - Full stack info (languages, frameworks, dependencies)
+ * - Project structure and stats
+ * - Agent expertise summaries
+ * - Current task and priority queue
+ * - Active features from roadmap
+ *
+ * GOAL: Give Claude ALL the context it needs WITHOUT extra file reads
  *
  * Called by: /p:sync, /p:analyze, /p:init
  */
@@ -15,17 +18,27 @@ const path = require('path')
 const os = require('os')
 
 /**
- * Generate project context file for Claude
- * 100% DYNAMIC - reads whatever agents exist
+ * Generate RICH project context file for Claude
+ * Embeds key information so Claude doesn't need to read multiple files
  *
  * @param {string} projectPath - Local project path
  * @param {string} projectId - Project ID from config
- * @returns {Promise<{agents: string[], stack: string|null, currentTask: string|null}>}
+ * @returns {Promise<{agents: string[], stack: object, currentTask: string|null}>}
  */
 async function generateLocalContext(projectPath, projectId) {
   const globalPath = path.join(os.homedir(), '.prjct-cli/projects', projectId)
+  const projectName = path.basename(projectPath)
+
+  // Helper to read files safely
+  const readSafe = async (p) => {
+    try {
+      return await fs.readFile(p, 'utf-8')
+    } catch {
+      return null
+    }
+  }
 
-  // 1. Read ALL agents that exist (dynamic - varies per project)
+  // 1. Read ALL data sources in parallel
   const agentsDir = path.join(globalPath, 'agents')
   let agentFiles = []
   try {
@@ -35,91 +48,210 @@ async function generateLocalContext(projectPath, projectId) {
     // No agents directory yet
   }
 
-  // 2. Read core files (may not exist)
-  const readSafe = async (p) => {
-    try {
-      return await fs.readFile(p, 'utf-8')
-    } catch {
-      return null
-    }
-  }
-
-  const [repoSummary, now, next, roadmap] = await Promise.all([
+  const [repoSummary, now, next, roadmap, ideas] = await Promise.all([
     readSafe(path.join(globalPath, 'analysis/repo-summary.md')),
     readSafe(path.join(globalPath, 'core/now.md')),
     readSafe(path.join(globalPath, 'core/next.md')),
-    readSafe(path.join(globalPath, 'planning/roadmap.md'))
+    readSafe(path.join(globalPath, 'planning/roadmap.md')),
+    readSafe(path.join(globalPath, 'planning/ideas.md'))
   ])
 
-  // 3. Extract stack from repo-summary
-  const stack = extractStack(repoSummary)
+  // 2. Extract RICH stack info from repo-summary
+  const stackInfo = extractFullStack(repoSummary)
+
+  // 3. Extract project structure from repo-summary
+  const projectStructure = extractProjectStructure(repoSummary)
+
+  // 4. Extract git stats
+  const gitStats = extractGitStats(repoSummary)
 
-  // 4. Generate agent list with clean names
-  const agents = agentFiles.map(f => f.replace('.md', ''))
+  // 5. Read agent expertise (just the key parts, not full templates)
+  const agentExpertise = await extractAgentExpertise(agentsDir, agentFiles)
 
-  // 5. Extract current task
+  // 6. Extract current task
   const currentTask = extractCurrentTask(now)
 
-  // 6. Extract top 3 from next.md
-  const nextTasks = extractTopTasks(next, 3)
+  // 7. Extract priority queue (top 5)
+  const nextTasks = extractTopTasks(next, 5)
 
-  // 7. Extract active features from roadmap
+  // 8. Extract active features from roadmap
   const activeFeatures = extractActiveFeatures(roadmap)
 
-  // 8. Generate CLAUDE.md content
-  const content = `# Project Context
-<!-- Auto-generated by /p:sync - DO NOT EDIT -->
+  // 9. Extract recent ideas
+  const recentIdeas = extractRecentIdeas(ideas)
+
+  // 10. Generate RICH CLAUDE.md content
+  const content = `# ${projectName} - Project Context
+<!-- Auto-generated by /p:sync - DO NOT EDIT MANUALLY -->
 <!-- projectId: ${projectId} -->
 <!-- Last sync: ${new Date().toISOString()} -->
 
-## Stack
-${stack || 'Run /p:analyze to detect stack'}
+## Quick Reference
+
+| Attribute | Value |
+|-----------|-------|
+| **Project** | ${projectName} |
+| **Stack** | ${stackInfo.primary || 'Not detected'} |
+| **Files** | ${projectStructure.fileCount || '?'} |
+| **Commits** | ${gitStats.commits || '?'} |
+| **Contributors** | ${gitStats.contributors || '?'} |
+
+## Tech Stack
+
+${stackInfo.full || 'Run /p:analyze to detect stack'}
+
+## Project Structure
+
+${projectStructure.directories?.length ? projectStructure.directories.map(d => `- \`${d}/\``).join('\n') : 'Run /p:analyze to detect structure'}
 
 ## Available Agents
-${agents.length ? agents.map(a => `- ${a}`).join('\n') : 'None. Run /p:sync to generate.'}
 
-## Current Task
-${currentTask || 'None. Use /p:now to start.'}
+${agentExpertise.length ? agentExpertise.map(a => `### ${a.name}
+- **Role**: ${a.role}
+- **Expertise**: ${a.expertise}
+`).join('\n') : 'None. Run /p:sync to generate agents.'}
+
+## Current Focus
+
+${currentTask ? `**Active Task**: ${currentTask}` : 'No active task. Use /p:now to start.'}
+
+## Priority Queue
+
+${nextTasks.length ? nextTasks.map((t, i) => `${i + 1}. ${t}`).join('\n') : 'Empty queue. Use /p:next to add tasks.'}
 
-## Next Up
-${nextTasks.length ? nextTasks.map((t, i) => `${i + 1}. ${t}`).join('\n') : 'Empty queue.'}
+## Active Features (Roadmap)
 
-## Active Features
-${activeFeatures.length ? activeFeatures.map(f => `- ${f}`).join('\n') : 'None in progress.'}
+${activeFeatures.length ? activeFeatures.map(f => `- [ ] ${f}`).join('\n') : 'No features in progress.'}
 
-## Data Location
-All project data: ~/.prjct-cli/projects/${projectId}/
-- agents/ - Read for detailed patterns and code examples
-- analysis/repo-summary.md - Full technical analysis
-- planning/roadmap.md - Features and roadmap
+## Recent Ideas
+
+${recentIdeas.length ? recentIdeas.map(i => `- ${i}`).join('\n') : 'No recent ideas.'}
+
+## Git Activity
+
+${gitStats.recentCommits?.length ? gitStats.recentCommits.map(c => `- \`${c.hash}\` ${c.message}`).join('\n') : 'No recent commits.'}
+
+---
+
+## Deep Dive (Read When Needed)
+
+For detailed information, read these files:
+- \`~/.prjct-cli/projects/${projectId}/agents/*.md\` - Full agent templates with code patterns
+- \`~/.prjct-cli/projects/${projectId}/analysis/repo-summary.md\` - Complete technical analysis
+- \`~/.prjct-cli/projects/${projectId}/planning/roadmap.md\` - Full feature roadmap
+- \`~/.prjct-cli/projects/${projectId}/memory/context.jsonl\` - Decision history
 `
 
-  // 9. Write to global storage (NOT in repo)
+  // 11. Write to global storage
   const contextPath = path.join(globalPath, 'CLAUDE.md')
   await fs.writeFile(contextPath, content, 'utf-8')
 
-  return { agents, stack, currentTask }
+  return { agents: agentFiles.map(f => f.replace('.md', '')), stack: stackInfo, currentTask }
 }
 
 /**
- * Extract stack from repo-summary
+ * Extract FULL stack info from repo-summary
  */
-function extractStack(summary) {
-  if (!summary) return null
-
-  // Try multiple patterns
-  const patterns = [
-    /\*\*(?:Stack|Framework|Language)\*\*[:\s|]+([^\n|]+)/i,
-    /\| \*\*Type\*\* \| ([^\|]+) \|/i,
-    /## Tech Stack[\s\S]*?### (?:Frontend|Backend)\n- \*\*([^*]+)\*\*/i
-  ]
-
-  for (const pattern of patterns) {
-    const match = summary.match(pattern)
-    if (match) return match[1].trim()
+function extractFullStack(summary) {
+  if (!summary) return { primary: null, full: null }
+
+  const result = { primary: null, full: null, languages: [], frameworks: [], dependencies: [] }
+
+  // Extract languages (e.g., "### JavaScript/TypeScript")
+  const langMatch = summary.match(/###\s*(JavaScript|TypeScript|Python|Go|Rust|Ruby|Java|C#|PHP)/i)
+  if (langMatch) result.primary = langMatch[1]
+
+  // Extract dependencies
+  const depsMatch = summary.match(/\*\*Dependencies\*\*:\s*([^\n]+)/i)
+  if (depsMatch) result.dependencies = depsMatch[1].split(',').map(d => d.trim())
+
+  // Extract full stack section (between ## Stack Detected and next ##)
+  const stackSection = summary.match(/## Stack Detected\n([\s\S]*?)(?=\n## |$)/i)
+  if (stackSection && stackSection[1]) {
+    result.full = stackSection[1].trim()
   }
 
-  return null
+  return result
+}
+
+/**
+ * Extract project structure from repo-summary
+ */
+function extractProjectStructure(summary) {
+  if (!summary) return { fileCount: null, directories: [] }
+
+  const result = { fileCount: null, directories: [] }
+
+  // Extract file count
+  const fileMatch = summary.match(/\*\*Total Files\*\*:\s*(\d+)/i)
+  if (fileMatch) result.fileCount = parseInt(fileMatch[1])
+
+  // Extract directories
+  const dirMatch = summary.match(/\*\*Directories\*\*:\s*([^\n]+)/i)
+  if (dirMatch) result.directories = dirMatch[1].split(',').map(d => d.trim())
+
+  return result
+}
+
+/**
+ * Extract git stats from repo-summary
+ */
+function extractGitStats(summary) {
+  if (!summary) return { commits: null, contributors: null, recentCommits: [] }
+
+  const result = { commits: null, contributors: null, recentCommits: [] }
+
+  // Extract commit count
+  const commitMatch = summary.match(/\*\*Total Commits\*\*:\s*(\d+)/i)
+  if (commitMatch) result.commits = parseInt(commitMatch[1])
+
+  // Extract contributors
+  const contribMatch = summary.match(/\*\*Contributors\*\*:\s*(\d+)/i)
+  if (contribMatch) result.contributors = parseInt(contribMatch[1])
+
+  // Extract recent commits
+  const recentSection = summary.match(/## Recent Activity[\s\S]*?(?=##|$)/i)
+  if (recentSection) {
+    const commitLines = recentSection[0].match(/- `([a-f0-9]+)` (.+?) \(/g)
+    if (commitLines) {
+      result.recentCommits = commitLines.slice(0, 5).map(line => {
+        const match = line.match(/- `([a-f0-9]+)` (.+?) \(/)
+        return match ? { hash: match[1], message: match[2] } : null
+      }).filter(Boolean)
+    }
+  }
+
+  return result
+}
+
+/**
+ * Extract agent expertise from agent files
+ */
+async function extractAgentExpertise(agentsDir, agentFiles) {
+  const expertise = []
+
+  for (const file of agentFiles.slice(0, 6)) { // Max 6 agents to keep context small
+    try {
+      const content = await fs.readFile(path.join(agentsDir, file), 'utf-8')
+      const name = file.replace('.md', '')
+
+      // Extract role
+      const roleMatch = content.match(/Role:\s*([^\n]+)/i)
+      const role = roleMatch ? roleMatch[1].trim() : 'Specialist'
+
+      // Extract domain or expertise
+      const domainMatch = content.match(/domain[:\s]+([^\n]+)/i) ||
+                          content.match(/expertise[:\s]+([^\n]+)/i) ||
+                          content.match(/owner of the ([^\n.]+)/i)
+      const expertiseText = domainMatch ? domainMatch[1].trim() : 'General'
+
+      expertise.push({ name, role, expertise: expertiseText })
+    } catch {
+      // Skip unreadable agents
+    }
+  }
+
+  return expertise
 }
 
 /**
@@ -128,11 +260,10 @@ function extractStack(summary) {
 function extractCurrentTask(now) {
   if (!now) return null
 
-  // Skip headers and empty lines, get first content line
   const lines = now.split('\n')
   for (const line of lines) {
     const trimmed = line.trim()
-    if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('<!--')) {
+    if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('<!--') && !trimmed.startsWith('No current')) {
       return trimmed
     }
   }
@@ -164,20 +295,34 @@ function extractActiveFeatures(roadmap) {
   let inActive = false
 
   for (const line of lines) {
-    if (line.includes('Active') || line.includes('In Progress')) {
+    if (line.includes('Active') || line.includes('In Progress') || line.includes('Current')) {
       inActive = true
       continue
     }
     if (line.startsWith('## ') && inActive) {
-      break // End of active section
+      break
     }
-    if (inActive && line.match(/^- \[ \]/)) {
-      const feature = line.replace(/^- \[ \]\s*\*\*/, '').replace(/\*\*.*$/, '').trim()
+    if (inActive && line.match(/^[-*]\s*\[[ x]\]/i)) {
+      const feature = line.replace(/^[-*]\s*\[[ x]\]\s*/, '').replace(/\*\*/g, '').trim()
       if (feature) features.push(feature)
     }
   }
 
-  return features.slice(0, 3) // Max 3
+  return features.slice(0, 5)
+}
+
+/**
+ * Extract recent ideas from ideas.md
+ */
+function extractRecentIdeas(ideas) {
+  if (!ideas) return []
+
+  return ideas
+    .split('\n')
+    .filter(l => l.match(/^[-*]\s/))
+    .slice(0, 3)
+    .map(l => l.replace(/^[-*]\s+/, '').trim())
+    .filter(Boolean)
 }
 
 module.exports = { generateLocalContext }

package/package.json

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

package/templates/global/CLAUDE.md

@@ -5,22 +5,92 @@ This section provides global context for all `/p:*` commands across any prjct pr
 
 **Auto-managed by prjct-cli** - This section is automatically updated when you install or update prjct.
 
-## 🤖 Project Context (OBLIGATORIO)
+## 🚀 Quick Command Reference
+
+| Command | Purpose | Example |
+|---------|---------|---------|
+| `/p:sync` | Analyze project & generate agents | Run first in any project |
+| `/p:now [task]` | Set current focus | `/p:now "implement auth"` |
+| `/p:done` | Complete current task | After finishing work |
+| `/p:next` | Show priority queue | See what's pending |
+| `/p:ship [feature]` | Ship & celebrate | `/p:ship "user login"` |
+| `/p:feature [desc]` | Add feature to roadmap | `/p:feature "dark mode"` |
+| `/p:idea [text]` | Quick idea capture | `/p:idea "add caching"` |
+| `/p:recap` | Project overview | Status check |
+| `/p:progress` | Show metrics | Weekly/monthly stats |
+
+## 🎯 Recommended Workflow
 
-**ANTES de trabajar en un proyecto prjct, LEE el contexto del proyecto:**
+```
+1. /p:sync          → Analyze project, generate agents
+2. /p:feature       → Plan what to build
+3. /p:now           → Start working
+4. [code...]        → Do the actual work
+5. /p:done          → Mark complete
+6. /p:ship          → Celebrate & commit
+```
+
+## 🤖 Project Context (CRITICAL)
+
+**BEFORE working on any prjct project, READ the project context:**
+
+1. Read `.prjct/prjct.config.json` → get `projectId`
+2. Read `~/.prjct-cli/projects/{projectId}/CLAUDE.md` → dynamic project context
+
+The project CLAUDE.md contains:
+- Tech stack (languages, frameworks, dependencies)
+- Project structure (directories)
+- Available agents with their expertise
+- Current task and priority queue
+- Recent git activity
+- Active roadmap features
+
+**If CLAUDE.md doesn't exist**: Suggest running `/p:sync` to generate it.
+
+## 📋 Common Usage Patterns
+
+### Starting Work on a Project
+```
+User: "p. sync"
+→ Analyze repo, generate agents, create context
+→ Now Claude knows: stack, structure, agents available
+```
+
+### Adding a New Feature
+```
+User: "p. feature add user authentication"
+→ Creates roadmap entry with tasks
+→ Analyzes impact and effort
+→ Suggests starting first task
+```
+
+### Daily Development Flow
+```
+User: "p. now implement login form"
+→ Sets current focus
+→ [User works on code]
+User: "p. done"
+→ Marks complete, suggests next task
+User: "p. ship authentication"
+→ Commits, celebrates, updates metrics
+```
 
-1. Lee `.prjct/prjct.config.json` → obtén `projectId`
-2. Lee `~/.prjct-cli/projects/{projectId}/CLAUDE.md` → contexto dinámico del proyecto
-3. Para detalles de implementación, lee los archivos en `agents/`
+### Quick Idea Capture
+```
+User: "p. idea we should add dark mode later"
+→ Saves to ideas.md
+→ Doesn't interrupt current work
+```
 
-El archivo `CLAUDE.md` del proyecto contiene:
-- Stack detectado del proyecto
-- Agentes disponibles (varían por proyecto)
-- Tarea actual
-- Cola de prioridades
-- Rutas a documentación detallada
+## ⚠️ Anti-Patterns (What NOT to Do)
 
-**Si no existe CLAUDE.md**: Sugiere ejecutar `/p:sync` para generarlo.
+| ❌ Don't | ✅ Do Instead |
+|----------|---------------|
+| Write to `.prjct/` folder | Write to `~/.prjct-cli/projects/{id}/` |
+| Skip reading project context | Always read CLAUDE.md first |
+| Execute without projectId | Check `.prjct/prjct.config.json` exists |
+| Hardcode file paths | Use projectId to construct paths |
+| Ignore agents | Use specialized agents for their domains |
 
 ## 🎯 Path Resolution for ALL /p:* Commands
 
@@ -28,10 +98,10 @@ El archivo `CLAUDE.md` del proyecto contiene:
 
 ### Resolution Steps:
 
-1. **Detect prjct project**: Check if `.prjct/prjct.config.json` exists in current working directory
-2. **Read config**: Extract `projectId` from `.prjct/prjct.config.json`
+1. **Detect prjct project**: Check if `.prjct/prjct.config.json` exists
+2. **Read config**: Extract `projectId` from config
 3. **Construct base path**: `~/.prjct-cli/projects/{projectId}/`
-4. **Resolve all file operations**: All paths in command templates are relative to base path
+4. **Resolve all file operations**: Paths are relative to base path
 
 ### Examples:
 
@@ -41,75 +111,61 @@ Actual path:  ~/.prjct-cli/projects/{projectId}/core/now.md
 
 Template says: "Read: memory/context.jsonl"
 Actual path:  ~/.prjct-cli/projects/{projectId}/memory/context.jsonl
-
-Template says: "Update: progress/shipped.md"
-Actual path:  ~/.prjct-cli/projects/{projectId}/progress/shipped.md
 ```
 
 ### Validation Rules:
 
 - ❌ **NEVER** write to `.prjct/core/now.md` (local project directory)
 - ❌ **NEVER** write to `./core/now.md` (current working directory)
-- ✅ **ALWAYS** write to `~/.prjct-cli/projects/{projectId}/core/now.md` (global storage)
+- ✅ **ALWAYS** write to `~/.prjct-cli/projects/{projectId}/core/now.md`
 
 ### When NOT in prjct Project:
 
-If `.prjct/prjct.config.json` doesn't exist in current directory:
+If `.prjct/prjct.config.json` doesn't exist:
 - Respond: "No prjct project detected. Initialize first with `/p:init`"
 - Do NOT execute the command
 - Do NOT create files
 
 ## 📁 File Structure
 
-All prjct data lives in global storage with session-based architecture:
+All prjct data lives in global storage:
 
 ```
 ~/.prjct-cli/projects/{projectId}/
-├── core/                 # Current focus (always small)
-│   ├── now.md           # Single current task
-│   ├── next.md          # Priority queue (max 100 tasks)
-│   └── context.md       # Project context summary
-├── progress/            # Completed work
-│   ├── shipped.md       # Recent ships (last 30 days)
-│   ├── metrics.md       # Aggregated metrics
-│   ├── sessions/        # Daily session logs (JSONL)
-│   │   └── 2025-10/
-│   │       └── 2025-10-05.jsonl
-│   └── archive/         # Monthly archives
-│       └── shipped-2025-10.md
-├── planning/            # Future planning
-│   ├── ideas.md         # Active ideas (last 30 days)
-│   ├── roadmap.md       # Active roadmap (lightweight)
-│   ├── sessions/        # Daily planning sessions (JSONL)
-│   │   └── 2025-10/
-│   │       └── 2025-10-05.jsonl
-│   └── archive/         # Monthly archives
-│       └── roadmap-2025-10.md
-├── analysis/            # Technical analysis
-│   └── repo-summary.md
-├── memory/              # Decision history
-│   ├── context.jsonl    # Global decisions (append-only)
-│   └── sessions/        # Daily context (structured)
-│       └── 2025-10/
-│           └── 2025-10-05.jsonl
-└── agents/              # Dynamic AI agents
-    ├── coordinator.md
-    ├── ux.md
-    ├── fe.md
-    ├── be.md
-    ├── qa.md
-    └── scribe.md
-```
-
-### Session Format (JSONL):
-
-One JSON object per line, append-only:
-
-```jsonl
-{"ts":"2025-10-05T14:30:00Z","type":"feature_add","name":"auth","tasks":5,"impact":"high","effort":"6h"}
-{"ts":"2025-10-05T15:00:00Z","type":"task_start","task":"JWT middleware","agent":"be","estimate":"2h"}
-{"ts":"2025-10-05T17:15:00Z","type":"task_complete","task":"JWT middleware","duration":"2h15m"}
-{"ts":"2025-10-05T18:00:00Z","type":"feature_ship","name":"auth","tasks_done":5,"total_time":"6h"}
+├── CLAUDE.md            # ⭐ READ THIS FIRST - Rich project context
+├── core/                # Current focus
+│   ├── now.md          # Single current task
+│   └── next.md         # Priority queue
+├── progress/           # Completed work
+│   ├── shipped.md      # Recent ships
+│   └── metrics.md      # Aggregated metrics
+├── planning/           # Future planning
+│   ├── ideas.md        # Quick ideas
+│   └── roadmap.md      # Feature roadmap
+├── analysis/           # Technical analysis
+│   └── repo-summary.md # Full repo analysis
+├── memory/             # Decision history
+│   └── context.jsonl   # Append-only log
+└── agents/             # ⭐ Specialized AI agents
+    ├── fe.md           # Frontend specialist
+    ├── be.md           # Backend specialist
+    └── ...             # More based on stack
+```
+
+## 🤖 Using Agents Effectively
+
+When project has specialized agents:
+
+1. **Read agent file** before working in that domain
+2. **Follow agent patterns** for code style and architecture
+3. **Agent expertise** is in CLAUDE.md summary
+
+Example:
+```
+Task: "implement React component"
+→ Check CLAUDE.md for frontend agent
+→ Read agents/fe.md for React patterns
+→ Follow detected conventions
 ```
 
 ## 🤖 Git Commit Format
@@ -125,107 +181,53 @@ Designed for [Claude](https://www.anthropic.com/claude)
 - ❌ "Generated with Claude Code"
 - ❌ "Co-Authored-By: Claude"
 
-**Always use:**
-- ✅ The prjct footer format above
-
-## 👤 Author Detection
-
-All operations include author information. Detection order:
-
-1. **GitHub CLI**: `gh api user` (preferred)
-   - Provides: name, email, username, avatarUrl
-2. **Git Config**: Fallback if GitHub CLI not available
-   - `git config user.name`
-   - `git config user.email`
-3. **Default**: If both fail
-   - name: "Unknown"
-   - email: "unknown@localhost"
-
-Every log entry in `memory/context.jsonl` includes author field.
-
 ## ⚠️ Common Validation Patterns
 
-### Before Executing /p:done:
+### Before /p:done:
 ```javascript
-// Check if there's an active task
 const nowContent = await Read('~/.prjct-cli/projects/{projectId}/core/now.md')
 if (!nowContent || nowContent.trim() === '') {
   return "Not working on anything. Use /p:now to start a task."
 }
 ```
 
-### Before Executing /p:ship:
+### Before /p:ship:
 ```javascript
-// Check if there's something to ship
-const shippedContent = await Read('~/.prjct-cli/projects/{projectId}/progress/shipped.md')
 const nowContent = await Read('~/.prjct-cli/projects/{projectId}/core/now.md')
-if ((!nowContent || nowContent.trim() === '') &&
-    (!shippedContent || shippedContent.trim() === '')) {
+if (!nowContent || nowContent.trim() === '') {
   return "Nothing to ship yet. Build something first with /p:now."
 }
 ```
 
-### Reading Project Config:
-```javascript
-// Always read config first
-const configPath = '.prjct/prjct.config.json'
-const configContent = await Read(configPath)
-const config = JSON.parse(configContent)
-const projectId = config.projectId
-const basePath = `~/.prjct-cli/projects/${projectId}/`
-```
-
 ## 🔧 Error Handling
 
-### File Not Found:
-- If `core/now.md` doesn't exist when reading → return empty state
-- If `core/next.md` doesn't exist → return "No tasks in queue"
-- Always check file existence before operations
-
-### Invalid JSON:
-- If config file is corrupted → suggest running `/p:init` again
-- Log error to `memory/context.jsonl` for debugging
-
-### Permission Issues:
-- If can't write to `~/.prjct-cli/` → check directory permissions
-- Suggest: `chmod -R u+w ~/.prjct-cli/`
-
-## 📊 Performance Guidelines
-
-### Archive Rules:
-- Index files (roadmap.md, shipped.md) keep only last 30 days
-- Sessions older than 30 days → automatically moved to archive/
-- When querying across time: read relevant session files from archive/
-- Commands only read current index + today's session for performance
-
-### File Size Limits:
-- `core/now.md`: Single task only (< 1KB)
-- `core/next.md`: Max 100 tasks (< 50KB)
-- `progress/shipped.md`: Last 30 days only (auto-archive older)
-- Session files: One file per day, JSONL format for efficient appending
+| Error | Solution |
+|-------|----------|
+| File not found | Return empty state, don't fail |
+| Invalid JSON config | Suggest `/p:init` again |
+| Permission denied | Suggest `chmod -R u+w ~/.prjct-cli/` |
+| No project detected | Suggest `/p:init` |
 
 ## 🎯 Command Execution Flow
 
 Standard pattern for all `/p:*` commands:
 
-1. **Validate environment**: Check `.prjct/prjct.config.json` exists
+1. **Validate**: Check `.prjct/prjct.config.json` exists
 2. **Read config**: Extract projectId
-3. **Construct paths**: Build all file paths using base path
-4. **Execute operations**: Read/write files in global storage
-5. **Log action**: Append to `memory/context.jsonl` with timestamp and author
-6. **Return response**: Formatted response with next action suggestions
+3. **Read context**: Load `~/.prjct-cli/projects/{id}/CLAUDE.md`
+4. **Execute**: Read/write files in global storage
+5. **Log**: Append to `memory/context.jsonl`
+6. **Respond**: Formatted response with next action suggestions
 
 ## 📚 Additional Context
 
 - **Website**: https://prjct.app
 - **Documentation**: https://prjct.app/docs
-- **Repository**: Private (proprietary software)
 - **Support**: jlopezlira@gmail.com
-- **Version**: Auto-updated with prjct-cli
 
 ---
 
 **Last updated**: Auto-managed by prjct-cli
-**Config version**: 0.8.2
+**Config version**: 0.10.5
 
 <!-- prjct:end - DO NOT REMOVE THIS MARKER -->