pdd-cli 0.0.263__tar.gz → 0.0.264__tar.gz

{pdd_cli-0.0.263/pdd_cli.egg-info → pdd_cli-0.0.264}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdd-cli
-Version: 0.0.263
+Version: 0.0.264
 Summary: PDD (Prompt-Driven Development) Command Line Interface
 Author: Greg Tanaka
 Author-email: glt@alumni.caltech.edu

{pdd_cli-0.0.263 → pdd_cli-0.0.264}/README.md

@@ -694,14 +694,15 @@ Commands:
 - `pdd detect --stories` runs the validation suite.
 - `pdd change` runs story validation after prompt modifications and fails if any story fails.
 - `pdd fix user_stories/story__*.md` applies a single story to prompts and re-validates it.
-- `pdd test <prompt_1.prompt> [prompt_2.prompt ...]` generates a `story__*.md` file and links those prompts.
+- `pdd test --issue <url|number|issue.md> <prompt_1.prompt> [prompt_2.prompt ...]` generates a `story__*.md` file from the issue text and links those prompts.
 - `pdd test user_stories/story__*.md` updates prompt links for an existing story file.
 
 Story prompt linkage:
 - Stories may include optional metadata to scope validation to a subset of prompts:
   `<!-- pdd-story-prompts: prompts/a_python.prompt, prompts/b_python.prompt -->`
 - If metadata is missing, `pdd detect --stories` validates against the full prompt set.
-- In `--stories` mode, when `detect` identifies impacted prompts, PDD caches links back into the story metadata for future deterministic runs.
+- `pdd test --issue ... <*.prompt>` links the prompt files passed on the command line directly in story metadata; it does not run `detect_change` during story authoring.
+- In `--stories` mode, existing story metadata scopes validation; when metadata is missing, validation falls back to the full prompt set.
 
 Template:
 - See `user_stories/story__template.md` for a starter format.
@@ -1930,19 +1931,20 @@ When the prompt contains a `contract_rules` section, unit test generation uses t
 
 #### Story Mode
 
-Generate or update user stories and link them to touched prompts.
+Generate issue-derived user stories or update story prompt metadata.
 
 ```
-pdd [GLOBAL OPTIONS] test prompts/upload_python.prompt prompts/notify_python.prompt
+pdd [GLOBAL OPTIONS] test --issue https://github.com/myorg/myrepo/issues/789 prompts/upload_python.prompt prompts/notify_python.prompt
+pdd [GLOBAL OPTIONS] test --issue ./issues/upload.md prompts/upload_python.prompt
 pdd [GLOBAL OPTIONS] test user_stories/story__my_flow.md
 ```
 
 Behavior:
-- If input is one or more `.prompt` files, PDD generates `user_stories/story__<name>.md`.
-- During story generation, PDD runs prompt detection and auto-links touched prompts in `pdd-story-prompts` metadata.
-- If generation-time detection finds no touched prompts, metadata falls back to the provided prompt-file inputs.
-- If `pdd-story-prompts` metadata already exists and resolves cleanly, PDD keeps it unchanged.
-- If metadata is missing (or stale), PDD runs prompt detection and writes:
+- If input is one or more `.prompt` files, `--issue` is required. The issue source can be a GitHub issue/PR URL, an issue number resolvable from the current repo, or a local issue markdown file.
+- PDD resolves the issue first and authors `user_stories/story__<name>.md` from that issue text. Prompt file content is withheld from the story author so the story can catch prompt drift from the issue intent.
+- The prompt files passed on the command line are linked directly in `pdd-story-prompts` metadata. Story generation does not run `detect_change` or auto-detect touched prompts.
+- Missing/unresolvable issue sources or invalid LLM story output fail the command instead of writing a prompt-derived fallback story.
+- `pdd test user_stories/story__*.md` updates metadata for an existing story file. If metadata is missing or stale, PDD runs prompt detection and writes:
   `<!-- pdd-story-prompts: prompt_a_python.prompt, prompt_b_python.prompt -->`
 - This enables deterministic prompt-subset validation in `pdd detect --stories`.
 

{pdd_cli-0.0.263 → pdd_cli-0.0.264}/architecture.json

@@ -470,7 +470,7 @@
     "dependencies": [],
     "priority": 18,
     "filename": "resurface_check_Python.prompt",
-    "filepath": "extensions/recruiting/resurface_check.py",
+    "filepath": "prompts/resurface_check_Python.prompt",
     "tags": [
       "backend",
       "api",
@@ -2865,8 +2865,8 @@
     "description": "Defines the prompt structure for agentic bug step4 reproduce. Invoked by the corresponding Python module to format LLM requests.",
     "dependencies": [],
     "priority": 75,
-    "filename": "agentic_bug_step4_reproduce_LLM.prompt",
-    "filepath": "prompts/agentic_bug_step4_reproduce_LLM.prompt",
+    "filename": "agentic_bug_step5_reproduce_LLM.prompt",
+    "filepath": "prompts/agentic_bug_step5_reproduce_LLM.prompt",
     "tags": [
       "agentic",
       "config",
@@ -2987,8 +2987,8 @@
     "description": "Step 10 (final step) of the agentic bug workflow. Creates a draft pull request with failing tests and links it to the GitHub issue. Includes pdd fix command for resolving the bug.",
     "dependencies": [],
     "priority": 80,
-    "filename": "agentic_bug_step10_pr_LLM.prompt",
-    "filepath": "prompts/agentic_bug_step10_pr_LLM.prompt",
+    "filename": "agentic_bug_step12_pr_LLM.prompt",
+    "filepath": "prompts/agentic_bug_step12_pr_LLM.prompt",
     "tags": [
       "agentic",
       "config",
@@ -3344,30 +3344,6 @@
       "y": 0
     }
   },
-  {
-    "reason": "LLM prompt template for extracting dependency includes from auto-include LLM output.",
-    "description": "Defines the prompt structure for extract auto include. Invoked by the corresponding Python module to format LLM requests.",
-    "dependencies": [],
-    "priority": 95,
-    "filename": "extract_auto_include_LLM.prompt",
-    "filepath": "prompts/extract_auto_include_LLM.prompt",
-    "tags": [
-      "config",
-      "extraction",
-      "llm",
-      "template"
-    ],
-    "interface": {
-      "type": "config",
-      "config": {
-        "keys": []
-      }
-    },
-    "position": {
-      "x": 1800,
-      "y": 0
-    }
-  },
   {
     "reason": "LLM prompt template for extract code operations.",
     "description": "Defines the prompt structure for extract code. Invoked by the corresponding Python module to format LLM requests.",
@@ -3957,7 +3933,7 @@
     "dependencies": [],
     "priority": 119,
     "filename": "pdd_theme_json.prompt",
-    "filepath": "pdd_theme.json",
+    "filepath": "prompts/pdd_theme_json.prompt",
     "tags": [
       "config"
     ],
@@ -4148,7 +4124,7 @@
     "dependencies": [],
     "priority": 124,
     "filename": "regression_analysis_log.prompt",
-    "filepath": "regression_analysis.log",
+    "filepath": "prompts/regression_analysis_log.prompt",
     "tags": [
       "config"
     ],
@@ -4169,7 +4145,7 @@
     "dependencies": [],
     "priority": 125,
     "filename": "regression_bash.prompt",
-    "filepath": "regression.sh",
+    "filepath": "prompts/regression_bash.prompt",
     "tags": [
       "cli",
       "shell"
@@ -4235,7 +4211,7 @@
     "dependencies": [],
     "priority": 127,
     "filename": "run_generated_python.prompt",
-    "filepath": "pdd/run_generated.py",
+    "filepath": "prompts/run_generated_python.prompt",
     "tags": [
       "generation",
       "module",
@@ -4937,7 +4913,7 @@
     "dependencies": [],
     "priority": 143,
     "filename": "prompt_tester_python.prompt",
-    "filepath": "pdd/prompt_tester.py",
+    "filepath": "prompts/prompt_tester_python.prompt",
     "tags": [
       "module",
       "python",
@@ -5395,7 +5371,8 @@
       "context_generator_main_python.prompt",
       "operation_log_python.prompt",
       "template_registry_python.prompt",
-      "track_cost_python.prompt"
+      "track_cost_python.prompt",
+      "user_story_tests_python.prompt"
     ],
     "priority": 234,
     "filename": "commands/generate_python.prompt",
@@ -5416,7 +5393,7 @@
           },
           {
             "name": "test",
-            "description": "Generate or enhance tests through agentic issue mode or manual prompt/code mode."
+            "description": "Generate or enhance unit tests, or generate/link prompt user stories."
           },
           {
             "name": "example",
@@ -5594,8 +5571,8 @@
     "description": "Step 5.5 of the agentic bug workflow. Classifies whether a bug root cause is in the code implementation or in the prompt specification itself.",
     "dependencies": [],
     "priority": 166,
-    "filename": "agentic_bug_step5_5_prompt_classification_LLM.prompt",
-    "filepath": "prompts/agentic_bug_step5_5_prompt_classification_LLM.prompt",
+    "filename": "agentic_bug_step7_prompt_classification_LLM.prompt",
+    "filepath": "prompts/agentic_bug_step7_prompt_classification_LLM.prompt",
     "tags": [
       "agentic",
       "config",
@@ -5618,8 +5595,8 @@
     "description": "Step 9 of the agentic bug workflow. Generates and runs end-to-end tests that verify a bug at the system integration level.",
     "dependencies": [],
     "priority": 167,
-    "filename": "agentic_bug_step9_e2e_test_LLM.prompt",
-    "filepath": "prompts/agentic_bug_step9_e2e_test_LLM.prompt",
+    "filename": "agentic_bug_step11_e2e_test_LLM.prompt",
+    "filepath": "prompts/agentic_bug_step11_e2e_test_LLM.prompt",
     "tags": [
       "agentic",
       "config",
@@ -8259,7 +8236,7 @@
           },
           {
             "name": "getPromptTemplate",
-            "signature": "(name: string, language: string, description?: string)",
+            "signature": "function getPromptTemplate(name: string, language: string, description?: string): string",
             "returns": "string"
           }
         ]
@@ -9046,7 +9023,7 @@
         "functions": [
           {
             "name": "Job",
-            "signature": "(id, command, args, options, status, result, error, cost, ...)",
+            "signature": "dataclass Job(id: str, command: str, args: Dict[str, Any], options: Dict[str, Any], status: JobStatus, result: Optional[Any], error: Optional[str], cost: float, created_at: datetime, started_at: Optional[datetime], completed_at: Optional[datetime], live_stdout: str, live_stderr: str)",
             "returns": "Job"
           },
           {
@@ -9667,7 +9644,7 @@
         "functions": [
           {
             "name": "write_evidence_manifest",
-            "signature": "(*, command: str, prompt_file: Optional[str | Path] = None, output_files: Iterable[str | Path] = (), model: str = \"\", cost_usd: float = 0.0, temperature: Optional[float] = None, validation: Optional[Mapping[str, str]] = None, logs: Optional[Mapping[str, Optional[str]]] = None, basename: Optional[str] = None, project_root: Optional[str | Path] = None, context_snapshot: Optional[Mapping[str, Any]] = None, grounding: Optional[Dict[str, Any]] = None, reviewed: bool = False, compression: Optional[Mapping[str, Any]] = None, agentic_fallback: Optional[Mapping[str, Any]] = None, compress: bool = False) -> Path",
+            "signature": "(*, command: str, prompt_file: Optional[str | Path] = None, output_files: Iterable[str | Path] = (), model: str = \"\", cost_usd: float = 0.0, temperature: Optional[float] = None, validation: Optional[Mapping[str, str]] = None, logs: Optional[Mapping[str, Optional[str]]] = None, basename: Optional[str] = None, project_root: Optional[str | Path] = None, context_snapshot: Optional[Mapping[str, Any]] = None, grounding: Optional[Mapping[str, Any]] = None, reviewed: bool = False, compression: Optional[Mapping[str, Any]] = None, agentic_fallback: Optional[Mapping[str, Any]] = None, compress: bool = False) -> Path",
             "returns": "Path"
           },
           {
@@ -9677,7 +9654,7 @@
           },
           {
             "name": "resolve_generate_output_paths",
-            "signature": "(prompt_file, *, output=None, ...) -> list[str]",
+            "signature": "(prompt_file: str | Path, *, output: Optional[str] = None, context_override: Optional[str] = None, force: bool = True, quiet: bool = True) -> list[str]",
             "returns": "list[str]"
           }
         ]

pdd_cli-0.0.264/context/user_story_tests_example.py

@@ -0,0 +1,106 @@
+"""Example for generating and validating PDD user stories."""
+
+import os
+import sys
+from pathlib import Path
+
+from pdd.user_story_tests import (
+    discover_prompt_files,
+    generate_user_story,
+    run_user_story_tests,
+)
+
+# Check for required API key since user story validation requires LLM calls
+api_key = os.environ.get("OPENAI_API_KEY")
+if not api_key:
+    print("OPENAI_API_KEY not set. Set it to run this example.")
+    sys.exit(0)
+
+
+def main():  # pylint: disable=too-many-locals
+    """
+    Example of using the user_story_tests module to generate and validate user stories.
+    """
+    # Setup output directories
+    output_dir = Path("./output")
+    prompts_dir = output_dir / "prompts"
+    stories_dir = output_dir / "user_stories"
+    src_dir = output_dir / "src"
+
+    for directory in [prompts_dir, stories_dir, src_dir]:
+        directory.mkdir(parents=True, exist_ok=True)
+
+    # 1. Create a dummy prompt file and the issue text that should author the story.
+    prompt_path = prompts_dir / "hello_python.prompt"
+    prompt_path.write_text(
+        "# Hello World Prompt\n"
+        "## Covers\n"
+        "- R1: The generated code must print hello world.\n\n"
+        "Write a Python function that prints hello world.",
+        encoding="utf-8",
+    )
+    issue_path = output_dir / "issue.md"
+    issue_path.write_text(
+        "# Issue: Hello command\n\n"
+        "Users need a small command that prints 'hello world' so they can "
+        "confirm the Python runtime is wired correctly.",
+        encoding="utf-8",
+    )
+
+    # 2. Discover prompt files
+    print("Discovering prompt files...")
+    discovered_prompts = discover_prompt_files(str(prompts_dir))
+    print(f"Found prompts: {[p.name for p in discovered_prompts]}\n")
+
+    # 3. Generate a user story based on the issue.
+    # Prompt content is linked as metadata but is not shown to the story author.
+    print("Generating user story...")
+    success, message, cost, model, story_path, linked_refs = generate_user_story(
+        prompt_files=[str(prompt_path)],
+        issue=str(issue_path),
+        stories_dir=str(stories_dir),
+        prompts_dir=str(prompts_dir),
+        strength=0.0,      # Use low strength for faster/cheaper generation if LLM is used
+        temperature=0.0,
+        time=0.25,
+        verbose=True,
+    )
+
+    print(f"Success: {success}")
+    print(f"Message: {message}")
+    print(f"Cost: ${cost:.6f}")
+    print(f"Model: {model}")
+    print(f"Generated Story Path: {story_path}")
+    print(f"Linked Prompts: {linked_refs}\n")
+
+    if not success:
+        print("Skipping validation because story generation failed.")
+        return
+
+    # 4. Run user story validation tests
+    # This checks if the story requires changes to the prompt files.
+    print("Running user story tests...")
+    all_passed, results, total_cost, test_model = run_user_story_tests(
+        prompts_dir=str(prompts_dir),
+        stories_dir=str(stories_dir),
+        strength=0.0,
+        temperature=0.0,
+        time=0.25,
+        verbose=False,
+        quiet=False,
+        fail_fast=False,
+    )
+
+    print(f"\nAll Passed: {all_passed}")
+    print(f"Total Validation Cost: ${total_cost:.6f}")
+    print(f"Model Used: {test_model}")
+    print("Validation Results:")
+    for res in results:
+        print(
+            f" - Story: {res['story']}, Passed: {res['passed']}, "
+            f"Changes Detected: {len(res['changes'])}"
+        )
+
+
+if __name__ == "__main__":
+    main()

pdd_cli-0.0.264/docs/checkup_prompt_quality_gate.md

@@ -0,0 +1,121 @@
+# Prompt checkup quality gate
+
+PDD keeps you in **prompt space** until a prompt source-set is clear, covered,
+evidenced, and ready to generate from. Prompt checkup is the built-in quality
+gate that runs before code generation or change.
+
+## Manual prompt checkup
+
+Inspect any prompt source-set directly:
+
+```bash
+pdd checkup prompts/refund_payment_python.prompt
+pdd checkup prompts/
+pdd checkup refund_payment
+```
+
+These targets run a unified deterministic report that orchestrates existing
+engines:
+
+- `pdd checkup lint`
+- `pdd checkup contract check`
+- `pdd checkup coverage`
+- waiver / evidence readiness via `pdd checkup gate` (plus explicit `waivers` check in the unified report)
+- snapshot policy when nondeterministic tags exist
+- optional drift readiness note when an evidence manifest exists
+
+Focused subcommands remain unchanged for CI and debugging:
+
+```bash
+pdd checkup lint <target>
+pdd checkup contract check <target>
+pdd checkup coverage <target>
+pdd checkup gate <target>
+pdd checkup snapshot <target>
+pdd checkup drift <devunit>
+```
+
+GitHub issue and PR checkup modes are unchanged:
+
+```bash
+pdd checkup https://github.com/org/repo/issues/123
+pdd checkup --pr https://github.com/org/repo/pull/123
+```
+
+## Report schema
+
+Machine-readable output uses `--json` and conforms to
+`pdd.prompt_source_set_report.v1`:
+
+- `status`: `pass`, `warn`, or `fail`
+- `target`: the CLI target string
+- `checks[]`: per-engine status summary
+- `findings[]`: deterministic findings with `id`, `source_check`, `severity`,
+  `file`, `line`, `message`, `recommended_action`, and `fix_command`
+- `actions[]`: suggested next commands
+- `deterministic_exit_code`: 0 clean, 1 warnings, 2 errors (or strict warnings)
+
+`--strict` affects deterministic exit codes only (warnings become failures in
+strict mode, including automatic `--prompt-checkup strict`). `--explain` prints a
+read-only finding summary and never changes the exit code.
+
+## Workflow hook interface
+
+Automatic prompt checkup is invoked through `maybe_run_workflow_prompt_gate()` in
+`pdd/prompt_gate.py`. Current hook points:
+
+- `pdd generate` agentic and incremental PRD paths (after prompt files are written)
+- `pdd change` manual path (`change_main`, after prompt saves)
+- `pdd change` agentic issue path (`modify`, after `run_agentic_change`)
+
+Future prompt-sync workflows should call the same helper with the list of
+touched `.prompt` paths and honor `--prompt-checkup` / `--no-prompt-checkup`.
+
+## Automatic gate
+
+When PDD creates or modifies `.prompt` files during generate or change, prompt
+checkup can run automatically on the touched files only.
+
+Modes:
+
+| Mode | Behavior |
+|------|----------|
+| `off` | No automatic checkup |
+| `warn` (default) | Report issues; do not block downstream work |
+| `strict` | Block code generation / change on deterministic failure (errors; warnings too when strict evaluation is active) |
+
+CLI:
+
+```bash
+pdd generate ... --prompt-checkup warn
+pdd generate ... --prompt-checkup strict
+pdd generate ... --no-prompt-checkup
+
+pdd change ... --prompt-checkup warn
+pdd change ... --prompt-checkup strict
+```
+
+Config (`.pddrc`, preferred):
+
+```yaml
+checkup:
+  prompt_gate: warn   # off | warn | strict
+```
+
+Fallback (`pyproject.toml`):
+
+```toml
+[tool.pdd.checkup]
+prompt_gate = "warn"   # off | warn | strict
+```
+
+CLI flags override config.
+
+Workflows with no `.prompt` changes are unaffected.
+
+## Related docs
+
+- [checkup_verifier.md](checkup_verifier.md) — verifier namespace overview
+- [prompt_lint.md](prompt_lint.md)
+- [coverage_contracts.md](coverage_contracts.md)
+- [evidence_manifest.md](evidence_manifest.md)

pdd_cli-0.0.264/docs/checkup_verifier.md

@@ -0,0 +1,37 @@
+# PDD Checkup Verifier Namespace
+
+`pdd checkup` is PDD's **verifier namespace**: one entry point for prompt
+source-set health, focused deterministic checks, and GitHub issue/PR review.
+
+## Prompt source-set health
+
+Run a unified report before generating or changing code:
+
+```bash
+pdd checkup prompts/foo_python.prompt
+pdd checkup prompts/
+pdd checkup refund_payment
+```
+
+See [checkup_prompt_quality_gate.md](checkup_prompt_quality_gate.md) for the
+automatic gate, report schema, and workflow hooks.
+
+## Focused checks (CI / debugging)
+
+| Command | Doc |
+|---------|-----|
+| `pdd checkup lint` | [prompt_lint.md](prompt_lint.md) |
+| `pdd checkup contract check` | [contract_check.md](contract_check.md) |
+| `pdd checkup coverage` | [coverage_contracts.md](coverage_contracts.md) |
+| `pdd checkup gate` | [evidence_manifest.md](evidence_manifest.md) |
+| `pdd checkup snapshot` | snapshot policy for nondeterministic tags |
+| `pdd checkup drift` | [drift.md](drift.md) |
+
+## Issue / PR checkup
+
+```bash
+pdd checkup https://github.com/org/repo/issues/123
+pdd checkup --pr https://github.com/org/repo/pull/123
+```
+
+These modes are unchanged from the agentic checkup workflow.

{pdd_cli-0.0.263 → pdd_cli-0.0.264}/docs/contract_check.md

@@ -20,6 +20,10 @@ pdd contracts check TARGET [OPTIONS]
 
 Both invoke the same engine (`pdd/contract_check.py`).
 
+Waiver authoring defects surface in contract check and in the unified prompt
+source-set report's `waivers` check. See
+[checkup_prompt_quality_gate.md](checkup_prompt_quality_gate.md).
+
 ## Quick start
 
 ```bash

{pdd_cli-0.0.263 → pdd_cli-0.0.264}/docs/prompt_lint.md

@@ -17,6 +17,17 @@ The PDD Prompt Linter analyzes prompt files (`*.prompt`) and user stories (`stor
 
 For day-to-day prompt authoring, use `--llm`. The default scan is deterministic and needs no network access.
 
+For a unified pass across lint, contract, coverage, gate readiness, and snapshot
+policy, use the prompt source-set report:
+
+```bash
+pdd checkup prompts/my_feature_python.prompt
+pdd checkup my_feature
+```
+
+See [checkup_verifier.md](checkup_verifier.md) and
+[checkup_prompt_quality_gate.md](checkup_prompt_quality_gate.md).
+
 ---
 
 ## Out of Scope (Follow-up)

{pdd_cli-0.0.263 → pdd_cli-0.0.264}/pdd/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.0.263'
-__version_tuple__ = version_tuple = (0, 0, 263)
+__version__ = version = '0.0.264'
+__version_tuple__ = version_tuple = (0, 0, 264)
 
-__commit_id__ = commit_id = 'g3b711e018'
+__commit_id__ = commit_id = 'gd5df6afb9'

{pdd_cli-0.0.263 → pdd_cli-0.0.264}/pdd/change_main.py

@@ -24,6 +24,11 @@ from .process_csv_change import process_csv_change
 from .get_extension import get_extension
 from .user_story_tests import run_user_story_tests, discover_prompt_files
 from .validate_prompt_includes import sanitize_prompt_output
+from .prompt_gate import (
+    maybe_run_workflow_prompt_gate,
+    prompt_gate_block_message,
+    resolve_prompt_gate_project_root,
+)
 
 # Set up logging
 logger = logging.getLogger(__name__)
@@ -318,6 +323,7 @@ def change_main(
                 return msg, 0.0, ""
 
         # --- 4. Save Results ---
+        saved_prompt_paths: List[Path] = []
         # Determine output path object using the potentially normalized 'output'
         output_path_obj: Optional[Path] = None
         if output:
@@ -447,6 +453,7 @@ def change_main(
                                 output_file.write(modified_content)
                             logger.debug("Saved modified prompt to: %s", individual_output_path)
                             saved_files_count += 1
+                            saved_prompt_paths.append(individual_output_path.resolve())
                         except IOError as io_error:
                             msg = f"Failed to write output file '{individual_output_path}': {io_error}"
                             if not quiet:
@@ -488,6 +495,7 @@ def change_main(
                         )
                     with open(output_path_obj, 'w', encoding='utf-8') as output_file:
                         output_file.write(result_message)  # result_message contains the modified content here
+                    saved_prompt_paths.append(output_path_obj.resolve())
                     if not quiet:
                         rprint(f"[green]Modified prompt saved to:[/green] {output_path_obj}")
                         rprint(Panel(result_message, title="Modified Prompt Content", expand=False))
@@ -507,6 +515,20 @@ def change_main(
                     logger.error(msg, exc_info=True)
                     return msg, total_cost, model_name or ""
 
+        if saved_prompt_paths:
+            should_continue, gate_exit = maybe_run_workflow_prompt_gate(
+                saved_prompt_paths,
+                cli_prompt_checkup=ctx.obj.get("prompt_checkup"),
+                no_prompt_checkup=ctx.obj.get("no_prompt_checkup", False),
+                project_root=resolve_prompt_gate_project_root(saved_prompt_paths),
+                quiet=quiet,
+            )
+            if not should_continue:
+                msg = prompt_gate_block_message(gate_exit)
+                if not quiet:
+                    rprint(f"[bold red]{msg}[/bold red]")
+                return msg, total_cost, model_name or ""
+
         # --- 5. User Story Validation (Optional) ---
         # CSV mode without an explicit output path writes individual prompt files
         # to CWD; skip story validation in that scenario to avoid failing on a