Harden autopilot-demo portfolio docs

.planning/ROADMAP.md

@@ -0,0 +1,5 @@
+# Roadmap
+
+## Current Focus
+
+Maintain accurate, reproducible portfolio demo documentation.

.planning/STATE.md

@@ -0,0 +1,13 @@
+# Project State
+
+Last activity: 2026-06-10 - Completed quick task 260610-ppt: Correct README monitor wording to match autopilot-demo
+
+### Blockers/Concerns
+
+None.
+
+### Quick Tasks Completed
+
+| # | Description | Date | Commit | Status | Directory |
+|---|-------------|------|--------|--------|-----------|
+| 260610-ppt | Correct README monitor wording to match autopilot-demo | 2026-06-10 | this atomic task commit | Verified | [260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin](./quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/) |

.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-PLAN.md

@@ -0,0 +1,29 @@
+---
+quick_id: 260610-ppt
+mode: quick-full
+status: complete
+date: 2026-06-10
+---
+
+# Correct README monitor wording to match autopilot-demo
+
+## Goal
+
+Correct the PR #3 follow-up wording so the README comment names the same repository queried by the following command.
+
+## Tasks
+
+1. Update the README monitoring comment from `autopilot-core` to `autopilot-demo`.
+2. Record the successful fix in `memory/examples/` as required by `AGENTS.md`.
+3. Verify the intended wording, unchanged command target, branch, and patch formatting.
+
+## Must Haves
+
+- The monitoring comment says `Monitor autopilot-demo for the fix PR`.
+- The following command remains `gh pr list -R Coding-Autopilot-System/autopilot-demo`.
+- `git diff --check` passes.
+- The work remains on `docs/portfolio-hardening-20260610`.
+
+## Plan Check
+
+Passed: the plan covers the requested wording correction, repo-local memory requirement, branch constraint, and explicit validation gate without unrelated changes.

.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-SUMMARY.md

@@ -0,0 +1,19 @@
+---
+quick_id: 260610-ppt
+status: complete
+date: 2026-06-10
+---
+
+# Summary
+
+Corrected the README monitoring comment so it names `autopilot-demo`, matching the following `gh pr list` command.
+
+## Changes
+
+- Updated one README comment.
+- Added the repo-required successful-fix memory entry.
+- Bootstrapped minimal local GSD project state and recorded this validated quick task.
+
+## Result
+
+The PR monitoring instruction and command now consistently target `autopilot-demo`.

.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-VERIFICATION.md

@@ -0,0 +1,20 @@
+---
+quick_id: 260610-ppt
+status: passed
+date: 2026-06-10
+---
+
+# Verification
+
+## Checks
+
+- Passed: current branch is `docs/portfolio-hardening-20260610`.
+- Passed: `# Monitor autopilot-demo for the fix PR` exists exactly once.
+- Passed: `# Monitor autopilot-core for the fix PR` is absent.
+- Passed: `gh pr list -R Coding-Autopilot-System/autopilot-demo` remains present exactly once.
+- Passed: `gsd-sdk query init.quick` detects both roadmap and planning state.
+- Passed: `git diff --check`.
+
+## Status
+
+Passed. All task must-haves are satisfied.

README.md

@@ -4,9 +4,15 @@
 [![Demo CI](https://github.com/Coding-Autopilot-System/autopilot-demo/actions/workflows/demo-ci.yml/badge.svg?branch=main)](https://github.com/Coding-Autopilot-System/autopilot-demo/actions/workflows/demo-ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-**Demo target for the Coding-Autopilot-System AI repair pipeline** — triggers intake workflows when CI fails, demonstrating end-to-end agentic fix from failure detection to pull request.
+**Demo target for the Coding-Autopilot-System AI repair pipeline** - triggers intake workflows when CI fails, demonstrating the end-to-end path from failure detection to pull request.
 
-Part of the [Coding-Autopilot-System](https://github.com/Coding-Autopilot-System) autonomous CI repair platform. The control plane lives in [autopilot-core](https://github.com/Coding-Autopilot-System/autopilot-core).
+Part of the [Coding-Autopilot-System](https://github.com/Coding-Autopilot-System) autonomous CI repair platform. The control plane lives in [autopilot-core](https://github.com/Coding-Autopilot-System/autopilot-core), and the runner-hosted worker/runtime pattern lives in [ci-autopilot](https://github.com/Coding-Autopilot-System/ci-autopilot).
+
+## Repo boundary
+
+- `autopilot-demo` is not the operator and not the worker host. It is the demonstration target repo.
+- `autopilot-core` owns queue scanning, Codex invocation, and PR creation.
+- `ci-autopilot` shows the worker/runtime implementation used to process queued repair tasks.
 
 ## How the demo works
 
@@ -35,20 +41,34 @@ gh workflow run demo-ci.yml -R Coding-Autopilot-System/autopilot-demo
 # Watch for the intake issue to be created
 gh issue list -R Coding-Autopilot-System/autopilot-demo --label autofix --label queued
 
-# Monitor autopilot-core for the fix PR
+# Monitor autopilot-demo for the fix PR
 gh pr list -R Coding-Autopilot-System/autopilot-demo
 ```
 
+## Demo runbook
+
+1. Trigger [`.github/workflows/demo-ci.yml`](.github/workflows/demo-ci.yml) to produce a known failure signal.
+2. Confirm [`.github/workflows/autopilot-create-issue.yml`](.github/workflows/autopilot-create-issue.yml) creates an `autofix + queued` issue.
+3. Watch `autopilot-core` pick up the issue and open a PR back into this repo.
+4. Use this repo's issue, branch, and PR history as the audit trail for the demo.
+
+## Enterprise proof points
+
+- Demonstrates bounded blast radius: the platform proposes a fix in a dedicated target repo before broader rollout.
+- Produces an auditable story for reviewers: failure event, queued issue, operator pickup, and PR are visible artifacts.
+- Keeps the demo reproducible with workflow-dispatch entry points rather than hidden local steps.
+
 ## Workflows
 
 | Workflow | Purpose |
 |----------|---------|
-| `ci.yml` | Portfolio CI — YAML validation (always passes) |
-| `demo-ci.yml` | Demo trigger — simulates CI activity to test intake flow |
-| `autopilot-create-issue.yml` | Intake — creates autofix+queued issue on workflow failure |
+| `ci.yml` | Portfolio CI - YAML validation (always passes) |
+| `demo-ci.yml` | Demo trigger - simulates CI activity to test intake flow |
+| `autopilot-create-issue.yml` | Intake - creates `autofix + queued` issue on workflow failure |
 
 ## Documentation
 
-- [Wiki](https://github.com/Coding-Autopilot-System/autopilot-demo/wiki) — setup guide, architecture, configuration reference
-- [autopilot-core](https://github.com/Coding-Autopilot-System/autopilot-core) — operator control plane
+- [Wiki](https://github.com/Coding-Autopilot-System/autopilot-demo/wiki) - setup guide, architecture, configuration reference
+- [autopilot-core](https://github.com/Coding-Autopilot-System/autopilot-core) - operator control plane
+- [ci-autopilot](https://github.com/Coding-Autopilot-System/ci-autopilot) - worker/runtime reference
 - [Coding-Autopilot-System org](https://github.com/Coding-Autopilot-System)

memory/examples/20260610_autopilot-demo_boundary-readme.md

@@ -0,0 +1,8 @@
+# 20260610_autopilot-demo_boundary-readme
+
+Issue Description: README did not strongly frame the repo as the demo target in a three-repo story.
+State: The demo flow was present, but the target-only role and audit value were underexplained.
+Action: Added repo boundary language, a concise demo runbook, and enterprise proof points in `README.md`.
+Result: The repo now reads as a bounded demonstration target with a clear audit trail.
+Diff Patch: Updated `README.md` only.
+Rationale: Hiring reviewers should understand why the demo repo exists and how to reproduce the story quickly.

memory/examples/20260610_readme-monitor-target.md

@@ -0,0 +1,8 @@
+# 20260610_readme-monitor-target
+
+Issue Description: The README said to monitor `autopilot-core`, but the command listed PRs from `autopilot-demo`.
+State: The prose and command target disagreed.
+Action: Changed the monitoring comment to name `autopilot-demo`.
+Result: The README now accurately describes the command that follows.
+Diff Patch: Updated one comment in `README.md`.
+Rationale: Operational documentation should name the repository actually queried by the command.