Skip to content

Scaffolder Project as Git Repo

Date: 2026-03-21 Status: confirmed, not yet applied

The git repo root is at the engine root. But the engine root is supposed to be the installed copy — never edited locally. Development happens in projects/scaffolder/ but that folder isn’t the repo.

projects/scaffolder/ becomes the git repo. All repo files get copied there. .git/ moves there. Engine root is the installed copy — updated from git only.

  1. Copy engine files into projects/scaffolder/ (src/, templates/, .github/, package.json, tsconfig.json, .gitignore, CHANGELOG.md, README.md, LICENSE, CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md, .env.example, versions.json)
  2. Do NOT overwrite: CLAUDE.md, STANDARDS.md, PROJECT-INSTRUCTIONS.md, RELEASE-CHECKLIST.md, ai-sessions/, docs/ — project versions are correct
  3. Move .git/ into projects/scaffolder/
  4. Update .gitignore for the new repo root
  5. Verify git status, remote, and push work from projects/scaffolder/
  • Development: edit in projects/scaffolder/, commit, push
  • Engine update: pull from git into scaffolder-engine/ (like installing an update)
  • projects/scaffolder/ IS the repo
  • scaffolder-engine/ is the installed runtime, never edited locally