@kitsy/coop 2.1.1 → 2.2.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.
Files changed (3) hide show
  1. package/README.md +11 -0
  2. package/dist/index.js +1550 -371
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -23,10 +23,21 @@ For AI-oriented command discovery:
23
23
  coop help-ai
24
24
  coop help-ai --format json
25
25
  coop help-ai --format markdown
26
+ coop help-ai --selection --format markdown
27
+ coop help-ai --state-transitions --format json
28
+ coop help-ai --artifacts --format markdown
29
+ coop help-ai --post-execution --format markdown
26
30
  coop help-ai --initial-prompt --strict --repo C:/path/to/repo --delivery MVP --command coop.cmd
31
+ coop help-ai --initial-prompt --rigour balanced --repo C:/path/to/repo --delivery MVP --command coop.cmd
27
32
  coop config artifacts.dir docs/agent-artifacts
28
33
  ```
29
34
 
35
+ Agent contract notes:
36
+ - `coop complete task <id>` requires the task to already be in `in_review`.
37
+ - balanced initial prompts are the recommended default for normal implementation sessions.
38
+ - if an agent is unsure about selection, transitions, artifacts, or whether it should continue, it should call the matching focused `help-ai` topic command instead of guessing.
39
+ - strict initial prompts tell agents to stop after completing the selected task instead of auto-picking another one.
40
+
30
41
  On Windows PowerShell, the global npm install may resolve `coop` to `coop.ps1` first. If an agent or CI shell hits execution-policy issues, use `coop.cmd` explicitly.
31
42
 
32
43
  Both entrypoints operate on the nearest parent `.coop/` workspace. If no workspace log target exists, CLI errors fall back to `~/.coop/logs/cli.log` or `COOP_HOME/logs/cli.log`.