Skip to content

ci(prompt): renumber PROMPT.md to 24 steps and stop blocking on recoverable state - #19

Merged
eilandert merged 2 commits into
mainfrom
prompt-restructure
Aug 4, 2026
Merged

eilandert merged 2 commits into
mainfrom
prompt-restructure

Conversation

@eilandert

Copy link
Copy Markdown
Member

Restructures ci/PROMPT.md only. No workflow, script or module change.

TL;DR

The adoption prompt was numbered as eleven checkpoints (0–10) across six phases
labelled −1 to 4, with sub-lettered items (4a/4b/4c, 7a/7b, 10a–10h).
A phase numbered −1 and a checkpoint that is three separate jobs behind one number
are both unusable as work units. It is now 24 continuously numbered steps in 6
phases
, each step small enough to hand to a cheap model with this file and
nothing else: its own inputs, its own Acceptance line, and where its output goes.

It also stopped blocking. Most of the old stop conditions made an unattended run
end at step 3 with a question instead of finishing 22 of 24 steps and reporting
the two it could not do.

What changed

Renumbering. Phases −1..4 → 1..6; checkpoints 0–10 → steps 1–24. No letters
anywhere. Every cross-reference in the file was rewritten to the new numbers.

Splitting. The checkpoints that carried several independent jobs became
separate steps:

Was Now
cp 0 (inventory) 1 set up the run · 2 scope and git safety · 3 inventory and baseline
cp 2 (ci/ move) 5 the git mv · 6 the path-climb fixes
cp 4a/4b/4c 8 demotion · 9 workflow set · 10 badges
cp 5 (four test layers) 11 unit · 12 live-server · 14 coverage
cp 10a–10h 17–22

Blockers. A new ## Work autonomously — record, do not ask section replaces
the old stop-condition table. Three hard stops remain: not a git repository, no
push access, and a fix that requires weakening an existing gate (rule 2 — that is
the coverage regression the whole job exists to prevent). Everything else records
and continues:

  • dirty target tree → note the paths, branch off HEAD, never git stash
  • baseline suite already red → record, branch anyway, state it in every PR body
  • a gate red twice → three attempts, then park the step and move on
  • a step needing a behavioural change → land the rest, record the change, mark
    the gate thin
  • a missing secret or runner → degrade to hosted, or omit the job, and name what
    is missing

Findings go somewhere. Two scratch files are created at step 1:
adoption-findings.md for the target and skeleton-findings.md for this repo.
Step 23 turns the second into one PR back here — the actual code fix where one is
possible, a ci/feedback/<target>-<date>.md where the finding needs a decision or
hardware we do not have. An empty file means no PR.

Close-out. Step 24 ends by asking the user which of four follow-ups to run:
recheck the implementation, install and optionally run the commit hook, review the
diff, or a full code review of the module's C. None runs unattended. Report
question 5 changed from "Stopped" to "Parked and degraded", since the run no
longer stops and that is where unfinished work is now accounted for.

Testing

No executable content. Verified mechanically against the rewritten file:

  • grep -nE 'checkpoint|phase −1|10[a-h]\.|4[abc]\.|7[ab]\.' — no hits
  • every step N reference resolves to a heading that exists
  • headings run 1–24 with no gaps and no duplicates, across phases 1–6

The pre-commit hook ran; actionlint and shellcheck skipped, having no files in
scope.

Checkpoints 0-10 with 4a/7b/10a-h sub-letters became 24 continuously
numbered steps in 6 phases. Phase -1 and phase 0 are gone; every step is
small enough to hand to a cheap model with its own inputs and an
Acceptance line.

Most stop conditions are now recorded findings instead: a dirty tree, a
red baseline, a gate red twice, a needed behavioural change and a missing
secret or runner all degrade and continue. Three hard stops remain: not a
git repo, no push access, and weakening an existing gate.

Findings accumulate in two scratch files during the run. Step 23 turns
the skeleton half into one PR back here - a code fix where possible, a
ci/feedback/<target>-<date>.md where a decision is needed. Step 24 ends
by offering a recheck, the commit hook, a diff review and a full code
review.
@coderabbitai

coderabbitai Bot commented Aug 4, 2026 •

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@eilandert, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 51 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: ce2374c7-3735-4908-9525-fcdc6c1bc574

📥 Commits

Reviewing files that changed from the base of the PR and between 1465183 and 9383eb6.

📒 Files selected for processing (1)
  • ci/PROMPT.md

Walkthrough

ci/PROMPT.md replaces an 11-checkpoint process with a six-phase, 24-step CI adoption process. It adds findings, controlled continuation, decision-seam refactoring, runner and workflow verification, expanded test validation, depth audits, closeout reporting, and merge checks.

Changes

CI adoption workflow

Layer / File(s) Summary
Process model and execution rules
ci/PROMPT.md
The prompt defines 24 steps across six phases. It adds findings files, continuation rules, hard stops, setup procedures, scope controls, rollback, and write boundaries.
Decision seam and CI layout
ci/PROMPT.md
Inventory now records decision-seam evidence, workflow classifications, runner ownership, entry points, and durations. Decision-seam extraction, CI relocation, path repair, runner identity, and verification receive separate steps.
Workflow orchestration and test layers
ci/PROMPT.md
The prompt defines runner probes, a single-orchestrator workflow, trigger safeguards, reusable-workflow behavior, badge requirements, unit and live-server tests, and fuzzing contracts.
Coverage, tooling, topology, and depth validation
ci/PROMPT.md
Coverage is report-only. Caching, linting, runner topology, sanitizers, fuzzing, helgrind, soak tests, timing, and audit requirements are expanded.
Closeout and merge reporting
ci/PROMPT.md
The process adds skeleton findings, documentation, memory, degraded-state accounting, post-report choices, current-head verification, and scaled follow-up reporting.

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the prompt renumbering and the change to continue past recoverable conditions.
Description check ✅ Passed The description accurately explains the prompt restructuring, autonomous continuation rules, findings files, validation, and unchanged executable code.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch prompt-restructure
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch prompt-restructure

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4


ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 990ba4ac-e2ef-437d-b4de-f7df52fb1b7a

📥 Commits

Reviewing files that changed from the base of the PR and between 4cff5dd and 1465183.

📒 Files selected for processing (1)
  • ci/PROMPT.md

Comment thread ci/PROMPT.md Outdated
Comment thread ci/PROMPT.md Outdated
Comment thread ci/PROMPT.md
Comment thread ci/PROMPT.md Outdated
Three of these were the blocking behaviour the restructure set out to
remove, left behind in individual steps after the stop table was rewritten.

- step 1 checks viewerPermission, not just gh auth status; a read-only
  account passed the old check and failed at the first push six steps in
- step 4 acceptance requires the baseline to be UNCHANGED rather than
  green, so a target that was already red at step 3 can complete it
- step 13 no longer says to stop when the seam is missing; it records the
  degradation and continues without building a target over a copy
- the write-boundary rule scopes to repositories, so the scratch findings
  files step 1 creates are not an apparent violation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant