TASKS.md — scaffolder v0.7.1 sc updates + doc cleanup + workflow automation

Rules for Code

Always work on a feature branch, never directly on dev or main
Read CLAUDE.md and STANDARDS.md before starting any work
Read sessions/CURRENT.md for project state
Complete each task fully before moving to the next
Do not add features not listed here
Follow Conventional Commits format on every commit
Update sessions/CURRENT.md at the end of every session
All merges require PRs — no direct merges to dev or main

Branch

Create one branch for all tasks: feature/v0.7.1-sc-updates All tasks committed to that branch. Final PR: feature/v0.7.1-sc-updates → dev (PR required) → main (PR required)

Version target

v0.7.1

Context

This release fixes remaining hardcoded values, updates all stale docs and templates for v0.7.0 structure, adds /sc create and /sc exit commands, introduces personal vs. team mode with operator alias, adds staging branch to standards, requires PRs for all merges, and cleans up the scaffolder’s own project docs.

Reference: MASTER-PLAN-v0.7.0-2026-03-15.md in docs/ for full architectural context.

Definition of done

A task is only complete when:

File edited or created correctly
No hardcoded personal values in templates
All references use v0.7.0 file structure (sessions/CURRENT.md, CLAUDE.md, etc.)
All AI name references use [CHAT_AI_NAME]/[CODE_AI_NAME] in templates
npm run build passes
Committed with correct message format
No unintended changes to other files

Release checklist (before dev → main PR)

All tasks below complete and committed
CHANGELOG.md updated for v0.7.1
Version bumped in package.json
versions.json updated (latest: “0.7.1”, new version entry)
README.md badge updated to v0.7.1
STATUS.md updated to v0.7.1
npm run build passes clean
sc create --dry-run "test" works correctly

Build order

SECTION A — Source code fixes (missed hardcodes + new commands)

Task 1 — Fix hardcoded BASE_DIR in updateProject.ts

Branch: feature/v0.7.1-sc-updates Commit: fix: replace hardcoded BASE_DIR with config-derived path in updateProject

File: src/updateProject.ts

Line 7:

const BASE_DIR = "/mnt/d/Claude/projects";

Add import:

import { getConfig } from "./config";

In updateProject() and rollbackProject(), derive the path:

const config = getConfig();
const baseDir = config.defaultDrive ? `${config.defaultDrive}/projects` : "/mnt/d/Claude/projects";

Replace all BASE_DIR references with baseDir.

Also update createBackup() managed files list to include v0.7.0 files:

Add: "CLAUDE.md", "sessions/CURRENT.md"

Definition of done: Zero hardcoded paths in updateProject.ts. Build passes.

Task 2 — Fix hardcoded purlshq in sc.ts handleStatus

Branch: feature/v0.7.1-sc-updates Commit: fix: replace hardcoded purlshq with config-derived username in handleStatus

File: src/sc.ts

In handleStatus, find:

`gh issue list --repo purlshq/${targetProject}`

Replace with:

const githubUser = config.githubUsername || config.defaultGitHub || "purlshq";
`gh issue list --repo ${githubUser}/${targetProject}`

Definition of done: No hardcoded username. Build passes.

Task 3 — Route /sc create through sc.ts

Branch: feature/v0.7.1-sc-updates Commit: feat: add sc create command routing through sc.ts

File: src/index.ts — export handleCreate function.

File: src/sc.ts — add case for “create” in switch.

File: src/scHelp.ts — add create to COMMANDS. Update “new” topic to reference sc create.

Definition of done: sc create "test" works. create "test" still works. Build passes.

Task 4 — Add /sc exit command

Branch: feature/v0.7.1-sc-updates Commit: feat: add sc exit command for clean session close

File: src/sc.ts — add case for “exit” and handleExit function.

File: src/scHelp.ts — add exit to COMMANDS.

Also add create and exit to the main —help output in sc.ts.

Definition of done: /sc exit ends session and exits. Build passes.

Task 5 — Add operatorAlias, mode, operatorDescription to config and /sc init

Branch: feature/v0.7.1-sc-updates Commit: feat: add operatorAlias, mode, operatorDescription to config and sc init

File: src/config.ts — add three new fields to interface and defaults.

File: src/sc.ts — update handleInit():

Add mode prompt (personal/team) before AI names
Add operatorAlias prompt (max 5 chars)
Add operatorDescription prompt (“Describe yourself and your role”)
Team mode: skip AI name prompts, lock to Chat/Code
Personal mode: AI name prompts with defaults changed to Chat/Code
End of init: print template location and credentials folder reminder
Update handleDone() to use operatorAlias from config

Definition of done: /sc init has new fields. Team mode locks names. Build passes.

SECTION B — Template and doc updates

Task 6 — Update templates/TASKS.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update TASKS.md template for v0.7.0 references

File: templates/TASKS.md

“Rules for Claude Code” → “Rules for [CODE_AI_NAME]”
“BUILDER-INSTRUCTIONS.md” → “CLAUDE.md”
“SESSION-NOTES.md” → “sessions/CURRENT.md”

Definition of done: Template uses v0.7.0 names and placeholders.

Task 7 — Update templates/STANDARDS.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update STANDARDS.md for v0.7.0 structure and PR-everywhere rule

File: templates/STANDARDS.md

Session handoff section: replace SESSION-NOTES.md/CONTEXT.md with sessions/CURRENT.md
PR workflow: require PRs for ALL merges (feature→dev, dev→staging, staging→main, dev→main)
Branch strategy: add staging branch (optional for solo, recommended for team/professional+)
Replace all remaining old file name references

Definition of done: Standards reflect v0.7.0 structure. PRs everywhere. Staging documented.

Task 8 — Update templates/ARCHITECT-REFERENCE.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update ARCHITECT-REFERENCE.md template for v0.7.0

File: templates/ARCHITECT-REFERENCE.md

“Solo developer” → “[OPERATOR_DESCRIPTION]”
Project structure diagram → v0.7.0 layout
Workflow → remove boot sequence, add sc build reference
Session start → one-file upload (sessions/CURRENT.md)
Add /sc create and /sc exit to commands
Docs table → CLAUDE.md replaces BUILDER-INSTRUCTIONS.md

Note: add [OPERATOR_DESCRIPTION] as a new placeholder. Update replaceAiNames in createDocs.ts to also replace [OPERATOR_DESCRIPTION] from config.operatorDescription with fallback “Solo developer, projects built to scale”.

Definition of done: Template v0.7.0 current. New placeholder works.

Task 9 — Update templates/PROJECT-INSTRUCTIONS.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update PROJECT-INSTRUCTIONS.md template for v0.7.0 structure

File: templates/PROJECT-INSTRUCTIONS.md

Version → v0.7.1
All file references → v0.7.0 names
Session start → one-file upload flow
Boot sequence → removed, reference sc build
/exit → /sc exit
Folder structure diagram → v0.7.0
PR workflow → PRs everywhere, staging branch
Add /sc create and /sc exit to commands
Add discovery self-check before producing docs
End of session → session log production, not CHAT-LOG

Definition of done: Fully reflects v0.7.0 structure with self-check behavior.

Task 10 — Update _system/CHAT-REFERENCE.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update CHAT-REFERENCE.md for v0.7.0

File: /mnt/d/Claude/_system/CHAT-REFERENCE.md (outside repo)

Update project structure to v0.7.0
Remove boot sequence, add sc build
Session start → one-file upload
Add /sc create and /sc exit
Keep Purls-specific rules (11-14)

Definition of done: Personal file current. Personal values preserved.

Task 11 — Update scaffolder’s own project docs

Branch: feature/v0.7.1-sc-updates Commit: docs: update scaffolder SPEC, ARCHITECTURE, STATUS, TASKS for current state

docs/SPEC.md — rewrite for v0.7.0+ (not v0.1.0 description)
docs/ARCHITECTURE.md — verify current, update if stale
STATUS.md — update to v0.7.1, current milestone, issues
docs/TASKS.md — update Rules section references

Definition of done: Scaffolder docs reflect actual current state.

Task 12 — Update docs/COMMANDS.md, CUSTOMIZE.md, INSTALL.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update COMMANDS, CUSTOMIZE, INSTALL for v0.7.1

docs/COMMANDS.md — add sc create, sc exit, fix sc done references
docs/CUSTOMIZE.md — add mode, operatorAlias, operatorDescription, template customization section, update defaults
docs/INSTALL.md — add new init fields, update commands list, sc create

Definition of done: All GitHub docs current.

Task 13 — Fix stale references in templates/SETUP-GUIDE.md

Branch: feature/v0.7.1-sc-updates Commit: docs: fix stale references in SETUP-GUIDE.md

Targeted fixes only (full rewrite is Phase 4):

Section 12: remove CLAUDE-CHAT.md copy line
Section 14: reference PROJECT-INSTRUCTIONS.md from _system/
Add sc create alongside create references
Replace [ARCHITECT_NAME]/[BUILDER_NAME] with [CHAT_AI_NAME]/[CODE_AI_NAME]
“You’re ready” → sc create

Definition of done: No stale file references. Placeholders updated.

Task 14 — Update README.md and SECURITY.md

Branch: feature/v0.7.1-sc-updates Commit: docs: update README and SECURITY for v0.7.1

README: sc create in quick start, add sc create/exit to commands, update requirements note, update “What you get”
SECURITY.md: supported versions → 0.7.x

Definition of done: Both files current.

SECTION C — Version bump and release

Task 15 — Version bump, CHANGELOG, migration, and PR

Branch: feature/v0.7.1-sc-updates Commit: chore: bump version to 0.7.1 Commit: docs: update CHANGELOG for v0.7.1

Bump package.json to 0.7.1
Update versions.json (latest: “0.7.1”, add entry with breaking: true)
Update CHANGELOG.md
Update README badge
Create migration src/migrations/v0.7.0-to-v0.7.1.ts, register in index.ts
PR: feature → dev (PR required)
Merge dev (via PR)
Verify build, sc help, sc create —dry-run
PR: dev → main
Report PR URL to operator
After merge: tag v0.7.1
Update sessions/CURRENT.md
Push all changes

Definition of done: v0.7.1 tagged on main. Everything works. All docs current. Build clean.