Skip to content

PP-C3: document that every run is described (v0.5.1, 3/3) - #261

Merged
guijacquemet merged 4 commits into
mainfrom
claude/pp-c3-docs
Nov 10, 2026
Merged

guijacquemet merged 4 commits into
mainfrom
claude/pp-c3-docs

Conversation

@guijacquemet

Copy link
Copy Markdown
Contributor

PP-C3 of 3 (stacked on #260, which is stacked on #259): PP-C, the first change of v0.5.1. Base claude/pp-c-cleanup. Docs only. Do not merge before the independent review; retarget as the stack merges.

Summary

  • CHANGELOG — new "Unreleased (v0.5.1)" section, "PP-C: every run is described": the A_DESCRIPTION_REQUIRED refusal on every route; the removed undescribed run, design input, manifest versions and notebook mode; the described make_clean_run; the test changes (PP-C1 and PP-C2); what stays until SWEEP-PP; the downstream note.
  • docs/contract.md — new §0 "Every run is described" (the route table and what PP-C removed; position_id unchanged, owner ruling 2); §9 is "manifest version 4" (the manifest_version row rewritten: one version written and read, older ones refused with "run preprocessing again"; experiment_description always present; experiment_design_sha256 is the derived file's); §9.1 RunInputs refusals and the described make_clean_run; §12 experiment_design.csv is an output only (the CLI --design, template and design command rows marked removed).
  • README, user guide, AGENTS.md — the describe-first workflow; no design command, --design or check template; required_description and tests/described_tree.py in the module map.

Not changed: docs/conformance.md (the dated v0.5.0 G1 record), docs/plan.md and docs/archive/ (history), docs/migration-0.3-to-0.4.md (SWEEP-PP).

Tests

The tree of this PR is the tree validated as a whole: ruff check ., ruff format --check . clean, code rules clean; pytest 4965 passed, 4 skipped (environment skips only); Spec modules 1665 passed, 0 skipped.


Generated by Claude Code

…ct, guides)

- CHANGELOG: an "Unreleased (v0.5.1)" section for PP-C (PP-C1 to PP-C3), with what stays
  for SWEEP-PP and the downstream impact.
- docs/contract.md: a new §0 (every run is described, A_DESCRIPTION_REQUIRED on every
  route, what PP-C removed); §9 manifest version 4 only; §9.1 RunInputs refusals and the
  described make_clean_run; §12 experiment_design.csv is an output only (the removed rows
  marked).
- README, user guide, AGENTS.md: the describe-first workflow; no design command, --design
  or check template; the new module and test helper.

Docs only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G3qp9AxjpGPw9xfWAUJNqc
…us and plan rows

The contract's check row still said check writes the design template (write_check_outputs),
the exit status row listed the design command and its design checks, and the notebook row
planned_changes(design=) and design_for_run: all removed in PP-C2. Section 0 says the refusal
comes before the recorded run, any header, the log or the stale-lock removal. CHANGELOG: the
shipped notebook stays on RELEASE_REF's API until the release; the refusal texts. User guide:
repeat_group_conflict names the Replicates page and Check and save.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G3qp9AxjpGPw9xfWAUJNqc
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G3qp9AxjpGPw9xfWAUJNqc
Base automatically changed from claude/pp-c-cleanup to main November 10, 2026 09:21
@guijacquemet
guijacquemet merged commit cf69fd5 into main Nov 10, 2026
7 checks passed
@guijacquemet
guijacquemet deleted the claude/pp-c3-docs branch November 10, 2026 09:21
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.

2 participants