Skip to content

docs: correct MANIFEST and README.md conventions in CLAUDE.md#29

Merged
toddr merged 1 commit intomainfrom
koan.toddr.bot/claudemd-manifest-readme-conventions
Apr 5, 2026
Merged

docs: correct MANIFEST and README.md conventions in CLAUDE.md#29
toddr merged 1 commit intomainfrom
koan.toddr.bot/claudemd-manifest-readme-conventions

Conversation

@toddr-bot
Copy link
Copy Markdown
Contributor

@toddr-bot toddr-bot commented Apr 5, 2026

What

Updates CLAUDE.md to accurately describe how MANIFEST and README.md are maintained.

Why

The previous instructions told Claude to hand-edit MANIFEST and treat README.md as
static. In reality, MANIFEST is generated by make manifest and README.md is
generated from POD via pod2markdown. Wrong instructions led to unnecessary manual
edits and re-sorting.

How

  • MANIFEST: "manually maintained" → "generated via make manifest"
  • README.md: "not auto-generated" → generated from lib/Net/ACME2.pm POD
  • Both entries now say "don't hand-edit"

Testing

Documentation-only change — verified markdown renders correctly.

🤖 Generated with Claude Code


Quality Report

Changes: 1 file changed, 4 insertions(+), 3 deletions(-)

Code scan: clean

Tests: failed (FAILED)

Branch hygiene: clean

Generated by Kōan post-mission quality pipeline

- MANIFEST: generated via `make manifest`, not manually maintained
- README.md: auto-generated from POD in lib/Net/ACME2.pm
- Clarify that neither should be hand-edited or re-sorted

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@toddr toddr marked this pull request as ready for review April 5, 2026 18:13
@toddr toddr merged commit 21296f5 into main Apr 5, 2026
4 of 5 checks passed
@toddr toddr deleted the koan.toddr.bot/claudemd-manifest-readme-conventions branch April 5, 2026 18:13
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