CLI and Skills Consolidation

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

Problem

Skills and commands grew organically and became redundant. Operator doesn’t use most of them. Many never worked as intended. Time tracking infrastructure unused. Folder names (claude-skills, claude-commands) are unclear to new users.

Decision

CLI — keep 4 commands, remove 11

Keep:

Command	What it does
`sc create <project>`	Create a new project with full scaffolding
`sc start <project>`	cd to project path, launch Harley, session-start fires automatically
`sc config`	View/set scaffolder config
`sc update <project>`	Update existing project to latest scaffolder version

Remove: sc build, sc end, sc done, sc exit, sc status, sc open, sc ruleset, sc history, sc log, sc queue, sc help

Notes:

sc start replaces sc build — “start” is the verb, not “build”
sc end/done/exit replaced by session-end hook (automatic on Harley exit)
All time tracking commands removed (history, log, start-as-timer)
sc queue replaced by Plane
sc ruleset unreferenced, purge

Template folder rename

Old structure (delete):

templates/claude-skills/ → replaced by templates/code-skills/ and templates/chat-skills/
templates/claude-commands/ → deleted entirely (no commands remain)

New structure:

templates/code-skills/ — Harley’s skills (session-start, plan-mode-reminder)
templates/chat-skills/ — Joker’s skills (single combined scaffolder skill)

Harley (Claude Code) — 2 skills, 1 hook, 0 commands

Skills (from templates/code-skills/, installed to .claude/skills/):

session-start — reads state, reports, asks for goal, refuses work until confirmed
plan-mode-reminder — suggests plan mode for complex tasks

Hook:

session-end — pre-exit hook, writes CURRENT-CODE.md + log, commits, pushes

Commands: all 12 slash command wrappers deleted. Harley runs sc commands directly as bash if needed.

Joker (Claude Chat) — 1 combined skill, protocol in Project Instructions

Skill (from templates/chat-skills/scaffolder/, uploaded to Claude.ai Settings > Skills):

scaffolder — combines discovery and doc production in one skill

Session management: baked into Project Instructions, not a separate skill.

Cleanup

Delete from templates:

templates/claude-commands/ (entire directory)
templates/claude-skills/ (entire directory — replaced by code-skills/ and chat-skills/)

Delete from live .claude/:

.claude/commands/ (all 12 files)
.claude/skills/sc-session-start/
.claude/skills/sc-session-end/

Replace in live .claude/skills/:

Copy templates/code-skills/session-start/ → .claude/skills/session-start/
Copy templates/code-skills/plan-mode-reminder/ → .claude/skills/plan-mode-reminder/

From Claude.ai Settings > Skills (operator manual action):

Delete: sc-discovery (replaced by combined scaffolder skill)
Delete: sc-doc-production (replaced by combined scaffolder skill)
Upload: templates/chat-skills/scaffolder/SKILL.md as new skill