prompts-gpt 0.2.15 → 0.2.16

package/README.md

@@ -105,6 +105,33 @@ prompts-gpt sweep -f .prompts-gpt/sweeps/design.md -n 5
 # Preview what a sweep would do
 prompts-gpt sweep --dry-run
 
+# Run and score multiple providers on one prompt
+prompts-gpt orchestrate --mode parallel -f .prompts-gpt/review.md --providers codex,claude,cursor --criteria correctness,completeness
+
+# Chain steps with context passing
+cat > pipeline.json <<'EOF'
+[
+  {"name":"research","promptFile":".prompts-gpt/review.md","agent":"codex"},
+  {"name":"implement","promptFile":".prompts-gpt/review.md","agent":"claude"},
+  {"name":"review","promptFile":".prompts-gpt/review.md","agent":"cursor"}
+]
+EOF
+prompts-gpt orchestrate --mode pipeline --steps pipeline.json --dry-run
+
+# Run once and evaluate with explicit criteria
+prompts-gpt orchestrate --mode eval -f .prompts-gpt/review.md --criteria correctness,risk,clarity
+prompts-gpt orchestrate --mode eval --dry-run --eval-criteria correctness,risk,clarity
+
+# Re-run a prompt when the file changes
+prompts-gpt run -f .prompts-gpt/review.md --watch
+
+# Scaffold local runner config and prompt sources
+prompts-gpt doctor --fix
+
+# Inspect the worktree delta for a recent run
+prompts-gpt diff
+prompts-gpt diff <run-id>
+
 # Run a sweep with reduced output
 prompts-gpt sweep --quiet
 
@@ -116,6 +143,7 @@ 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
@@ -149,6 +177,19 @@ All options can be overridden via environment variables. See `prompts-gpt help s
 
 ---
 
+## Orchestration Patterns
+
+- `parallel`: run multiple providers against the same prompt, score outputs, and keep the strongest result with local logs and diffs.
+- `pipeline`: pass context across named steps when research, implementation, and review should be separated.
+- `eval`: run one provider and force a structured quality score for the output.
+- `eval --dry-run`: if `-f` is omitted, the CLI uses the first discovered `.prompts-gpt` prompt so workspace scaffolds can verify orchestration immediately.
+- `sweep --eval --eval-criteria correctness,completeness,...`: add self-evaluation after each successful iteration.
+- `diff <run-id>`: inspect the stored worktree delta from a prior run.
+- `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`.
+
+---
+
 ## SDK
 
 ```typescript