Files
msd-core/.claude/rules/references.md
Lex Christopherson a97c567b01 feat: add .claude/rules/ for auto-loaded contribution rules
Split GSD style guidance into:
- .claude/rules/style.md - global style rules (always loaded)
- .claude/rules/commands.md - path-scoped for commands/gsd/
- .claude/rules/workflows.md - path-scoped for workflows/
- .claude/rules/templates.md - path-scoped for templates/
- .claude/rules/references.md - path-scoped for references/
- GSD-STYLE.md - comprehensive reference for deep dives

Rules auto-load via Claude Code's .claude/rules/ feature (v2.0.64+).
Path-scoped rules only activate when editing matching files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 15:23:21 -06:00

1.0 KiB

paths
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 → <principles>...</principles>
  • checkpoints.md → <overview>...</overview> then <checkpoint_types>...</checkpoint_types>
  • plan-format.md → <overview>...</overview> then <core_principle>...</core_principle>

Not a strict rule — check the file you're editing.

Internal Structure

Internal organization varies. Common patterns:

  • Semantic sub-containers (<solo_developer_claude>, <plans_are_prompts>)
  • 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.