prjct-cli 1.47.0 → 1.47.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "1.47.0",
+  "version": "1.47.4",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "dist/bin/prjct.mjs",
   "bin": {

package/templates/antigravity/SKILL.md

@@ -1,39 +1,20 @@
 ---
 name: prjct
-description: Project context layer for AI coding agents. Use when user says "p. sync", "p. task", "p. done", "p. ship", or asks about project context, tasks, shipping features, or project state management.
+description: Use when user mentions p., prjct, task tracking, or workflow commands.
 ---
 
-# prjct - Context Layer for AI Agents
+# prjct — Context layer for AI agents
 
-You are using **prjct**, a context layer for AI coding agents.
+Grammar: `p. <command> [args]` or `prjct <command> --md`
 
-## Load Full Instructions
+Core commands: sync, task, done, ship, pause, resume, next, bug, workflow, tokens
+Integrations: linear, jira, enrich
+Other: run `prjct <command> --md` and follow CLI output
 
-1. Run: `npm root -g` to get the npm global root
-2. Read: `{npmRoot}/prjct-cli/templates/global/ANTIGRAVITY.md`
-3. Follow those instructions for ALL `p. <command>` requests
+Flow: idea → roadmap → next → task → done → ship → next (cycle until plan complete)
 
-## Quick Reference
-
-| Command | Action |
-|---------|--------|
-| `p. sync` | Analyze project, generate agents |
-| `p. task "..."` | Start a task |
-| `p. done` | Complete subtask |
-| `p. ship` | Ship with PR + version |
-| `p. pause` | Pause current task |
-| `p. resume` | Resume paused task |
-
-## Critical Rule
-
-**PLAN BEFORE ACTION**: For ANY prjct command, you MUST:
-1. Create a plan showing what will be done
-2. Wait for user approval
-3. Only then execute
-
-Never skip the plan step. This is non-negotiable.
-
-## Note
-
-This skill auto-regenerates with `p. sync` if deleted.
-Full instructions are in the npm package (always up-to-date).
+Rules:
+- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
+- All commits include footer: `Generated with [p/](https://www.prjct.app/)`
+- All storage through `prjct` CLI (SQLite internally)
+- Start code tasks with `p. task` and follow Context Contract from CLI output

package/templates/codex/SKILL.md

@@ -1,36 +1,20 @@
 ---
 name: prjct
-description: Use when user mentions p., prjct, project management, task tracking, or workflow commands (sync, task, done, ship, pause, resume, next, bug, idea, dash).
+description: Use when user mentions p., prjct, task tracking, or workflow commands.
 ---
 
 # prjct — Context layer for AI agents
 
-Grammar: `p. <command> [args]`
+Grammar: `p. <command> [args]` or `prjct <command> --md`
 
-Supported commands:
-`sync` `task` `done` `ship` `pause` `resume` `next` `bug` `idea` `dash`
-`init` `setup` `verify` `status` `review` `plan` `spec` `test` `workflow`
-`sessions` `analyze` `cleanup` `design` `serve` `linear` `jira` `git`
-`history` `update` `merge` `learnings` `skill` `auth` `prd` `impact` `enrich`
+Core commands: sync, task, done, ship, pause, resume, next, bug, workflow, tokens
+Integrations: linear, jira, enrich
+Other: run `prjct <command> --md` and follow CLI output
 
-Deterministic template resolution order for `p. <command>`:
-1. `require.resolve('prjct-cli/package.json')` -> `{pkgRoot}/templates/commands/{command}.md`
-2. `npm root -g` -> `{npmRoot}/prjct-cli/templates/commands/{command}.md`
-3. Local fallback (dev mode) -> `{localPrjctCliRoot}/templates/commands/{command}.md`
-
-If command is not in supported list:
-- Return: `Unknown command: p. <command>`
-- Include valid commands and suggest `prjct setup`
-
-If command exists but template cannot be resolved:
-- Block and ask for repair:
-  - `prjct start`
-  - `prjct setup`
-- Do not continue with ad-hoc behavior.
+Flow: idea → roadmap → next → task → done → ship → next (cycle until plan complete)
 
 Rules:
-- Never commit to main/master directly
+- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
 - All commits include footer: `Generated with [p/](https://www.prjct.app/)`
 - All storage through `prjct` CLI (SQLite internally)
 - Start code tasks with `p. task` and follow Context Contract from CLI output
-- Context7 MCP is mandatory for framework/library API decisions

package/templates/cursor/commands/bug.md

@@ -2,7 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/bug.md`
-
-Pass the arguments as the bug description.
+Run: `prjct bug {{args}} --md`
+Follow CLI output.

package/templates/cursor/commands/done.md

@@ -1,4 +1,4 @@
 # /done - Complete current subtask
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/done.md`
+Run: `prjct done --md`
+Follow CLI output.

package/templates/cursor/commands/pause.md

@@ -2,5 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/pause.md`
+Run: `prjct pause {{args}} --md`
+Follow CLI output.

package/templates/cursor/commands/resume.md

@@ -1,4 +1,4 @@
 # /resume - Resume paused task
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/resume.md`
+Run: `prjct resume --md`
+Follow CLI output.

package/templates/cursor/commands/ship.md

@@ -1,8 +1,6 @@
-# /ship - Ship feature with PR + version bump
+# /ship - Ship feature
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/ship.md`
-
-Pass the arguments as the feature name (optional).
+Run: `prjct ship {{args}} --md`
+Follow CLI output.

package/templates/cursor/commands/sync.md

@@ -1,4 +1,4 @@
 # /sync - Analyze project
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/sync.md`
+Run: `prjct sync --md`
+Follow CLI output.

package/templates/cursor/commands/task.md

@@ -2,7 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/task.md`
-
-Pass the arguments as the task description.
+Run: `prjct task {{args}} --md`
+Follow CLI output.

package/templates/cursor/p.md

@@ -2,28 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-## Instructions
-
-1. **Get npm root**: Run `npm root -g`
-2. **Parse arguments**: First word = `command`, rest = `commandArgs`
-3. **Read template**: `{npmRoot}/prjct-cli/templates/commands/{command}.md`
-4. **Execute**: Follow the template with `commandArgs` as input
-
-## Example
-
-If arguments = `task fix the login bug`:
-- command = `task`
-- commandArgs = `fix the login bug`
-- npm root → `/opt/homebrew/lib/node_modules`
-- Read: `/opt/homebrew/lib/node_modules/prjct-cli/templates/commands/task.md`
-- Execute template with: `fix the login bug`
-
-## Available Commands
-
-task, done, ship, sync, init, idea, dash, next, pause, resume, bug,
-linear, github, jira, monday, enrich, feature, prd, plan, review,
-merge, git, test, cleanup, design, analyze, history, update, spec
-
-## Action
-
-NOW run `npm root -g` and read the appropriate command template.
+Run: `prjct {{first_word_of_args}} {{rest_of_args}} --md`
+Follow CLI output.

package/templates/cursor/router.mdc

@@ -5,24 +5,5 @@ alwaysApply: true
 
 # prjct
 
-You are using **prjct**, a context layer for AI coding agents.
-
-## Load Full Instructions
-
-1. Run: `npm root -g` to get the npm global root
-2. Read: `{npmRoot}/prjct-cli/templates/global/CURSOR.mdc`
-3. Follow those instructions for ALL `/command` requests
-
-## Quick Reference
-
-| Command | Action |
-|---------|--------|
-| `/sync` | Analyze project, generate agents |
-| `/task "..."` | Start a task |
-| `/done` | Complete subtask |
-| `/ship` | Ship with PR + version |
-
-## Note
-
-This router auto-regenerates with `/sync` if deleted.
-Full instructions are in the npm package (always up-to-date).
+Core: /sync, /task, /done, /ship, /pause, /resume, /next, /bug, /workflow
+Other: run `prjct <command> --md` and follow CLI output

package/templates/global/ANTIGRAVITY.md

@@ -1,17 +1,16 @@
 <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
 # p/ — Context layer for AI agents
 
-Commands: `p. sync` `p. task` `p. done` `p. ship` `p. pause` `p. resume` `p. bug` `p. dash` `p. next` `p. jira` `p. linear` `p. status` + 25 more
+Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
+Other commands: run `prjct <command> --md` and follow CLI output
 
-When user types a p command, execute the corresponding prjct CLI command with `--md` flag for context.
+Flow: idea → roadmap → next → task → done → ship → next (cycle until plan complete)
 
-Rules:
-- Never commit to main/master directly
-- All commits include footer: `Generated with [p/](https://www.prjct.app/)`
+Data:
+- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
+- Commit footer: `Generated with [p/](https://www.prjct.app/)`
 - Path resolution: `.prjct/prjct.config.json` → `~/.prjct-cli/projects/{projectId}`
-- All storage through `prjct` CLI (SQLite internally)
-- For code tasks, always start with `p. task` and follow Context Contract from CLI output
-- Context7 MCP is mandatory for framework/library API decisions
+- Storage: `prjct` CLI (SQLite internally)
 
 **Auto-managed by prjct-cli** | https://prjct.app
 <!-- prjct:end - DO NOT REMOVE THIS MARKER -->

package/templates/global/CURSOR.mdc

@@ -6,15 +6,16 @@ alwaysApply: true
 <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
 # p/ — Context layer for AI agents
 
-Commands: `/sync` `/task` `/done` `/ship` `/pause` `/resume` `/bug` `/dash` `/next` `/jira` `/linear` `/status` + 25 more
+Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
+Other commands: run `prjct <command> --md` and follow CLI output
 
-When user triggers a command, execute the corresponding prjct CLI command with `--md` flag for context.
+Flow: idea → roadmap → next → task → done → ship → next (cycle until plan complete)
 
-Rules:
-- Never commit to main/master directly
-- All commits include footer: `Generated with [p/](https://www.prjct.app/)`
+Data:
+- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
+- Commit footer: `Generated with [p/](https://www.prjct.app/)`
 - Path resolution: `.prjct/prjct.config.json` → `~/.prjct-cli/projects/{projectId}`
-- All storage through `prjct` CLI (SQLite internally)
+- Storage: `prjct` CLI (SQLite internally)
 
 **Auto-managed by prjct-cli** | https://prjct.app
 <!-- prjct:end - DO NOT REMOVE THIS MARKER -->

package/templates/global/GEMINI.md

@@ -1,17 +1,16 @@
 <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
 # p/ — Context layer for AI agents
 
-Commands: `p sync` `p task` `p done` `p ship` `p pause` `p resume` `p bug` `p dash` `p next` `p jira` `p linear` `p status` + 25 more
+Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
+Other commands: run `prjct <command> --md` and follow CLI output
 
-When user types a p command, execute the corresponding prjct CLI command with `--md` flag for context.
+Flow: idea → roadmap → next → task → done → ship → next (cycle until plan complete)
 
-Rules:
-- Never commit to main/master directly
-- All commits include footer: `Generated with [p/](https://www.prjct.app/)`
+Data:
+- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
+- Commit footer: `Generated with [p/](https://www.prjct.app/)`
 - Path resolution: `.prjct/prjct.config.json` → `~/.prjct-cli/projects/{projectId}`
-- All storage through `prjct` CLI (SQLite internally)
-- For code tasks, always start with `p task` and follow Context Contract from CLI output
-- Context7 MCP is mandatory for framework/library API decisions
+- Storage: `prjct` CLI (SQLite internally)
 
 **Auto-managed by prjct-cli** | https://prjct.app
 <!-- prjct:end - DO NOT REMOVE THIS MARKER -->

package/templates/global/WINDSURF.md

@@ -6,17 +6,16 @@ description: "prjct - Context layer for AI coding agents"
 <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
 # p/ — Context layer for AI agents
 
-Workflows: `/sync` `/task` `/done` `/ship` `/pause` `/resume` `/bug` `/dash` `/next`
+Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
+Other commands: run `prjct <command> --md` and follow CLI output
 
-When user triggers a workflow, execute the corresponding prjct CLI command with `--md` flag for context.
+Flow: idea → roadmap → next → task → done → ship → next (cycle until plan complete)
 
-Rules:
-- Never commit to main/master directly
-- All commits include footer: `Generated with [p/](https://www.prjct.app/)`
+Data:
+- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
+- Commit footer: `Generated with [p/](https://www.prjct.app/)`
 - Path resolution: `.prjct/prjct.config.json` → `~/.prjct-cli/projects/{projectId}`
-- All storage through `prjct` CLI (SQLite internally)
-- For code tasks, always start with `/task` and follow Context Contract from CLI output
-- Context7 MCP is mandatory for framework/library API decisions
+- Storage: `prjct` CLI (SQLite internally)
 
 **Auto-managed by prjct-cli** | https://prjct.app
 <!-- prjct:end - DO NOT REMOVE THIS MARKER -->

package/templates/windsurf/router.md

@@ -5,24 +5,5 @@ description: "prjct - Context layer for AI coding agents"
 
 # prjct
 
-You are using **prjct**, a context layer for AI coding agents.
-
-## Load Full Instructions
-
-1. Run: `npm root -g` to get the npm global root
-2. Read: `{npmRoot}/prjct-cli/templates/global/WINDSURF.md`
-3. Follow those instructions for ALL workflow requests
-
-## Quick Reference
-
-| Workflow | Action |
-|----------|--------|
-| `/sync` | Analyze project, generate agents |
-| `/task "..."` | Start a task |
-| `/done` | Complete subtask |
-| `/ship` | Ship with PR + version |
-
-## Note
-
-This router auto-regenerates with `/sync` if deleted.
-Full instructions are in the npm package (always up-to-date).
+Core: /sync, /task, /done, /ship, /pause, /resume, /next, /bug, /workflow
+Other: run `prjct <command> --md` and follow CLI output

package/templates/windsurf/workflows/bug.md

@@ -2,7 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/bug.md`
-
-Pass the arguments as the bug description.
+Run: `prjct bug {{args}} --md`
+Follow CLI output.

package/templates/windsurf/workflows/done.md

@@ -1,4 +1,4 @@
 # /done - Complete subtask
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/done.md`
+Run: `prjct done --md`
+Follow CLI output.

package/templates/windsurf/workflows/pause.md

@@ -1,4 +1,6 @@
 # /pause - Pause current task
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/pause.md`
+**ARGUMENTS**: {{args}}
+
+Run: `prjct pause {{args}} --md`
+Follow CLI output.

package/templates/windsurf/workflows/resume.md

@@ -1,4 +1,4 @@
 # /resume - Resume paused task
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/resume.md`
+Run: `prjct resume --md`
+Follow CLI output.

package/templates/windsurf/workflows/ship.md

@@ -2,7 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/ship.md`
-
-Pass the arguments as the ship name (optional).
+Run: `prjct ship {{args}} --md`
+Follow CLI output.

package/templates/windsurf/workflows/sync.md

@@ -1,4 +1,4 @@
 # /sync - Analyze project
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/sync.md`
+Run: `prjct sync --md`
+Follow CLI output.

package/templates/windsurf/workflows/task.md

@@ -2,7 +2,5 @@
 
 **ARGUMENTS**: {{args}}
 
-Run `npm root -g` to get npm global root, then read and execute:
-`{npmRoot}/prjct-cli/templates/commands/task.md`
-
-Pass the arguments as the task description.
+Run: `prjct task {{args}} --md`
+Follow CLI output.

package/templates/agentic/agent-routing.md

@@ -1,45 +0,0 @@
----
-allowed-tools: [Read]
----
-
-# Agent Routing
-
-Determine best agent for a task.
-
-## Process
-
-1. **Understand task**: What files? What work? What knowledge?
-2. **Read project context**: Technologies, structure, patterns
-3. **Match to agent**: Based on analysis, not assumptions
-
-## Agent Types
-
-| Type | Domain |
-|------|--------|
-| Frontend/UX | UI components, styling |
-| Backend | API, server logic |
-| Database | Schema, queries, migrations |
-| DevOps/QA | Testing, CI/CD |
-| Full-stack | Cross-cutting concerns |
-
-## Delegation
-
-```
-Task(
-  subagent_type: 'general-purpose',
-  prompt: '
-    Read: ~/.prjct-cli/projects/{projectId}/agents/{agent}.md
-    Task: {description}
-    Execute using agent patterns.
-  '
-)
-```
-
-**Pass PATH, not CONTENT** - subagent reads what it needs.
-
-## Output
-
-```
-✅ Delegated to: {agent}
-Result: {summary}
-```

package/templates/agentic/agents/uxui.md

@@ -1,63 +0,0 @@
----
-name: uxui
-description: UX/UI Specialist. Use PROACTIVELY for interfaces. Priority: UX > UI.
-tools: Read, Write, Glob, Grep
-model: sonnet
-skills: [frontend-design]
----
-
-# UX/UI Design Specialist
-
-**Priority: UX > UI** - Experience over aesthetics.
-
-## UX Principles
-
-### Before Designing
-1. Who is the user?
-2. What problem does it solve?
-3. What's the happy path?
-4. What can go wrong?
-
-### Core Rules
-- Clarity > Creativity (understand in < 3 sec)
-- Immediate feedback for every action
-- Minimize friction (smart defaults, autocomplete)
-- Clear, actionable error messages
-- Accessibility: 4.5:1 contrast, keyboard nav, 44px touch targets
-
-## UI Guidelines
-
-### Typography (avoid AI slop)
-**USE**: Clash Display, Cabinet Grotesk, Satoshi, Geist
-**AVOID**: Inter, Space Grotesk, Roboto, Poppins
-
-### Color
-60-30-10 framework: dominant, secondary, accent
-**AVOID**: Generic purple/blue gradients
-
-### Animation
-**USE**: Staggered entrances, hover micro-motion, skeleton loaders
-**AVOID**: Purposeless animation, excessive bounces
-
-## Checklist
-
-### UX (Required)
-- [ ] User understands immediately
-- [ ] Actions have feedback
-- [ ] Errors are clear
-- [ ] Keyboard works
-- [ ] Contrast >= 4.5:1
-- [ ] Touch targets >= 44px
-
-### UI
-- [ ] Clear aesthetic direction
-- [ ] Distinctive typography
-- [ ] Personality in color
-- [ ] Key animations
-- [ ] Avoids "AI generic"
-
-## Anti-Patterns
-
-**AI Slop**: Inter everywhere, purple gradients, generic illustrations, centered layouts without personality
-
-**Bad UX**: No validation, no loading states, unclear errors, tiny touch targets

package/templates/baseline/anti-patterns/nextjs.json

@@ -1,18 +0,0 @@
-{
-  "items": [
-    {
-      "issue": "Raw <img> usage in Next.js components",
-      "suggestion": "Use next/image unless there is a documented exception for external constraints.",
-      "severity": "medium",
-      "framework": "Next.js",
-      "confidence": 0.86
-    },
-    {
-      "issue": "Client components without need",
-      "suggestion": "Avoid unnecessary use client directives and keep components server-first when possible.",
-      "severity": "medium",
-      "framework": "Next.js",
-      "confidence": 0.75
-    }
-  ]
-}

package/templates/baseline/anti-patterns/react.json

@@ -1,18 +0,0 @@
-{
-  "items": [
-    {
-      "issue": "State mutation in place",
-      "suggestion": "Use immutable updates and derive state from props/data flows where possible.",
-      "severity": "high",
-      "framework": "React",
-      "confidence": 0.82
-    },
-    {
-      "issue": "UI primitives bypassing design system",
-      "suggestion": "Use approved component abstractions before introducing raw HTML controls.",
-      "severity": "medium",
-      "framework": "React",
-      "confidence": 0.74
-    }
-  ]
-}

package/templates/baseline/anti-patterns/typescript.json

@@ -1,18 +0,0 @@
-{
-  "items": [
-    {
-      "issue": "Unbounded any type",
-      "suggestion": "Use explicit types or unknown with narrowing. Add inline justification for unavoidable any.",
-      "severity": "high",
-      "language": "TypeScript",
-      "confidence": 0.9
-    },
-    {
-      "issue": "Unscoped @ts-ignore",
-      "suggestion": "Prefer @ts-expect-error with rationale and follow-up cleanup ticket.",
-      "severity": "medium",
-      "language": "TypeScript",
-      "confidence": 0.85
-    }
-  ]
-}

package/templates/baseline/patterns/nextjs.json

@@ -1,18 +0,0 @@
-{
-  "items": [
-    {
-      "name": "Use framework primitives",
-      "description": "Prefer next/image, next/link, and native Next.js routing/data primitives over ad-hoc replacements.",
-      "severity": "high",
-      "framework": "Next.js",
-      "confidence": 0.9
-    },
-    {
-      "name": "Server-first rendering model",
-      "description": "Default to server components and move interactivity to focused client boundaries.",
-      "severity": "medium",
-      "framework": "Next.js",
-      "confidence": 0.78
-    }
-  ]
-}

package/templates/baseline/patterns/react.json

@@ -1,18 +0,0 @@
-{
-  "items": [
-    {
-      "name": "Composition over duplication",
-      "description": "Extract reusable components and hooks for repeated UI/business behaviors.",
-      "severity": "medium",
-      "framework": "React",
-      "confidence": 0.8
-    },
-    {
-      "name": "Design-system-first UI",
-      "description": "Prefer project UI components/tokens to keep behavior and styling consistent.",
-      "severity": "high",
-      "framework": "React",
-      "confidence": 0.84
-    }
-  ]
-}