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

37 lines
1.0 KiB
Markdown

---
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.