Skip to content

docs: rename to Harmon DevKit, fix doc inconsistencies, add template docs#2

Merged
evanharmon1 merged 3 commits into
mainfrom
docs/devkit-rename-and-template-docs
Jun 12, 2026
Merged

docs: rename to Harmon DevKit, fix doc inconsistencies, add template docs#2
evanharmon1 merged 3 commits into
mainfrom
docs/devkit-rename-and-template-docs

Conversation

@evanharmon1

@evanharmon1 evanharmon1 commented Jun 12, 2026

Copy link
Copy Markdown
Owner

Summary

Documentation/consistency pass following the repo rename and folder reorg:

  • Rename: all remaining harmon-boilerplates / "Harmon Boilerplates" references updated to harmon-devkit / "Harmon DevKit" (README, package.json, Taskfile/Brewfile/requirements headers, CONTRIBUTING, CHECKLIST). .copier-answers.yml is intentionally left untouched (it records the original copier answers).
  • README: badges now point at harmon-devkit (and build.ymlbuild.yaml so the Build badge resolves); removed the retired Snyk badge; removed the broken link to gitignored todo.md; fixed .ansible-lint-ignore.ansible-lint; added a Repository Structure table and a Template Index table; replaced the TODO usage section with actual copy-and-adapt guidance; stripped utm tracking params from links
  • CLAUDE.md: updated to the post-reorg layout (templates/, scripts/, ai/ — the old text described a nonexistent boilerplates/ tree with categories that don't exist)
  • Per-directory template READMEs: templates/, templates/docker/ (+ genericStack/, n8n-compose/), scriptTemplates/, serverlessFunctionTemplates/, webTemplates/. The n8n README documents the required-but-gitignored .env (a fresh clone can't start the stack without it)
  • Small consistency fixes: docs/CHECKLIST.md pointed at a nonexistent dev/templates/... path; package.json license now SPDX "MIT" (matches LICENSE); markdownlint MD013 (80-char lines) disabled since every doc in the repo exceeds it
  • One behavioral one-liner: Taskfile task boostrapbootstrap, so the command documented in README/CLAUDE.md actually exists (separate commit — easy to drop if you'd rather hold it)

Notes

  • detect-private-key was discussed but is already enabled in .pre-commit-config.yaml, so no change was needed for it.
  • Local commits were made with SKIP=ansible-lint: the pinned ansible-lint v6.22.2 hook crashes on Python 3.14 (ModuleNotFoundError: ansible.parsing.yaml.constructor) — pre-existing breakage, parked with the rest of the tooling fixes.
  • Known CI failures (missing package-lock.json, TODO npm scripts) are intentionally not addressed here per scope; expect the existing red checks to stay red.

🤖 Generated with Claude Code

evanharmon1 and others added 3 commits June 12, 2026 07:51
…READMEs

- Rename all harmon-boilerplates references to harmon-devkit (README,
  package.json, Taskfile/Brewfile/requirements headers, CONTRIBUTING,
  CHECKLIST, copier answers)
- Fix README badges: point at harmon-devkit, correct build.yml -> build.yaml,
  drop the retired Snyk badge service badge
- Remove broken README link to gitignored todo.md and the stale
  .ansible-lint-ignore reference; strip utm tracking params
- Add a template index and repository structure tables to the README
- Add per-directory READMEs for templates/ and each category, including
  required .env setup for the n8n stack
- Update CLAUDE.md to match the post-reorg layout (templates/, scripts/,
  ai/ instead of boilerplates/)
- Fix CHECKLIST path to the shell script template
- package.json license field: use SPDX "MIT" (matches LICENSE)
- markdownlint: disable MD013 line-length (prose/table-heavy docs)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
README and CLAUDE.md document 'task bootstrap'; the task was named
'boostrap' so the documented command errored.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@evanharmon1 evanharmon1 merged commit e919e0e into main Jun 12, 2026
3 of 8 checks passed
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