Skip to content

Step 4 and CLAUDE.md still place the version comments at the top of the generated skill #173

Open

Description

@dmccoystephenson

Drift

The generated skill's template-version and generated-at comments are placed directly below the H1 heading (create-dev-loop.md:124-127), and that placement is stated as a convention in CLAUDE.md, as the fix for #36. "At the top" is still used in two places:

  • create-dev-loop.md:648, the TEMPLATE_VERSION row of the Step 4 table: "Becomes part of an HTML comment at the top of the generated skill".
  • CLAUDE.md:53, item 4 of the "Testing changes" checklist: "HTML comments appear at the top of the generated skill". The corrected wording, "directly below the H1 heading", is already used at CONTRIBUTING.md:74-76.

The Step 4 row is the more likely of the two to mislead, since it is read as an instruction during substitution.

Why this was not fixed in the sweep that found it

Both edits are one-phrase corrections, but neither fits an autonomous documentation PR. Changes to create-dev-loop.md are held for a behavioral validation run that cannot be performed in a headless dispatch (#109), and CLAUDE.md is agent-loaded config for which separate authorization is required. If they had been bundled, the RESEARCH.md corrections found alongside them would have been held back too.

Suggested action

"At the top of" should be replaced with "directly below the H1 heading of" in both places. The CLAUDE.md half can be combined with #106.

This issue was drafted during a Gardener session (https://github.com/Stephenson-Software/gardener).


drafted by Claude on behalf of Daniel Stephenson

Activity

  1. dmccoystephenson commented on Nov 5, 2026

    @dmccoystephenson
    MemberAuthor

    The create-dev-loop.md half of this issue is included in PR #175. The CLAUDE.md:53 half remains open, because editing CLAUDE.md requires separate authorization, and it can still be combined with #106 as suggested above.

    This comment was drafted during a Gardener session (https://github.com/Stephenson-Software/gardener).


    drafted by Claude on behalf of Daniel Stephenson

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions