Skip to content

docs: refresh documentation for v1.2.0 elevation#2

Merged
mumit merged 1 commit into
mainfrom
codex/docs-refresh
May 2, 2026
Merged

docs: refresh documentation for v1.2.0 elevation#2
mumit merged 1 commit into
mainfrom
codex/docs-refresh

Conversation

@mumit

@mumit mumit commented May 2, 2026

Copy link
Copy Markdown
Owner

Summary

Documentation freshness sweep — verifies every doc accurately reflects the v1.2.0 elevation work that landed in #1. No code changes, no behavior changes.

What changed (9 files, +147/-13)

Root docs

  • README.md — replaced stale single-version v1.0.0 is at feature parity... claim with a three-paragraph v1.0/v1.1/v1.2 framing. Added npm run budget -- init/update/check and npm run visualize to the CLI list (present in package.json but absent from docs).
  • AGENTS.md — added the same four budget/visualize entries to the command-shim table.
  • CHANGELOG.md — fixed cross-refs from non-existent docs/releases/ to the real docs/release-notes/ directory.

Rules

  • .codex/rules/compaction.md — corrected stage numbers in items 6 & 7: review files / round count is Stage 6 (peer review), not Stage 5 (which is pre-review/lint/SCA in codex's collapsed numbering).

Skills

  • .codex/skills/pipeline/SKILL.md — added npm run visualize and npm run budget -- check to the Finish section so v1.2.0 runtime features are surfaced in the skill.

Parity / release docs

  • docs/parity/claude-dev-team-parity.md — added budget tracking, pipeline visualization, and async-checkpoint auto-pass to "Codex Improvements Beyond Claude". Bumped Last updated.
  • docs/release-notes/v1.1.0.md (new) — matches CHANGELOG v1.1.0 entry.
  • docs/release-notes/v1.2.0.md (new) — matches CHANGELOG v1.2.0 (unreleased) entry.

Runtime artifact hygiene

  • .gitignore — added pipeline/diagram.md (runtime output of npm run visualize; was surfacing as untracked).

VERSION decision

Kept at 1.0.0. v1.2.0 is documented as unreleased on this PR branch. Per CONTRIBUTING.md conventions, the VERSION bump belongs in a dedicated release commit, not in a docs sweep.

Test plan

  • npm test — 169/169 pass
  • npm run doctor — all PASS
  • npm run parity:check — 23/23 commands, 7/7 rules, 6/6 skills, 0 gaps
  • npm run lint — clean

🤖 Generated with Claude Code

- README.md: updated Status section from stale v1.0.0 claim to v1.0/1.1/1.2
  framing; added `npm run budget` and `npm run visualize` to CLI list
- AGENTS.md: added budget (init/update/check) and visualize command shims
- CHANGELOG.md: fixed broken cross-refs from `docs/releases/` (non-existent)
  to the real `docs/release-notes/` directory
- .codex/rules/compaction.md: corrected Stage 5→Stage 6 for review files
  (Stage 5 is pre-review; Stage 6 is peer review in codex numbering)
- .codex/skills/pipeline/SKILL.md: added budget check and visualize commands
  to the Finish section
- docs/parity/claude-dev-team-parity.md: updated date, added budget/visualize/
  checkpoint entries to "Codex Improvements Beyond Claude", updated stale
  v1.0 Blockers section to reflect current parity status
- docs/release-notes/v1.1.0.md: new file covering deepening commit
- docs/release-notes/v1.2.0.md: new file covering elevation work (unreleased)
- .gitignore: added pipeline/diagram.md (runtime visualize artifact)

VERSION kept at 1.0.0: v1.2.0 work is unreleased on this PR branch; VERSION
and framework.version should only be bumped in a dedicated release commit.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mumit mumit merged commit 843c607 into main May 2, 2026
4 checks passed
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