diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md new file mode 100644 index 0000000..ce913c0 --- /dev/null +++ b/.planning/ROADMAP.md @@ -0,0 +1,5 @@ +# Roadmap + +## Current Focus + +Maintain accurate, reproducible portfolio demo documentation. diff --git a/.planning/STATE.md b/.planning/STATE.md new file mode 100644 index 0000000..5c3ef01 --- /dev/null +++ b/.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/) | diff --git a/.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-PLAN.md b/.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-PLAN.md new file mode 100644 index 0000000..ab4b458 --- /dev/null +++ b/.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. diff --git a/.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-SUMMARY.md b/.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-SUMMARY.md new file mode 100644 index 0000000..fd458b7 --- /dev/null +++ b/.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`. diff --git a/.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-VERIFICATION.md b/.planning/quick/260610-ppt-fix-pr-3-follow-up-readme-monitor-wordin/260610-ppt-VERIFICATION.md new file mode 100644 index 0000000..79b4af6 --- /dev/null +++ b/.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. diff --git a/README.md b/README.md index cf8f86f..b7ae683 100644 --- a/README.md +++ b/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) diff --git a/memory/examples/20260610_autopilot-demo_boundary-readme.md b/memory/examples/20260610_autopilot-demo_boundary-readme.md new file mode 100644 index 0000000..5bfe187 --- /dev/null +++ b/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. diff --git a/memory/examples/20260610_readme-monitor-target.md b/memory/examples/20260610_readme-monitor-target.md new file mode 100644 index 0000000..349e4e9 --- /dev/null +++ b/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.