Skip to content

Add README and CLAUDE.md documentation - #2

Merged
dmccoystephenson merged 1 commit into
mainfrom
feature/add-readme-and-claude-md
May 17, 2026
Merged

dmccoystephenson merged 1 commit into
mainfrom
feature/add-readme-and-claude-md

Conversation

@dmccoystephenson

@dmccoystephenson dmccoystephenson commented May 17, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Adds README.md with a value-proposition table contrasting generic assistants vs. tailored dev loops, usage instructions, requirements, and a breakdown of what each generated skill encodes
  • Adds CLAUDE.md documenting template placeholder conventions, what belongs here vs. in generated skills, how to manually test changes, commit/PR conventions, and doc sources of truth

Test plan

  • README accurately describes what /create-dev-loop does
  • CLAUDE.md placeholder conventions match the template in create-dev-loop.md
  • No broken links or unresolved placeholders in either file

drafted by Claude on behalf of Daniel Stephenson

README highlights the value of tailored dev loops and explains what
the skill generates. CLAUDE.md captures template conventions, what
belongs here vs. generated skills, and the doc sources of truth.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@dmccoystephenson
dmccoystephenson merged commit 0aa40af into main May 17, 2026
@dmccoystephenson
dmccoystephenson deleted the feature/add-readme-and-claude-md branch May 17, 2026 19:15
dmccoystephenson added a commit that referenced this pull request May 23, 2026
…ers (#11)

* Align generated template with conventions; promote universal carry-overs

- Phase 9 generates a numbered structure with duplicate-check on step 1 (#9)
- Step 4 substitution-table preamble notes it covers {{#if FLAG}} conditionals too (#10)
- Phase 3 gains universal "match sibling structure" + "rename siblings together" rules
  (promoted from kingdom-first-era-dev-loop#1 and #2 — they're not KFE-specific)
- Edge cases gain a flaky-test entry (promoted from dpm-dev-loop#12 — every tests-running
  loop will hit this eventually)

Closes #9
Closes #10

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Self-review fix: use single \ for line continuations in Phase 9 template

The new gh issue create block in the generated Phase 9 used \\ (double
backslash) for line continuations, which would render as literal \\ in
the generated skill and break the command in shell. Match the convention
used by every other line continuation in this file (single \).

---------

Co-authored-by: BuildTools <unconfigured@null.spigotmc.org>
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 highlights the value of tailored dev loops and explains what
the skill generates. CLAUDE.md captures template conventions, what
belongs here vs. generated skills, and the doc sources of truth.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
dmccoystephenson added a commit that referenced this pull request Aug 3, 2026
…ers (#11)

* Align generated template with conventions; promote universal carry-overs

- Phase 9 generates a numbered structure with duplicate-check on step 1 (#9)
- Step 4 substitution-table preamble notes it covers {{#if FLAG}} conditionals too (#10)
- Phase 3 gains universal "match sibling structure" + "rename siblings together" rules
  (promoted from kingdom-first-era-dev-loop#1 and #2 — they're not KFE-specific)
- Edge cases gain a flaky-test entry (promoted from a-private-repo-1#12 — every tests-running
  loop will hit this eventually)

Closes #9
Closes #10

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Self-review fix: use single \ for line continuations in Phase 9 template

The new gh issue create block in the generated Phase 9 used \\ (double
backslash) for line continuations, which would render as literal \\ in
the generated skill and break the command in shell. Match the convention
used by every other line continuation in this file (single \).

---------

Co-authored-by: BuildTools <unconfigured@null.spigotmc.org>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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