prjct-cli 0.25.2 → 0.28.0

package/templates/skills/prjct-done/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: prjct-done
+description: Complete current task or subtask. Use when user says "p. done", "finished", "completed", or indicates they finished working on something.
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task, TodoWrite]
+user-invocable: true
+---
+
+# prjct Done
+
+Mark current task or subtask as complete and advance workflow.
+
+## Context Loading (ALWAYS FIRST)
+
+```
+1. Read `.prjct/prjct.config.json` → extract projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Read {globalPath}/storage/state.json → current task
+```
+
+## Done Workflow
+
+### 1. Check Current State
+
+Read `{globalPath}/storage/state.json`:
+- If no currentTask: "No active task. Use p. task to start one."
+- If has subtasks: Check which is in_progress
+
+### 2. Complete Subtask (if applicable)
+
+If task has subtasks:
+```json
+{
+  "subtasks": [
+    { "id": "1", "status": "completed", "completedAt": "..." },
+    { "id": "2", "status": "in_progress" },  // ← Mark complete, advance
+    { "id": "3", "status": "pending" }        // ← Start this one
+  ]
+}
+```
+
+### 3. Complete Task (if no more subtasks)
+
+When all subtasks done OR no subtasks:
+```json
+{
+  "currentTask": null,
+  "lastCompleted": {
+    "id": "...",
+    "title": "...",
+    "completedAt": "ISO timestamp"
+  }
+}
+```
+
+### 4. Update Context
+
+Write to `{globalPath}/context/now.md`:
+- If more subtasks: Show next subtask
+- If task complete: Show completion + suggest next
+
+### 5. Log Event
+
+Append to `{globalPath}/memory/events.jsonl`:
+```json
+{"timestamp": "...", "action": "subtask_completed", "subtask": {...}}
+```
+or
+```json
+{"timestamp": "...", "action": "task_completed", "task": {...}}
+```
+
+## Paths (CRITICAL)
+
+| Type | Path | Access |
+|------|------|--------|
+| Config | `.prjct/prjct.config.json` | Read-only |
+| Storage | `{globalPath}/storage/state.json` | Read-Write |
+| Context | `{globalPath}/context/now.md` | Write |
+| Memory | `{globalPath}/memory/events.jsonl` | Append |
+
+## Output Format
+
+**Subtask completed:**
+```
+✅ Subtask completed: {title}
+
+Progress: {completed}/{total}
+Next: {next subtask title}
+```
+
+**Task completed:**
+```
+✅ Task completed: {title}
+
+Duration: {time}
+Next: p. ship "{feature}" or p. task "next thing"
+```

package/templates/skills/prjct-ship/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: prjct-ship
+description: Ship a feature with PR, version bump, and changelog. Use when user says "p. ship", wants to release/deploy, or is ready to merge their work.
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion, TodoWrite]
+user-invocable: true
+---
+
+# prjct Ship
+
+Ship features with automated PR creation, version bumping, and changelog updates.
+
+## Context Loading (ALWAYS FIRST)
+
+```
+1. Read `.prjct/prjct.config.json` → extract projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Read {globalPath}/storage/state.json → current/last task
+4. Check git status for branch and changes
+```
+
+## Ship Workflow
+
+### 1. Pre-Ship Checks
+
+```bash
+# Check for uncommitted changes
+git status --porcelain
+
+# Check current branch (should not be main/master)
+git branch --show-current
+
+# Run tests if configured
+npm test || bun test || yarn test
+```
+
+### 2. Create/Update PR
+
+If on feature branch:
+```bash
+# Push branch
+git push -u origin $(git branch --show-current)
+
+# Create PR with gh CLI
+gh pr create --title "feat: {feature name}" --body "..."
+```
+
+PR body template:
+```markdown
+## Summary
+{Brief description}
+
+## Changes
+- {change 1}
+- {change 2}
+
+## Test Plan
+- [ ] Tests pass
+- [ ] Manual verification
+
+---
+🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)
+```
+
+### 3. Version Bump (if applicable)
+
+Read `package.json`, determine bump type:
+- **patch**: Bug fixes (0.0.x)
+- **minor**: New features (0.x.0)
+- **major**: Breaking changes (x.0.0)
+
+```bash
+npm version patch -m "chore: bump version to %s"
+```
+
+### 4. Update Changelog
+
+Prepend to `CHANGELOG.md`:
+```markdown
+## [x.x.x] - YYYY-MM-DD
+
+### Added
+- {new feature}
+
+### Fixed
+- {bug fix}
+```
+
+### 5. Record Shipment
+
+Write to `{globalPath}/storage/shipped.json`:
+```json
+{
+  "shipped": [
+    {
+      "id": "uuid",
+      "name": "{feature}",
+      "version": "x.x.x",
+      "prUrl": "https://github.com/...",
+      "shippedAt": "ISO timestamp"
+    }
+  ]
+}
+```
+
+### 6. Update Context
+
+Write to `{globalPath}/context/shipped.md`:
+```markdown
+# Recently Shipped
+
+## {feature name}
+- Version: x.x.x
+- PR: {url}
+- Date: {date}
+```
+
+### 7. Log Event
+
+Append to `{globalPath}/memory/events.jsonl`:
+```json
+{"timestamp": "...", "action": "feature_shipped", "feature": {...}, "version": "..."}
+```
+
+## Paths (CRITICAL)
+
+| Type | Path | Access |
+|------|------|--------|
+| Config | `.prjct/prjct.config.json` | Read-only |
+| Storage | `{globalPath}/storage/shipped.json` | Read-Write |
+| Context | `{globalPath}/context/shipped.md` | Write |
+| Memory | `{globalPath}/memory/events.jsonl` | Append |
+
+## Git Commit Footer
+
+ALWAYS include in commits:
+```
+🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)
+```
+
+## Output Format
+
+```
+🚀 SHIPPED: {feature name}
+
+Version: {x.x.x}
+PR: {url}
+Next: Celebrate! Then p. task "next feature"
+```

package/templates/skills/prjct-sync/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: prjct-sync
+description: Analyze and sync project state. Use when user says "p. sync", wants to analyze the codebase, or needs to generate/update domain agents.
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion, TodoWrite]
+user-invocable: true
+---
+
+# prjct Sync
+
+Analyze codebase and sync project state with intelligent agent generation.
+
+## Context Loading (ALWAYS FIRST)
+
+```
+1. Read `.prjct/prjct.config.json` → extract projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Read {globalPath}/project.json → project metadata
+```
+
+## Sync Workflow
+
+### 1. Analyze Codebase
+
+Use Task(Explore) to understand:
+- Tech stack (languages, frameworks)
+- Project structure (src/, lib/, etc.)
+- Key patterns (API routes, components, etc.)
+- Test coverage
+
+### 2. Update Project Metadata
+
+Write to `{globalPath}/project.json`:
+```json
+{
+  "projectId": "...",
+  "name": "project-name",
+  "repoPath": "/path/to/repo",
+  "techStack": ["typescript", "react", "node"],
+  "fileCount": 150,
+  "cliVersion": "0.28.0",
+  "lastSync": "ISO timestamp"
+}
+```
+
+### 3. Generate Domain Agents
+
+Based on tech stack, create agents in `{globalPath}/agents/`:
+
+| Agent | When to Generate |
+|-------|------------------|
+| `frontend.md` | React, Vue, Svelte, CSS |
+| `backend.md` | Node, Express, APIs |
+| `database.md` | SQL, MongoDB, Prisma |
+| `testing.md` | Jest, Vitest, Playwright |
+| `devops.md` | Docker, CI/CD, K8s |
+
+Agent template:
+```yaml
+---
+name: {agent-name}
+description: {domain expertise}
+tools: [Read, Write, Edit, Bash, Glob, Grep]
+---
+
+# {Agent Name} Specialist
+
+## Patterns Found
+- {pattern 1}
+- {pattern 2}
+
+## Conventions
+- {convention 1}
+- {convention 2}
+```
+
+### 4. Sync Context Files
+
+Regenerate `{globalPath}/context/`:
+- `now.md` - Current task (if any)
+- `next.md` - Queue summary
+- `shipped.md` - Recently shipped
+
+### 5. Log Event
+
+Append to `{globalPath}/memory/events.jsonl`:
+```json
+{"timestamp": "...", "action": "sync_completed", "agents": [...], "stats": {...}}
+```
+
+## Paths (CRITICAL)
+
+| Type | Path | Access |
+|------|------|--------|
+| Config | `.prjct/prjct.config.json` | Read-only |
+| Project | `{globalPath}/project.json` | Read-Write |
+| Agents | `{globalPath}/agents/*.md` | Write |
+| Context | `{globalPath}/context/*.md` | Write |
+| Memory | `{globalPath}/memory/events.jsonl` | Append |
+
+## Output Format
+
+```
+✅ Project synced
+
+Files: {n} | Stack: {techs}
+Agents: {list}
+Next: p. task "start working"
+```

package/templates/skills/prjct-task/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: prjct-task
+description: Start and manage development tasks. Use when user says "p. task", wants to start working on something, or mentions starting a feature/bug/improvement/refactor.
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion, TodoWrite]
+user-invocable: true
+---
+
+# prjct Task Manager
+
+Start and track development tasks with intelligent classification.
+
+## Context Loading (ALWAYS FIRST)
+
+```
+1. Read `.prjct/prjct.config.json` → extract projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Read {globalPath}/storage/state.json → current state
+4. Read {globalPath}/agents/*.md → domain expertise (if exists)
+```
+
+## Task Workflow
+
+### 1. Classify Task Type
+- **feature**: New functionality
+- **bug**: Fix broken behavior
+- **improvement**: Enhance existing feature
+- **refactor**: Code restructure without behavior change
+- **chore**: Maintenance, deps, config
+
+### 2. Explore Codebase
+Use Task(Explore) to:
+- Find related code patterns
+- Identify affected files
+- Understand dependencies
+
+### 3. Break Down (if complex)
+Create subtasks with clear scope:
+```json
+{
+  "subtasks": [
+    { "id": "1", "title": "...", "status": "pending" }
+  ]
+}
+```
+
+### 4. Track in Storage
+Write to `{globalPath}/storage/state.json`:
+```json
+{
+  "currentTask": {
+    "id": "uuid",
+    "title": "Task description",
+    "type": "feature",
+    "status": "in_progress",
+    "subtasks": [...],
+    "startedAt": "ISO timestamp"
+  }
+}
+```
+
+### 5. Generate Context
+Write to `{globalPath}/context/now.md`:
+```markdown
+# Current Task
+**{title}** ({type})
+Started: {timestamp}
+Subtasks: {completed}/{total}
+```
+
+### 6. Log Event
+Append to `{globalPath}/memory/events.jsonl`:
+```json
+{"timestamp": "...", "action": "task_started", "task": {...}}
+```
+
+## Paths (CRITICAL)
+
+| Type | Path | Access |
+|------|------|--------|
+| Config | `.prjct/prjct.config.json` | Read-only |
+| Storage | `{globalPath}/storage/*.json` | Read-Write |
+| Context | `{globalPath}/context/*.md` | Read-Write |
+| Memory | `{globalPath}/memory/events.jsonl` | Append-only |
+| Agents | `{globalPath}/agents/*.md` | Read-only |
+
+## Output Format
+
+```
+✅ Task started: {title}
+
+Type: {type} | Subtasks: {n}
+Next: {first subtask or suggested action}
+```
+
+## Git Commit Footer
+
+When committing, ALWAYS include:
+```
+🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)
+```

package/templates/subagents/domain/backend.md

@@ -3,6 +3,7 @@ name: backend
 description: Backend specialist for Node.js, Go, Python, REST APIs, and GraphQL. Use PROACTIVELY when user works on APIs, servers, or backend logic.
 tools: Read, Write, Bash, Glob, Grep
 model: sonnet
+skills: [javascript-typescript]
 ---
 
 You are a backend specialist agent for this project.

package/templates/subagents/domain/devops.md

@@ -3,6 +3,7 @@ name: devops
 description: DevOps specialist for Docker, Kubernetes, CI/CD, and GitHub Actions. Use PROACTIVELY when user works on deployment, containers, or pipelines.
 tools: Read, Bash, Glob
 model: sonnet
+skills: [developer-kit]
 ---
 
 You are a DevOps specialist agent for this project.

package/templates/subagents/domain/frontend.md

@@ -3,6 +3,7 @@ name: frontend
 description: Frontend specialist for React, Vue, Angular, Svelte, CSS, and UI work. Use PROACTIVELY when user works on components, styling, or UI features.
 tools: Read, Write, Glob, Grep
 model: sonnet
+skills: [frontend-design]
 ---
 
 You are a frontend specialist agent for this project.

package/templates/subagents/domain/testing.md

@@ -3,6 +3,7 @@ name: testing
 description: Testing specialist for Bun test, Jest, Pytest, and testing libraries. Use PROACTIVELY when user works on tests, coverage, or test infrastructure.
 tools: Read, Write, Bash
 model: sonnet
+skills: [developer-kit]
 ---
 
 You are a testing specialist agent for this project.

package/templates/subagents/workflow/prjct-planner.md

@@ -3,6 +3,7 @@ name: prjct-planner
 description: Planning agent for /p:feature, /p:idea, /p:spec, /p:bug tasks. Use PROACTIVELY when user discusses features, ideas, specs, or bugs.
 tools: Read, Write, Glob, Grep
 model: sonnet
+skills: [feature-dev]
 ---
 
 You are the prjct planning agent, specializing in feature planning and task breakdown.

package/templates/subagents/workflow/prjct-shipper.md

@@ -3,6 +3,7 @@ name: prjct-shipper
 description: Shipping agent for /p:ship tasks. Use PROACTIVELY when user wants to commit, push, deploy, or ship features.
 tools: Read, Write, Bash, Glob
 model: sonnet
+skills: [code-review]
 ---
 
 You are the prjct shipper agent, specializing in shipping features safely.