work in progress.

CLAUDE.md

@@ -185,3 +185,39 @@ Optional:
 ### Admin commands
 - `!setusername @user <name>` - Set name for another user
 - `!teachbot @user <fact>` - Add a fact about a user
+
+## Development Guidelines
+
+### When Adding New Features
+1. **Always write tests** - New services need corresponding test files in `tests/`
+2. **Update documentation** - README.md and relevant docs/ files must be updated
+3. **Update CLAUDE.md** - Add new services, models, and config options here
+4. **Follow existing patterns** - Match the style of existing services
+
+### Planned Features (In Progress)
+The following features are being implemented:
+
+1. **Attachment Pattern Tracking** (`attachment_service.py`)
+   - Detect anxious/avoidant/disorganized patterns
+   - Adapt responses based on attachment state
+   - Track what helps regulate each person
+
+2. **Grief Journey Tracking** (`grief_service.py`)
+   - Track grief context and phase
+   - Recognize anniversaries and hard dates
+   - Adjust support style based on grief phase
+
+3. **Grounding & Coping Tools** (`grounding_service.py`)
+   - Breathing exercises, sensory grounding
+   - Spiral detection and intervention
+   - Session pacing and intensity tracking
+
+4. **Enhanced Support Memory**
+   - Learn HOW someone wants to be supported
+   - Track effective vs ineffective approaches
+   - Remember comfort topics for breaks
+
+5. **Communication Style Matching**
+   - Energy matching (playful vs serious)
+   - Directness calibration
+   - Real-time tone adaptation