RecordsOverview

Records

Records document decisions, feature designs, and rejected ideas - capturing the “why” behind this project.

They start as planning docs and become permanent documentation that survives any context clear.

Records are maintained in the source repository. Links below open on GitHub.

#TitleStatus
000Core Workflow with CommandsDone
001Modular ArchitectureDone
002Custom Modules DirectoryDone
003Solo vs Team ModeDone
004Document & Clear WorkflowDone
005E2E Tests in GitHub ActionsDone
006Shell Script ArchitectureDone
007Coding Standards as Context SkillsDone
008Content VersioningDone
009ccstatusline IntegrationDone
010Improved Skill Auto-LoadingDone
011Installation & UpgradeDone
012Optional Hooks for Workflow AutomationRejected
013Skill CreatorDone
014Linux SupportDone
015Install Script RefactoringProposed
016Preserve User Instructions in Global CLAUDE.mdDone
017Rename /clear-session to /wrapupDone
018/todo CommandDone
019Auto-Allow Permissions for /claude-code-setupRejected
020Custom Modules VersioningDone
021YouTube Transcript SkillDone
022Docker Matrix Tests for deps.jsonPlanned
023Context Quality ImprovementsDone
024Documentation SiteDone
025Private NotesDone
026External Plugins IntegrationDone
027Uninstall/Remove ModulesDone
028Update NotificationsDone
029Documentation User PerspectiveDone
030/design CommandDone
031Java Developer SkillDone
032Kotlin Standards SkillDone
033Gradle Standards SkillDone
034Workflow Improvements (Correction Trigger + Re-Plan Signs)Designed
035Dynamic CLAUDE.md Table GenerationDone
036Project Template VersioningDone
037Project Template v2Done
038Agent Teams Commands — /with-advisor + /delegateImplemented
039User Stories SkillDesigned
040/claude-code-setup UX — Reduce Permission PromptsDone
041Custom Command Overrides, Extensions & Script DeploymentImplemented

Key Decisions

Workflow

  • No /compact - Auto-compact is unpredictable. Use /wrapup + /clear instead.
  • Two CLAUDE.md files - Global for workflow, project for status.
  • Records for decisions - Permanent docs survive any context clear.

Architecture

  • Monorepo for docs - Code and docs in sync, one PR for both.
  • Skills over prompts - Auto-loading based on tech stack, not manual inclusion.
  • Custom overrides built-in - Team standards take precedence.

Implementation

  • Single install script - No npm/pip install required, just curl and run.
  • ShellCheck compliant - All scripts pass linting.
  • Interactive by default - Users choose what to install.
Module ManagementFile Structure