Repository navigation
scaffold drift: emitted output not aligned with current ecosystem patterns #41
Description
Summary
While populating Blender-Developer-Tools to v0.1.0 against current ecosystem
patterns, I found that scaffold/ in this repo emits an output that is now
materially behind several conventions established after the scaffold was last
touched. New tool repos generated today will land already-drifted from the
ecosystem and require manual rework before they pass drift-check@v1.9 or
align with release-doc-sync@v1.
This issue tracks the audit; no fix is requested in the issue itself.
Blender-Developer-Tools was populated using Plaid-Developer-Tools as the
working pattern reference, not the scaffold output, so the new repo lands at
current ecosystem patterns regardless of scaffold staleness.
Concrete gaps observed (against Plaid-Developer-Tools and
Home-Lab-Developer-Tools as reference points, with VERSION at 1.9.1)
-
templates/validate.yml.j2has novalidate-countsjob. Plaid grew
one (DTD#39 era). The scaffold still only does JSON/manifest/frontmatter
validation. New repos cannot enforce README aggregate count truthfulness
out of the box. -
templates/does not emitdrift-check.yml. Consumer wiring at
TMHSDigital/Developer-Tools-Directory/.github/actions/drift-check@v1.9
is missing entirely. New repos start with zero drift coverage. -
templates/release.yml.j2does not consumerelease-doc-sync@v1.
The current template ends atgh release create ... --generate-notes
without ever invoking the doc-sync action, so CHANGELOG.md, CLAUDE.md
**Version:**, and ROADMAP.md**Current:**will not auto-update on
release in newly scaffolded repos. -
templates/does not emitlabel-sync.yml. No self-healing
gh label create --forceper-label loop pattern (the DTD#4 fix). New
repos have no auto-labeling at all. -
templates/does not emitdependabot.yml. The expected
github-actionsecosystem entry (now standard across tool repos) is
missing, so newly scaffolded repos will silently lag on action security
updates. -
templates/CLAUDE.md.j2does not carry a**Version:**line.
release-doc-syncrewrites this line on every release. Without it
in the template, freshly scaffolded repos start with a CLAUDE.md that
release-doc-synccannot align until somebody hand-adds the line. -
templates/ROADMAP.md.j2is missing both the<!-- standards-version: -->
marker and the**Current:**convention. Same problem as chore: finish Phase 1 with standards template and scaffold updates #6 plus the
marker is required fordrift-check@v1.9to recognize the file. Today
newly scaffolded ROADMAP.md fails drift-check on day one. -
templates/AGENTS.md.j2does carry the standards-version marker.
This one is correct. Listing it for completeness so the audit is
exhaustive.
Suggested fix scope (not done in this issue)
- Add
validate-countstovalidate.yml.j2. - Add a
drift-check.yml.j2template and emit it fromcreate-tool.py. - Add the
release-doc-sync@v1step torelease.yml.j2between the version
bump and the commit/tag step. Wireplugin-versionandprevious-version. - Add a
label-sync.yml.j2template using the per-labelgh label create --forcepattern. - Add a
dependabot.yml.j2template at.github/dependabot.ymlwith a
github-actionsecosystem entry (weekly schedule, targetmain). - Add
**Version:** {{ version }}toCLAUDE.md.j2. - Add
<!-- standards-version: {{ standards_version }} -->and**Current:** {{ version }}toROADMAP.md.j2.
Reference
Pattern source for all of the above: TMHSDigital/Plaid-Developer-Tools
(skills/rules/release flow) plus TMHSDigital/Home-Lab-Developer-Tools
(label-sync layout). Both currently mark standards-version: 1.9.0. Meta
VERSION at the time of audit: 1.9.1.
Activity
fix: align scaffold output with current ecosystem patterns