Skip to content

docs(claude): tighten CLAUDE.md; add Autonomy, Finish line, Report - #60

Merged
helebest merged 2 commits into
mainfrom
docs/claude-md-opus-5-5
Oct 6, 2026
Merged

helebest merged 2 commits into
mainfrom
docs/claude-md-opus-5-5

Conversation

@helebest

@helebest helebest commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Tightens CLAUDE.md using the Claude Opus 5.5 prompting guide and a roughly 80% ASD-STE100 writing style (short sentences, one instruction each, vertical lists).

  • "Read these four docs before doing anything" becomes a table: which doc to read for which kind of change.
  • New Autonomy (stop/go rules; stop before a release tag or force-push), Finish line (for changes and for releases), and Report (three fixed headings) sections.
  • Fix the dev-workflow example: packages/dikw-converter-pdf does not exist; it now uses dikw-converter-mineru.
  • Layering invariants, conventions, and "Things not to do" keep their rules; no rule changed.

Delivery receipt

Tier: S (CLAUDE.md only). Checks: every path cited in the new text exists (docs/*.md, scripts/check-package.py, packages/dikw-converter-mineru/tests).

🤖 Generated with Claude Code

- Rewrite the guidance in short controlled English (roughly 80% of
  ASD-STE100): one instruction per sentence, vertical lists.
- Replace "read these four docs before doing anything" with a table that
  says which doc to read for which kind of change.
- Add the Claude Opus 5.5 stop/go rules (Autonomy), a Finish line for
  changes and releases, and a fixed three-heading Report.
- Fix the dev-workflow example: dikw-converter-pdf does not exist in
  packages/; use dikw-converter-mineru.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-06T15:26:43.449324Z e35d1e7 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

- Cite docs/architecture.md § 5 "Output layout convention"; the
  "Asset reference rule" heading does not exist.
- Dev workflow uses `uv sync --all-packages --all-extras`, as CI does;
  bare `uv sync` skips the members' own dependencies.
- The finish line requires every PR check to be green.
- README describes the new CLAUDE.md layout.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@helebest

helebest commented Oct 6, 2026

Copy link
Copy Markdown
Contributor Author

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

🤖 Generated with Claude Code

@helebest
helebest merged commit df7f2e2 into main Oct 6, 2026
4 checks passed
@helebest
helebest deleted the docs/claude-md-opus-5-5 branch October 6, 2026 19:30
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