prjct-cli 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.28.0] - 2026-01-10
+
+### Feature: Claude Code Native Integration
+
+**Skills as First-Class Citizens**: prjct commands are now installed as Claude Code Skills for automatic discovery.
+
+- **SessionStart Hook**: Injects fresh project context at session start via `~/.claude/hooks/prjct-session-start.sh`
+- **Skills Auto-Install**: 4 skills installed to `~/.claude/skills/` during `npm install`:
+  - `prjct-task` - Start tasks with classification
+  - `prjct-sync` - Analyze codebase, generate agents
+  - `prjct-done` - Complete current subtask
+  - `prjct-ship` - Ship with PR + version bump
+- **Setup Integration**: `core/infrastructure/setup.ts` now installs hooks and skills automatically
+- **Simplified CLAUDE.md**: Reduced global template from 221 to ~50 lines - hooks handle fresh context
+
+**Upgrade Impact**: Run `npm install -g prjct-cli` to install hooks and skills.
+
+---
+
 ## [0.27.0] - 2026-01-08
 
 ### Fix: prjct Commit Signature (CRITICAL)

package/CLAUDE.md

@@ -145,26 +145,34 @@ Next: [suggested action]
 
 ---
 
-## SKILL INTEGRATION (v0.27)
+## CLAUDE CODE INTEGRATION (v0.28)
 
-Agents are linked to Claude Code skills from claude-plugins.dev.
+prjct-cli uses Claude Code's native features for robust integration:
 
-### Agent → Skill Mapping
+### SessionStart Hook
 
-| Agent | Skill |
-|-------|-------|
-| `frontend.md` | `frontend-design` |
-| `uxui.md` | `frontend-design` |
-| `backend.md` | `javascript-typescript` |
-| `testing.md` | `developer-kit` |
-| `devops.md` | `developer-kit` |
-| `prjct-planner.md` | `feature-dev` |
-| `prjct-shipper.md` | `code-review` |
+A hook runs at the start of every Claude Code session to inject fresh context:
+- Located at: `~/.claude/hooks/prjct-session-start.sh`
+- Automatically reads project state and injects into session
+- Bypasses CLAUDE.md caching issues
 
-### Usage
+### Skills (Auto-Discovery)
 
-- `p. sync` installs required skills automatically
-- `p. task` invokes skills based on task type
-- Skills config: `{globalPath}/config/skills.json`
+Skills are auto-discovered by Claude Code when relevant:
 
-See `templates/agentic/skill-integration.md` for details.
+| Skill | Trigger |
+|-------|---------|
+| `prjct-task` | "p. task", starting work, features/bugs |
+| `prjct-sync` | "p. sync", analyze codebase |
+| `prjct-done` | "p. done", completing work |
+| `prjct-ship` | "p. ship", releasing features |
+
+Skills location: `~/.claude/skills/prjct-*/SKILL.md`
+
+### Setup
+
+All integration is installed automatically via `npm install -g prjct-cli`:
+1. SessionStart hook → `~/.claude/hooks/`
+2. Skills → `~/.claude/skills/`
+3. Commands → `~/.claude/commands/p/`
+4. Settings → `~/.claude/settings.json`

package/core/infrastructure/setup.ts

@@ -112,6 +112,12 @@ export async function run(): Promise<SetupResults> {
 
     // Step 4c: Install status line with version check
     await installStatusLine()
+
+    // Step 4d: Install SessionStart hook for fresh context injection
+    await installSessionHook()
+
+    // Step 4e: Install Skills for auto-discovery
+    await installSkills()
   }
 
   // Step 5: Save version in editors-config
@@ -272,6 +278,99 @@ echo "⚡ prjct"
   }
 }
 
+/**
+ * Install SessionStart hook for fresh context injection
+ * This hook runs at the start of every Claude Code session
+ */
+async function installSessionHook(): Promise<void> {
+  try {
+    const claudeDir = path.join(os.homedir(), '.claude')
+    const hooksDir = path.join(claudeDir, 'hooks')
+    const hookPath = path.join(hooksDir, 'prjct-session-start.sh')
+    const settingsPath = path.join(claudeDir, 'settings.json')
+
+    // Ensure hooks directory exists
+    if (!fs.existsSync(hooksDir)) {
+      fs.mkdirSync(hooksDir, { recursive: true })
+    }
+
+    // Copy hook from templates
+    const templateHookPath = path.join(__dirname, '../../templates/hooks/prjct-session-start.sh')
+    if (fs.existsSync(templateHookPath)) {
+      const hookContent = fs.readFileSync(templateHookPath, 'utf8')
+      fs.writeFileSync(hookPath, hookContent, { mode: 0o755 })
+    }
+
+    // Update settings.json to include SessionStart hook
+    let settings: Record<string, unknown> = {}
+    if (fs.existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
+      } catch {
+        // Invalid JSON, start fresh
+      }
+    }
+
+    // Add or update hooks configuration
+    const hooks = (settings.hooks as Record<string, unknown[]>) || {}
+    hooks.SessionStart = [
+      {
+        matcher: 'startup',
+        hooks: [
+          {
+            type: 'command',
+            command: hookPath
+          }
+        ]
+      }
+    ]
+    settings.hooks = hooks
+
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2))
+    console.log(`   ${GREEN}✓${NC} SessionStart hook installed`)
+  } catch {
+    // Silently fail - hook is optional but recommended
+  }
+}
+
+/**
+ * Install Skills for Claude Code auto-discovery
+ * Skills are loaded automatically when relevant to user's request
+ */
+async function installSkills(): Promise<void> {
+  try {
+    const claudeDir = path.join(os.homedir(), '.claude')
+    const skillsDir = path.join(claudeDir, 'skills')
+    const templateSkillsDir = path.join(__dirname, '../../templates/skills')
+
+    const skillNames = ['prjct-task', 'prjct-sync', 'prjct-done', 'prjct-ship']
+    let installed = 0
+
+    for (const skillName of skillNames) {
+      const destDir = path.join(skillsDir, skillName)
+      const templatePath = path.join(templateSkillsDir, skillName, 'SKILL.md')
+
+      if (fs.existsSync(templatePath)) {
+        // Ensure skill directory exists
+        if (!fs.existsSync(destDir)) {
+          fs.mkdirSync(destDir, { recursive: true })
+        }
+
+        // Copy SKILL.md
+        const skillContent = fs.readFileSync(templatePath, 'utf8')
+        fs.writeFileSync(path.join(destDir, 'SKILL.md'), skillContent)
+        installed++
+      }
+    }
+
+    if (installed > 0) {
+      console.log(`   ${GREEN}✓${NC} ${installed} Skills installed`)
+    }
+  } catch {
+    // Silently fail - skills are optional but recommended
+  }
+}
+
 /**
  * Show setup results
  */