Notes & Quick Ideas

[djdarcy]

Notes & Quick Ideas

Quick notes, small bugs, and ideas that don't warrant their own issue yet.

Ideas

• Archetype selection via repo topics or .repokit.json config
• Post-setup checklist issue auto-created in new repos (reminds user to update README, add secrets, etc.)
• Template health check: verify all $PLACEHOLDER variables are substituted after setup
• Optional scripts/repokit-common subtree auto-add during setup workflow

Quick bugs / observations

• Template leftovers: .github/, .repokit.json, CONTRIBUTING.md, LICENSE, .gitignore in scripts/ are noise when consumed as subtree by downstream projects (fixed in git-repokit-common, but template still generates them)
• README.md still has $PROJECT_NAME placeholders -- setup workflow handles substitution, but manual "Use this template" doesn't
• pyproject.toml.pypi and pyproject.toml.comfyui are archetype-specific -- only one should remain after setup

Notes from recent work

• v0.1.6 fixed missing _version.py generation -- tests in new projects were failing because the setup workflow didn't create the full version module with helper functions
• Single-quoted heredoc ('PYEOF') + sed substitution pattern needed to avoid shell expansion of Python f-strings in GHA workflow
• Private directory was being included in template output until v0.1.5 removed it