Repository navigation
Document Steps 1 and 4 in README, update CLAUDE.md conventions - #38
Merged
Merged
Conversation
README "What it does" listed 6 bullets but the template has 7 Steps — violating the README-enumerate-every-Step convention tracked by cdl-dev-loop. Steps 1 (Identify) and 4 (Fill in placeholders) are now explicit bullets. Each bullet now states its 1:1 mapping to the corresponding template Step. CLAUDE.md additions: - Skill file conventions: added the README-enumerate rule (third structural rule from cdl-dev-loop's identity) and the template-version HTML header convention (#22). - Testing changes: added items 4 and 5 for template-version header verification and end-to-end MODE=update exercise. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
dmccoystephenson
added a commit
that referenced
this pull request
Aug 3, 2026
README "What it does" listed 6 bullets but the template has 7 Steps — violating the README-enumerate-every-Step convention tracked by cdl-dev-loop. Steps 1 (Identify) and 4 (Fill in placeholders) are now explicit bullets. Each bullet now states its 1:1 mapping to the corresponding template Step. CLAUDE.md additions: - Skill file conventions: added the README-enumerate rule (third structural rule from cdl-dev-loop's identity) and the template-version HTML header convention (#22). - Testing changes: added items 4 and 5 for template-version header verification and end-to-end MODE=update exercise. Co-authored-by: BuildTools <unconfigured@null.spigotmc.org> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Doc-accuracy follow-up from today's audit. Two findings closed:
README.md — "What it does" lists 6 bullets but the template has 7 Steps
Violated the README-enumerate-every-Step convention that example-h-dev-loop exists to enforce. Step 1 (Identify) was folded into the separate Usage section; Step 4 (Fill in placeholders) was implicit inside the "Generate" bullet. Now both are explicit, and each bullet states its 1:1 mapping to the template Step.
CLAUDE.md — two missing conventions
<!-- template-version: <sha> -->HTML header convention (Add template-version header to generated skills for drift detection #22).What didn't change (and why)
Test plan
Related: example-skills-catalog#6 (CONVENTIONS.md post-retrofit update — picks up the template-version convention there too).
🤖 Generated with Claude Code
drafted by Claude on behalf of Daniel Stephenson