GITHUB-ISSUES-2026-03-21-v0100-sweep.md — Issue operations for Harley

Context

Joker session: planning — v0.10.0 issue sweep — 2026-03-21 Updated: 2026-03-21 (audit pass — fixed templates note, added #244/#245, added stale decision cleanup) This file covers: issue closures, template changes, skills/commands cleanup (decision-0002), project as git repo (decision-0003), and stale file cleanup.

Rules for Harley

Run operations one at a time in the order listed
Confirm each result before moving to the next
Report any failures to operator immediately
Stop after all operations are complete — no other work

Phase 0 — Close superseded issues

Operation 1 — Close #244

gh issue close 244 --comment "Resolved. Combined scaffolder skill uploaded to Claude.ai Settings > Skills. Old sc-discovery and sc-doc-production skills deleted."

Operation 2 — Close #245

gh issue close 245 --comment "Resolved. Combined scaffolder skill uploaded to Claude.ai Settings > Skills. Old sc-discovery and sc-doc-production skills deleted."

Operation 3 — Close #246

gh issue close 246 --comment "Superseded by decision-0002 (CLI and skills consolidation)."

Operation 4 — Close #259

gh issue close 259 --comment "Superseded by decision-0002 (CLI and skills consolidation)."

Operation 5 — Close #304

gh issue close 304 --comment "Superseded by decision-0002 (CLI and skills consolidation)."

Operation 6 — Close #305

gh issue close 305 --comment "Superseded by decision-0002 (CLI and skills consolidation)."

Phase 1 — Move git repo to projects/scaffolder/ (decision-0003)

projects/scaffolder/ is the git repo. Engine root is the installed copy. Do this FIRST because everything after assumes the repo root is projects/scaffolder/.

Operation 7 — Copy engine files into projects/scaffolder/

Copy these from engine root into projects/scaffolder/. Do NOT overwrite files that already exist in the project.

cp -rn src/ projects/scaffolder/src/
cp -rn .github/ projects/scaffolder/.github/
cp -rn .claude/ projects/scaffolder/.claude/
cp -n package.json projects/scaffolder/
cp -n package-lock.json projects/scaffolder/
cp -n tsconfig.json projects/scaffolder/
cp -n .env.example projects/scaffolder/
cp -n versions.json projects/scaffolder/
cp -n CHANGELOG.md projects/scaffolder/
cp -n README.md projects/scaffolder/
cp -n LICENSE projects/scaffolder/
cp -n CODE_OF_CONDUCT.md projects/scaffolder/
cp -n CONTRIBUTING.md projects/scaffolder/
cp -n SECURITY.md projects/scaffolder/

Note: templates/ was already copied by operator. Verify it exists before continuing. Note: CLAUDE.md, STANDARDS.md, PROJECT-INSTRUCTIONS.md, RELEASE-CHECKLIST.md already exist in the project — do NOT overwrite.

Operation 8 — Move .git/ into projects/scaffolder/

mv .git/ projects/scaffolder/.git/

Operation 9 — Write new .gitignore for projects/scaffolder/

Write this to projects/scaffolder/.gitignore:

# Dependencies
node_modules/
dist/

# Environment
.env
.env.local

# OS
.DS_Store
Thumbs.db

# Session logs — noise, not tracked
ai-sessions/logs/

# Operator files — local only, not part of the product
_system/
_ideas/
INSTALLED-MCP.md
TECH-STACK.md

# IDE
.vscode/
.idea/

Operation 10 — cd into projects/scaffolder/ and verify

cd projects/scaffolder/
git status
git remote -v

Confirm: remote points to purlshq/scaffolder, git sees all the files. This is now the repo root. All remaining operations run from here.

Operation 11 — Commit repo move

git add -A
git commit -m "feat: move repo root to projects/scaffolder as dev environment

- projects/scaffolder/ is now the git repo for development
- Engine root (scaffolder-engine/) is the installed copy, updated from git
- Copied src/, templates/, .github/, .claude/, package.json, etc. into project
- Project-specific files preserved (CLAUDE.md, STANDARDS.md, docs/, ai-sessions/)
- Per decision-0003"

Phase 2 — Commit template updates

All template files were updated by Joker via MCP during the planning session.

Operation 12 — Verify template changes show in git status

git status

Should show changes in:

templates/project-root/CLAUDE.md
templates/project-root/STANDARDS.md
templates/project-root/PROJECT-INSTRUCTIONS.md
templates/project-root/RELEASE-CHECKLIST.md
templates/project-root/API.md
templates/docs/plans/plan-template.md
templates/docs/decisions/decision-template.md
templates/code-skills/ (new)
templates/chat-skills/ (new)

Operation 13 — Commit template updates

git add -A
git commit -m "docs: update all templates — terminology, tiers, PR rules, session architecture

- RFC → plan, ADR → decision throughout
- Hobby/Professional/Enterprise → Basic/Project Management/Plane Integrated
- sessions/ → ai-sessions/ in all paths
- Fixed PR language: Harley creates all PRs, operator merges
- Added RELEASE-CHECKLIST.md, canonical labels, document type distinction
- New skill folders: code-skills/, chat-skills/ replace claude-skills/
- Combined scaffolder chat skill (discovery + doc production)

Closes #239, closes #255, closes #283"

Phase 3 — Delete stale files

Operation 14 — Delete stale plan duplicates

rm docs/plans/plan-0003-tier-rename.md
rm docs/plans/plan-0004-cli-skills-consolidation.md
rm docs/plans/RELEASE-CHECKLIST.md 2>/dev/null || true

Operation 15 — Delete duplicate decision file

rm docs/decisions/_deleted-0003-project-as-dev-env.md 2>/dev/null || true
rm docs/decisions/0003-project-as-dev-env.md 2>/dev/null || true

Operation 16 — Delete old template skill and command directories

rm -rf templates/claude-skills/
rm -rf templates/claude-commands/

Operation 17 — Delete Joker skills from .claude/ (wrong location)

rm -rf .claude/skills/sc-session-start/
rm -rf .claude/skills/sc-session-end/

Operation 18 — Delete all slash commands

rm -rf .claude/commands/

Operation 19 — Delete empty .claude/rules/

rm -rf .claude/rules/

Operation 20 — Update live code-skills from new templates

rm -rf .claude/skills/session-start/
rm -rf .claude/skills/plan-mode-reminder/
cp -r templates/code-skills/session-start/ .claude/skills/session-start/
cp -r templates/code-skills/plan-mode-reminder/ .claude/skills/plan-mode-reminder/

Operation 21 — Delete skill update staging files

rm -rf docs/issues/skill-updates/

Operation 22 — Delete patch file (if exists)

rm STANDARDS-issues-workflow-patch.md 2>/dev/null || true

Operation 23 — Commit deletions

git add -A
git commit -m "chore: delete stale skills, commands, and migration leftovers

- Removed templates/claude-skills/ and templates/claude-commands/
- Removed slash command wrappers from .claude/commands/
- Removed misplaced Joker skills from .claude/skills/
- Removed duplicate decision-0003 draft
- Updated code-skills from new templates
- Per decision-0002

Closes #298"

Phase 4 — Open PR

Operation 24 — Push and open PR

git push origin feature/v0100-issue-sweep
gh pr create --base dev --title "feat: v0.10.0 issue sweep — repo restructure, templates, skills cleanup" --body "## What this does

Moves repo root to projects/scaffolder/ as dev environment (decision-0003)
Updates all templates: terminology, tiers, PR rules, session architecture
Restructures skills: code-skills/ + chat-skills/ replace claude-skills/
Deletes all slash command wrappers (decision-0002)
Cleans up migration leftovers

Closes #239 #244 #245 #246 #255 #259 #283 #298 #304 #305"

NOT in this file — needs separate sessions

Code changes:

#251 — Replace hardcoded D: drive with dynamic path discovery
Decision-0002 CLI rewrite: remove 11 commands, rewrite sc start, add session-end hook
#269 — sc update full test pass
#273 — sc config full test pass

Joker produces last:

#257 — README rewrite
#300 — End-of-milestone docs audit

Operator manual actions:

Clean up engine root after repo move (remove leftover src/, templates/, etc. — these are now just installed copies)