GITHUB-ISSUES — Session file rename + sc create folders — 2026-03-16

What this file is

Issue-only doc. NOT a TASKS.md file. Harley’s job: run the operations listed below in order and stop. These are a mix of code changes and issue closes. Create a single feature branch for all code changes. Commit as you go.

Rules for Harley

Run gh label list before creating any issues
Create feature branch before making any code changes
Run operations in order — confirm each before moving to next
One commit per logical change — do not batch unrelated changes
Report any failures immediately
Stop after all operations are complete — no other work

Setup

Create feature branch

git checkout dev && git pull origin dev && git checkout -b feature/session-file-rename

Operations

Operation 1 — rename sessions/CURRENT.md to sessions/CURRENT-CODE.md in the live project

mv /mnt/d/Claude/projects/scaffolder/sessions/CURRENT.md /mnt/d/Claude/projects/scaffolder/sessions/CURRENT-CODE.md
git add sessions/CURRENT-CODE.md sessions/CURRENT.md
git commit -m "refactor: rename sessions/CURRENT.md to CURRENT-CODE.md"

Operation 2 — update templates/CURRENT.md filename (rename the template file itself)

mv /mnt/d/Claude/projects/scaffolder/templates/CURRENT.md /mnt/d/Claude/projects/scaffolder/templates/CURRENT-CODE.md
git add templates/CURRENT-CODE.md templates/CURRENT.md
git commit -m "refactor: rename templates/CURRENT.md to CURRENT-CODE.md"

Operation 3 — update all CURRENT.md references in CLAUDE.md template

Find and replace all references to sessions/CURRENT.md with sessions/CURRENT-CODE.md in templates/CLAUDE.md. Also add sessions/CURRENT-CHAT.md to the file reading list in the project state section.

git add templates/CLAUDE.md
git commit -m "docs: update CLAUDE.md template for CURRENT-CODE.md rename"

Operation 4 — update sc-end command template

In templates/claude-commands/sc-end.md replace sessions/CURRENT.md with sessions/CURRENT-CODE.md.

git add templates/claude-commands/sc-end.md
git commit -m "docs: update sc-end command for CURRENT-CODE.md rename"

Operation 5 — update sc-done command template

In templates/claude-commands/sc-done.md replace sessions/CURRENT.md with sessions/CURRENT-CODE.md.

git add templates/claude-commands/sc-done.md
git commit -m "docs: update sc-done command for CURRENT-CODE.md rename"

Operation 6 — update sc-exit command template

In templates/claude-commands/sc-exit.md replace sessions/CURRENT.md with sessions/CURRENT-CODE.md.

git add templates/claude-commands/sc-exit.md
git commit -m "docs: update sc-exit command for CURRENT-CODE.md rename"

Operation 7 — update session-end skill template

In templates/claude-skills/session-end/SKILL.md replace any remaining references to sessions/CURRENT.md with sessions/CURRENT-CODE.md.

git add templates/claude-skills/session-end/SKILL.md
git commit -m "docs: update session-end skill for CURRENT-CODE.md rename"

Operation 8 — search for any remaining CURRENT.md references

Run a search to confirm no stale references remain:

grep -r "CURRENT\.md" /mnt/d/Claude/projects/scaffolder/templates/ --include="*.md" --include="*.json" --include="*.ts"
grep -r "CURRENT\.md" /mnt/d/Claude/projects/scaffolder/src/ --include="*.ts"

Report all findings. If any remain, fix them before continuing.

Operation 9 — add docs/tasks/ and docs/issues/ to sc create scaffold output

In the scaffolder source code, find where sc create generates the docs/ folder structure and add:

docs/tasks/ with a .gitkeep
docs/issues/ with a .gitkeep

Search for the folder creation logic:

grep -r "docs/" /mnt/d/Claude/projects/scaffolder/src/ --include="*.ts" -l

Report the files found before making any changes. Wait for operator confirmation on which file to edit.

Operation 10 — commit scaffold output changes

After operator confirms the correct file:

git add src/
git commit -m "feat: add docs/tasks/ and docs/issues/ to sc create scaffold output"

Operation 11 — update CLAUDE.md template folder structure section

Add docs/tasks/ and docs/issues/ to the folder structure tree in templates/CLAUDE.md. Also update sessions/CURRENT.md reference to sessions/CURRENT-CODE.md and add sessions/CURRENT-CHAT.md.

git add templates/CLAUDE.md
git commit -m "docs: update CLAUDE.md template folder structure for new dirs and renamed session files"

Operation 12 — push branch

git push origin feature/session-file-rename

Operation 13 — close issues

gh issue close 287 --comment "sessions/CURRENT.md renamed to CURRENT-CODE.md in live project and templates. All references updated. Closes #287."
gh issue close 290 --comment "session-start skill already reads CURRENT-CHAT.md and CURRENT-CODE.md — confirmed in templates/claude-skills/session-start/SKILL.md. Closes #290."
gh issue close 291 --comment "session-end skill updated to write CURRENT-CODE.md and drop upload reminder. Closes #291."
gh issue close 301 --comment "docs/tasks/ and docs/issues/ added to sc create scaffold output. Closes #301."
gh issue close 302 --comment "templates/CLAUDE.md updated with new folder structure and renamed session files. Closes #302."

Notes

#288 (CURRENT-CHAT.md template) — already done, template exists at templates/CURRENT-CHAT.md
#289 (chat session log format) — already done, format documented in sc-session-end skill
#303 (scaffolder CLAUDE.md folder structure) — update the live CLAUDE.md at project root in a separate commit after the template is done