You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.j2 has no validate-counts job. 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 emit drift-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.j2 does not consume release-doc-sync@v1.
The current template ends at gh 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 emit label-sync.yml. No self-healing gh label create --force per-label loop pattern (the DTD#4 fix). New
repos have no auto-labeling at all.
templates/ does not emit dependabot.yml. The expected github-actions ecosystem entry (now standard across tool repos) is
missing, so newly scaffolded repos will silently lag on action security
updates.
templates/CLAUDE.md.j2 does not carry a **Version:** line. release-doc-sync rewrites this line on every release. Without it
in the template, freshly scaffolded repos start with a CLAUDE.md that release-doc-sync cannot align until somebody hand-adds the line.
templates/ROADMAP.md.j2 is 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 for drift-check@v1.9 to recognize the file. Today
newly scaffolded ROADMAP.md fails drift-check on day one.
templates/AGENTS.md.j2 does 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-counts to validate.yml.j2.
Add a drift-check.yml.j2 template and emit it from create-tool.py.
Add the release-doc-sync@v1 step to release.yml.j2 between the version
bump and the commit/tag step. Wire plugin-version and previous-version.
Add a label-sync.yml.j2 template using the per-label gh label create --force pattern.
Add a dependabot.yml.j2 template at .github/dependabot.yml with a github-actions ecosystem entry (weekly schedule, target main).
Add **Version:** {{ version }} to CLAUDE.md.j2.
Add <!-- standards-version: {{ standards_version }} --> and **Current:** {{ version }} to ROADMAP.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.
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 nowmaterially 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.9oralign 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-Toolsas theworking 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-ToolsandHome-Lab-Developer-Toolsas reference points, with VERSION at1.9.1)templates/validate.yml.j2has novalidate-countsjob. Plaid grewone (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 atTMHSDigital/Developer-Tools-Directory/.github/actions/drift-check@v1.9is missing entirely. New repos start with zero drift coverage.
templates/release.yml.j2does not consumerelease-doc-sync@v1.The current template ends at
gh release create ... --generate-noteswithout ever invoking the doc-sync action, so CHANGELOG.md, CLAUDE.md
**Version:**, and ROADMAP.md**Current:**will not auto-update onrelease in newly scaffolded repos.
templates/does not emitlabel-sync.yml. No self-healinggh label create --forceper-label loop pattern (the DTD#4 fix). Newrepos have no auto-labeling at all.
templates/does not emitdependabot.yml. The expectedgithub-actionsecosystem entry (now standard across tool repos) ismissing, 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 itin 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 themarker is required for
drift-check@v1.9to recognize the file. Todaynewly 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)
validate-countstovalidate.yml.j2.drift-check.yml.j2template and emit it fromcreate-tool.py.release-doc-sync@v1step torelease.yml.j2between the versionbump and the commit/tag step. Wire
plugin-versionandprevious-version.label-sync.yml.j2template using the per-labelgh label create --forcepattern.dependabot.yml.j2template at.github/dependabot.ymlwith agithub-actionsecosystem entry (weekly schedule, targetmain).**Version:** {{ version }}toCLAUDE.md.j2.<!-- 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. MetaVERSION at the time of audit:
1.9.1.