prompts-gpt 0.2.18 → 0.3.1

package/README.md

@@ -141,12 +141,11 @@ prompts-gpt models --provider codex
 # Sync model registry from cloud
 prompts-gpt sync-models
 
-# Use model aliases for shorter commands
-prompts-gpt run --model opus     # resolves to claude-opus-4-7
-prompts-gpt run --agent cursor --model opus-4.6  # resolves to claude-4.6-opus-high
-prompts-gpt run --model mini     # resolves to gpt-5.4-mini
-prompts-gpt run --model pro      # resolves to gpt-5.5-pro
-prompts-gpt run --model o3       # resolves to o3
+# Use canonical model names only
+prompts-gpt run --agent claude --model claude-opus-4-7
+prompts-gpt run --agent cursor --model claude-4.6-opus-high
+prompts-gpt run --agent codex --model gpt-5.4-mini
+prompts-gpt run --agent codex --model gpt-5.5
 
 # Sync from cloud
 prompts-gpt sync --agent all
@@ -188,6 +187,22 @@ All options can be overridden via environment variables. See `prompts-gpt help s
 - `run --watch`: rerun automatically when the prompt file changes.
 - `doctor --fix`: scaffold `.prompts-gpt/config.json`, detect prompt sources, and add the artifacts directory to `.gitignore`.
 
+### Visibility implementation workflow
+
+Use orchestration after a monitor or checker identifies a concrete gap:
+
+1. Export the prompt, answer evidence, cited URLs, and desired fix from Prompts-GPT.com.
+2. Run `prompts-gpt orchestrate --mode parallel` when multiple agents should propose competing fixes.
+3. Run `prompts-gpt orchestrate --mode pipeline` when research, implementation, and review should stay separated.
+4. Run `prompts-gpt orchestrate --mode eval` or `prompts-gpt sweep --eval --eval-criteria correctness,risk,clarity` when output quality needs a score.
+5. Run `prompts-gpt diff <run-id>` before sharing the worktree changes.
+
+Dry-runs verify command wiring, prompt resolution, evaluator selection, and criteria parsing without launching a provider:
+
+```bash
+npx prompts-gpt orchestrate --mode eval --dry-run --eval-criteria correctness,risk,clarity
+```
+
 ---
 
 ## SDK