Skip to content

roadmap.md

Latest commit

 

History

History
60 lines (49 loc) · 3.3 KB

roadmap.md

File metadata and controls

60 lines (49 loc) · 3.3 KB

Roadmap — claude-code-setup

Sprint 1: Initial Setup (MVP)

  • Define project goals and use cases
  • Create directory structure
  • Create concept document
  • Create README.md
  • Create AI_INSTRUCTIONS.md
  • Create roadmap.md (this file)
  • Create daily task tracker
  • Create project-level .claude/settings.json
  • Create doc-keeper agent
  • Verify consistency across all documents
  • Initialize git repository

Sprint 2: UX Improvements & Documentation (Done)

  • Rename Files_Used/PUT_IN_GLOBAL_CLAUDE_FOLDER/ to global_config/
  • Update all cross-references (AI_INSTRUCTIONS, concept.md, doc-keeper.md)
  • SKILL.md: Add context detection (existing folder vs fresh start)
  • SKILL.md: Smart project name suggestion from folder name
  • SKILL.md: Add Phase 5.5 for project-specific skills
  • README: Add Two Setup Approaches section
  • README: Add Global vs Project-Level Configuration section
  • README: Add Skills and Agents comparison section
  • README: Add overwrite warning to Quick Start
  • README: Add Customizing Skills section

Sprint 3: Opus 4.8 Realignment (Done — 2026-05-30)

The setup was tuned for Opus 4.5/4.6 and felt heavier on 4.7/4.8 (a more literal, more agentic model executes soft prose imperatives close to the letter). Diagnosed via multi-agent research + adversarial verification; realigned the format. See claude_plans/PLAN_opus_4_8_realign.md.

  • Rewrite global_config/CLAUDE.md to tiered Hard rules / Preferences (was a flat ALWAYS/NEVER wall)
  • Add global_config/output-styles/personal-voice.md (tone style, keep-coding-instructions: true, on by default via outputStyle)
  • Modernize project-setup skill (scale-to-task-size; no "do not skip phases"; key-presence settings check)
  • Create realign-project skill (/realign) — existing-project counterpart to project-setup
  • Create plan skill (/custom_plan) — read-only sprint/feature planning into claude_plans/PLAN_<name>.md, no native plan mode (sidesteps approve-then-build)
  • Light-sync README, concept, AI_INSTRUCTIONS, doc-keeper, example_ai_instructions to the new format
  • Apply live to ~/.claude/ and field-test /realign on a real existing project

Sprint 4: Finish & Extend (In progress)

  • Finish documenting the realignment in THIS repo's own docs (done 2026-05-30 doc-audit)
  • First-class docs/opus_4_8_alignment.md (the 10 alignment principles + the why) — file complete
  • Sync global_config/settings.json template to the new live defaults (effortLevel high, includeCoAuthoredBy:false, deny example) — done
  • Decide: wire personal-voice output style on by default — DONE, outputStyle set in settings (tone is single-homed in the style, removed from CLAUDE.md)
  • Initialize git repository / first commit — done (commit 4c20f43)
  • Optional plan-rename hook; agent templates for common project types; install script

Status

Sprint Status Notes
Sprint 1 Done Initial project setup
Sprint 2 Done UX improvements, folder rename, README expansion
Sprint 3 Done Opus 4.8 realignment (format, skills, output style, live + field-test)
Sprint 4 In progress Own-docs + first commit done; optional hook/templates/install-script deferred