The hook system and markdown-based agent definition patterns in this framework were inspired by the excellent work in everything-claude-code by Affaan Mustafa (@affaan-m).
Affaan's repository represents 10+ months of battle-tested Claude Code configurations, and we learned valuable architectural patterns from studying his approach:
- Event-driven hooks (PreToolUse, PostToolUse, SessionStart, etc.)
- Markdown agents with YAML frontmatter for portable, human-readable definitions
- Strategic context compaction for managing token windows
- Continuous learning patterns for extracting reusable knowledge
| Pattern Learned | Empathy Implementation |
|---|---|
| Hook event types | Python/Pydantic-based HookConfig with async execution |
| Markdown agent format | MarkdownAgentParser integrated with UnifiedAgentConfig |
| Markdown commands | CommandRegistry with YAML frontmatter parsing and alias resolution |
| Session persistence | Integration with Empathy's state management and trust levels |
| Context compaction | CompactionStateManager with SBAR handoff preservation |
| Continuous learning | SessionEvaluator and PatternExtractor for knowledge retention |
Our implementation is original Python code designed to integrate with Empathy Framework's existing architecture (LangGraph, Pydantic, multi-tier model routing), but the conceptual patterns we learned from Affaan's work were invaluable.
everything-claude-code is released under the MIT License, which permits derivative works with attribution. We provide this attribution in good faith and gratitude.
- everything-claude-code: https://github.com/affaan-m/everything-claude-code
- Affaan's Guides:
- Affaan on X/Twitter: @affaanmustafa
Thank you, Affaan, for sharing your knowledge with the community.