diff --git a/.claude/rules/commands.md b/.claude/rules/commands.md deleted file mode 100644 index d59a04e8e..000000000 --- a/.claude/rules/commands.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -paths: - - "commands/gsd/**/*.md" ---- - -# Slash Command Rules - -Rules for editing files in `commands/gsd/`. - -## File Structure - -```yaml ---- -name: gsd:command-name -description: One-line description -argument-hint: "" or "[optional]" -allowed-tools: [Read, Write, Bash, Glob, Grep, AskUserQuestion] ---- -``` - -## Section Order - -1. `` — What/why/when (always present) -2. `` — @-references to workflows, templates, references -3. `` — Dynamic content: `$ARGUMENTS`, bash output, @file refs -4. `` or `` elements — Implementation steps -5. `` — Measurable completion checklist - -## Core Principle - -**Commands are thin wrappers.** Delegate detailed logic to workflows. - -Commands answer "what to do", workflows answer "how to do it". - -## @-Reference Patterns - -```markdown - -@~/.claude/get-shit-done/workflows/execute-phase.md -@~/.claude/get-shit-done/templates/summary.md -@~/.claude/get-shit-done/references/plan-format.md - - - -$ARGUMENTS - -@.planning/PROJECT.md -@.planning/STATE.md - -``` - -- `execution_context`: Static resources (workflows, templates, references) -- `context`: Dynamic project state and arguments - -## Success Criteria Format - -```xml - -- [ ] Specific, measurable criterion -- [ ] Another verifiable outcome - -``` - -Use checkbox format. Each criterion must be objectively verifiable. diff --git a/.claude/rules/references.md b/.claude/rules/references.md deleted file mode 100644 index 3a2cdabe7..000000000 --- a/.claude/rules/references.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -paths: - - "get-shit-done/references/**/*.md" ---- - -# Reference File Rules - -Rules for editing files in `get-shit-done/references/`. - -## Outer Container Pattern - -References typically use an outer XML container related to the filename: - -- `principles.md` → `...` -- `checkpoints.md` → `...` then `...` -- `plan-format.md` → `...` then `...` - -Not a strict rule — check the file you're editing. - -## Internal Structure - -Internal organization varies. Common patterns: -- Semantic sub-containers (``, ``) -- Markdown headers within XML -- Code examples in fenced blocks - -## Teaching Patterns - -References often teach by contrast: -- Show vague vs. specific examples -- Explain WHY something is problematic -- Provide concrete alternatives - -## Key Principle - -References explain concepts and patterns loaded by workflows/commands when relevant. Match the style of the specific reference you're editing. diff --git a/.claude/rules/style.md b/.claude/rules/style.md deleted file mode 100644 index 307ae9dc0..000000000 --- a/.claude/rules/style.md +++ /dev/null @@ -1,87 +0,0 @@ -# GSD Style Rules - -These rules apply to ALL files in this repository. - -## Language & Tone - -**Imperative voice.** "Execute tasks", "Create file" — not "Execution is performed" - -**No filler.** Absent: "Let me", "Just", "Simply", "Basically", "I'd be happy to" - -**No sycophancy.** Absent: "Great!", "Awesome!", "Excellent!", "I'd love to help" - -**Brevity with substance.** Good: "JWT auth with refresh rotation using jose library" Bad: "Phase complete" - -## Temporal Language Ban - -Never write: "We changed X to Y", "Previously", "No longer", "Instead of" - -Always: Describe current state only. - -Exception: CHANGELOG.md, git commits (their purpose IS tracking change) - -## Anti-Patterns - -### Enterprise Patterns (Banned) -- Story points, sprint ceremonies, RACI matrices -- Human dev time estimates (days/weeks) -- Team coordination, knowledge transfer docs - -### Generic XML (Banned) -Don't use: `
`, ``, `` - -Use semantic tags: ``, ``, ``, `` - -## Naming Conventions - -| Type | Convention | Example | -|------|------------|---------| -| Files | kebab-case | `execute-phase.md` | -| Commands | `gsd:kebab-case` | `gsd:execute-phase` | -| Step names | snake_case | `name="load_project_state"` | -| Bash variables | CAPS_UNDERSCORES | `PHASE_ARG` | -| Type attributes | colon separator | `type="checkpoint:human-verify"` | - -## XML Conventions - -XML tags are semantic containers. Use Markdown headers for hierarchy within. - -```xml - - -## Primary Goal -Build authentication system - -## Success Criteria -- Users can log in - - - -
- - Build authentication - -
-``` - -## @-References - -@-references are lazy loading signals — instructions to read, not pre-loaded content. - -``` -@~/.claude/get-shit-done/workflows/execute-phase.md # Static (always load) -@.planning/DISCOVERY.md (if exists) # Conditional -``` - -## Commit Format - -``` -{type}({phase}-{plan}): {description} -``` - -Types: `feat`, `fix`, `test`, `refactor`, `docs`, `chore` - -Rules: -- One commit per task -- Stage files individually (never `git add .`) -- Include `Co-Authored-By: Claude` line diff --git a/.claude/rules/templates.md b/.claude/rules/templates.md deleted file mode 100644 index 1f7ab1050..000000000 --- a/.claude/rules/templates.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -paths: - - "get-shit-done/templates/**/*.md" ---- - -# Template Rules - -Rules for editing files in `get-shit-done/templates/`. - -## Structure Varies - -Templates don't follow a uniform structure. Some patterns: - -- Most start with `# [Name] Template` header -- Many include a `