prjct-cli 2.53.0 → 2.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "prjct-cli",
3
- "version": "2.53.0",
3
+ "version": "2.54.0",
4
4
  "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
5
5
  "main": "dist/bin/prjct.mjs",
6
6
  "bin": {
@@ -1,6 +1,6 @@
1
1
  # AGENTS.md
2
2
 
3
- AI assistant guidance for **prjct-cli** - context layer for AI coding agents. Works with Claude Code, Gemini CLI, and more.
3
+ AI assistant guidance for **prjct-cli** - context layer for AI coding agents. Works with Claude Code, Codex, Gemini CLI, OpenCode, Qwen Code, Cline, Cursor, Windsurf, and any AGENTS.md-aware runtime.
4
4
 
5
5
  ## What This Is
6
6
 
@@ -10,31 +10,15 @@ AI assistant guidance for **prjct-cli** - context layer for AI coding agents. Wo
10
10
 
11
11
  ---
12
12
 
13
- ## Dynamic Agent Generation
13
+ ## Agent Contract
14
14
 
15
- Generate agents during `p. sync` based on analysis:
16
-
17
- ```javascript
18
- await generator.generateDynamicAgent('agent-name', {
19
- role: 'Role Description',
20
- expertise: 'Technologies, versions, tools',
21
- responsibilities: 'What they handle'
22
- })
23
- ```
24
-
25
- ### Guidelines
26
- 1. Read `analysis/repo-summary.md` first
27
- 2. Create specialists for each major technology
28
- 3. Name descriptively: `go-backend` not `be`
29
- 4. Include versions and frameworks found
30
- 5. Follow project-specific patterns
15
+ Run `prjct <command> --md` and follow the CLI output. Prefer `prjct_*` MCP tools when the active client exposes them.
31
16
 
32
17
  ## Architecture
33
18
 
34
19
  **Global**: `~/.prjct-cli/projects/{id}/`
35
20
  ```
36
21
  prjct.db # SQLite database (all state)
37
- context/ # now.md, next.md
38
22
  agents/ # domain specialists
39
23
  ```
40
24
 
@@ -44,21 +28,21 @@ agents/ # domain specialists
44
28
 
45
29
  | Command | Action |
46
30
  |---------|--------|
47
- | `p. init` | Initialize |
48
- | `p. sync` | Analyze + generate agents |
49
- | `p. task X` | Start task |
50
- | `p. done` | Complete subtask |
51
- | `p. ship` | Ship feature |
52
- | `p. next` | Show queue |
31
+ | `prjct init` | Initialize |
32
+ | `prjct sync --md` | Analyze + refresh agent context |
33
+ | `prjct task "X" --md` | Start task |
34
+ | `prjct status done --md` | Complete active task |
35
+ | `prjct ship --md` | Ship feature |
36
+ | `prjct status --md` | Show current task/workflow state |
53
37
 
54
38
  ## Intent Detection
55
39
 
56
40
  | Intent | Command |
57
41
  |--------|---------|
58
- | Start task | `p. task` |
59
- | Finish | `p. done` |
60
- | Ship | `p. ship` |
61
- | What's next | `p. next` |
42
+ | Start task | `prjct task "<desc>" --md` |
43
+ | Finish | `prjct status done --md` |
44
+ | Ship | `prjct ship --md` |
45
+ | What's active | `prjct status --md` |
62
46
 
63
47
  ## Implementation
64
48
 
@@ -7,16 +7,16 @@ description: Use when user mentions p., prjct, task tracking, or workflow comman
7
7
 
8
8
  Grammar: `p. <command> [args]` or `prjct <command> --md`
9
9
 
10
- Core commands: sync, task, done, ship, pause, resume, next, bug, workflow, tokens
11
- Integrations: linear, jira, enrich
10
+ Core commands: sync, task, status, ship, bug, workflow, spec, guard, capture, remember, context
11
+ Integrations: linear, jira
12
12
  Other: run `prjct <command> --md` and follow CLI output
13
13
 
14
- Flow: idea → roadmap next → task → doneshipnext (cycle until plan complete)
14
+ Flow: idea → spec when warranted → task → workstatus done ship
15
15
 
16
16
  Rules:
17
17
  - Persist everything (memories, captures, specs) in ENGLISH, whatever language the user speaks
18
18
  - prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
19
19
  - All commits include footer: `Generated with [p/](https://www.prjct.app/)`
20
20
  - All storage through `prjct` CLI (SQLite internally)
21
- - Start code tasks with `p. task` and follow Context Contract from CLI output
21
+ - Start code tasks with `prjct task "<desc>" --md` and follow the CLI output
22
22
  - Worktree hygiene: if working in a git worktree, remove it AFTER its PR merges — `git worktree remove` from the main worktree; never with uncommitted/unpushed work, never `--force`
@@ -7,10 +7,10 @@ description: Use when the user mentions p., prjct, tasks, specs, shipping, or pr
7
7
 
8
8
  Run `prjct <command> --md` and follow its output. Pull context on demand; never dump it all.
9
9
 
10
- - Flow: `task` → work → `done` → `ship`
10
+ - Flow: `prjct task` → work → `prjct status done` → `prjct ship`
11
11
  - Memory (write in ENGLISH always): `prjct remember <decision|gotcha|learning|fact> "<text>"`, `prjct context memory <topic>` (recall), `prjct guard <file>` (preventive memory before editing)
12
12
  - Capture stray thoughts: `prjct capture "<text>"`
13
13
  - Worktrees: remove only AFTER the PR merges, from the main worktree; never with unpushed work.
14
- - Run `prjct --help` for the full command list; prefer the prjct MCP tools (`prjct_*`) when available.
14
+ - `prjct --help` lists commands; prefer prjct MCP tools (`prjct_*`) when available.
15
15
 
16
16
  Commit footer: `Generated with [p/](https://www.prjct.app/)`
@@ -5,5 +5,5 @@ alwaysApply: true
5
5
 
6
6
  # prjct
7
7
 
8
- Core: /sync, /task, /done, /ship, /pause, /resume, /next, /bug, /workflow
8
+ Core: /sync, /task, /status, /ship, /bug, /workflow, /spec, /guard
9
9
  Other: run `prjct <command> --md` and follow CLI output
@@ -1,10 +1,10 @@
1
1
  <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
2
2
  # p/ — Context layer for AI agents
3
3
 
4
- Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
4
+ Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
5
5
  Other commands: run `prjct <command> --md` and follow CLI output
6
6
 
7
- Flow: idea → roadmap next → task → doneshipnext (cycle until plan complete)
7
+ Flow: idea → spec when warranted → task → workstatus done ship
8
8
 
9
9
  Data:
10
10
  - prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
@@ -6,10 +6,10 @@ alwaysApply: true
6
6
  <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
7
7
  # p/ — Context layer for AI agents
8
8
 
9
- Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
9
+ Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
10
10
  Other commands: run `prjct <command> --md` and follow CLI output
11
11
 
12
- Flow: idea → roadmap next → task → doneshipnext (cycle until plan complete)
12
+ Flow: idea → spec when warranted → task → workstatus done ship
13
13
 
14
14
  Data:
15
15
  - prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
@@ -1,10 +1,10 @@
1
1
  <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
2
2
  # p/ — Context layer for AI agents
3
3
 
4
- Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
4
+ Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
5
5
  Other commands: run `prjct <command> --md` and follow CLI output
6
6
 
7
- Flow: idea → roadmap next → task → doneshipnext (cycle until plan complete)
7
+ Flow: idea → spec when warranted → task → workstatus done ship
8
8
 
9
9
  Data:
10
10
  - Persist everything (memories, captures, specs) in ENGLISH, whatever language the user speaks
@@ -269,7 +269,7 @@ prjctDb.setDoc(projectId, 'key', data)
269
269
  p. task "add feature X"
270
270
 
271
271
  # Switch to Gemini, continue
272
- p. done # Should work seamlessly
272
+ prjct status done --md # Should work seamlessly
273
273
 
274
274
  # Switch back to Claude
275
275
  p. ship # Should read Gemini's changes correctly
@@ -6,10 +6,10 @@ description: "prjct - Context layer for AI coding agents"
6
6
  <!-- prjct:start - DO NOT REMOVE THIS MARKER -->
7
7
  # p/ — Context layer for AI agents
8
8
 
9
- Skills auto-activate for: task, done, pause, resume, ship, next, sync, bug, workflow, enrich, linear, jira, plan, velocity, tokens
9
+ Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
10
10
  Other commands: run `prjct <command> --md` and follow CLI output
11
11
 
12
- Flow: idea → roadmap next → task → doneshipnext (cycle until plan complete)
12
+ Flow: idea → spec when warranted → task → workstatus done ship
13
13
 
14
14
  Data:
15
15
  - prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
@@ -5,5 +5,5 @@ description: "prjct - Context layer for AI coding agents"
5
5
 
6
6
  # prjct
7
7
 
8
- Core: /sync, /task, /done, /ship, /pause, /resume, /next, /bug, /workflow
8
+ Core: /sync, /task, /status, /ship, /bug, /workflow, /spec, /guard
9
9
  Other: run `prjct <command> --md` and follow CLI output