claude_memory 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 015ffacff45c0d7976124cbf40c2188d03f3fd182f24de2eab83bd5c0273107e
-  data.tar.gz: 68879337aca9ec2b5e9574df1982aead620975b84448cf0ca385d00690619d5b
+  metadata.gz: cba9abfc06579e1d4e979fe20c81b6c751351b2001c9efc0f7144973454d9b2d
+  data.tar.gz: 95e420c5c7e6705564332c68d3728ee9cf43984e89207bdce46121223dac1ddc
 SHA512:
-  metadata.gz: 3c3ba3ea0f53e035b7ea377bc2c81fc398d7476bfb1019594db274e6aba67e2d92d09420e5f8c08ce1695a0f0128b1cb03d6931df92c172f57f3dc903233c41a
-  data.tar.gz: f4f1c185a02b2c5a469dac940e4b06a2cd37a67d0efc4ae8199d4688a2a3511eaf856ea393ecfb9f8972febe6d05cf490c384071a9e349e307d8adf20753219f
+  metadata.gz: c6b7ee6d2ff3ab5cea00e99995781d295527859cc328b1572220075cff829ff089090d871cb40d65a5d4e8d9b518a66637bc32d3c3d6ab98b14a8968338cce1a
+  data.tar.gz: 17884491cf569f5627fa3f4b4328eb214625236d75585517bd4dd3a30b393c0e6f2b33198087207916e8a9c65c00bc6360db3b2f042f7aaff057b605dda50df8

data/.claude/rules/claude_memory.generated.md

@@ -1,13 +1,19 @@
 <!-- 
   This file is auto-generated by claude-memory.
   Do not edit manually - changes will be overwritten.
-  Generated: 2026-01-20T22:15:57Z
+  Generated: 2026-01-22T18:04:05Z
 -->
 
 # Project Memory
 
 ## Conventions
 
+- frozen_string_literal: true in all Ruby files
+- RSpec format documentation
+- Default Rake task runs spec and standard
+- Pre-commit hook runs standard:fix and stages changes
+- Pre-commit hook runs tests
+- Ruby version 3.2 minimum
 - run linting with 'bundle exec rake standard'
 - Ruby 3.2+ required
 - frozen_string_literal: true in all Ruby files

data/.claude/settings.json

@@ -2,7 +2,6 @@
   "hooks": {
     "Stop": [
       {
-        "matcher": "",
         "hooks": [
           {
             "type": "command",
@@ -14,7 +13,6 @@
     ],
     "SessionStart": [
       {
-        "matcher": "",
         "hooks": [
           {
             "type": "command",
@@ -26,7 +24,6 @@
     ],
     "PreCompact": [
       {
-        "matcher": "",
         "hooks": [
           {
             "type": "command",
@@ -43,7 +40,6 @@
     ],
     "SessionEnd": [
       {
-        "matcher": "",
         "hooks": [
           {
             "type": "command",

data/.claude/settings.local.json

@@ -14,7 +14,10 @@
       "mcp__memory__memory_changes",
       "mcp__memory__memory_status",
       "mcp__memory__memory_store_extraction",
-      "mcp__memory__memory_explain"
+      "mcp__memory__memory_explain",
+      "Bash(bundle exec rspec:*)",
+      "Bash(bundle exec rake:*)",
+      "mcp__plugin_claude-memory_memory__memory_store_extraction"
     ]
   },
   "enableAllProjectMcpServers": true

data/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Long-term self-managed memory for Claude Code with fact extraction, truth maintenance, and provenance tracking",
   "author": {
     "name": "Valentino Stoll"

data/.claude.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "claude-memory": {
+      "type": "stdio",
+      "command": "claude-memory",
+      "args": [
+        "serve-mcp"
+      ]
+    }
+  }
+}

data/.ruby-version

@@ -0,0 +1 @@
+4.0.1

data/CHANGELOG.md

@@ -4,19 +4,70 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-01-22
+
 ### Added
 
-- **Claude Code Plugin**: Full plugin structure for seamless Claude Code integration
-  - `.claude-plugin/plugin.json` manifest
-  - `.claude-plugin/marketplace.json` for plugin distribution
-  - `hooks/hooks.json` with prompt hooks for Claude-powered extraction
-  - `skills/memory/SKILL.md` for `/memory` command
-- **Claude-Powered Fact Extraction**: New `memory.store_extraction` MCP tool
-  - Accepts structured JSON with entities, facts, and decisions
-  - Prompt hooks ask Claude to extract facts on session stop
-  - No API key required - uses Claude Code's own session
-  - Full schema validation with truth maintenance
-- **Empty Query Handling**: FTS5 search now gracefully handles empty queries
+**Privacy & Security**
+- Privacy tag system: `<private>`, `<no-memory>`, `<secret>` tags strip sensitive content from ingestion
+- ContentSanitizer module with comprehensive sanitization logic
+- ReDoS protection: Maximum 100 tags per ingestion to prevent regex attacks
+- 100% test coverage for ContentSanitizer (security-critical module)
+
+**Token Economics & Performance**
+- Progressive disclosure pattern with two-phase queries:
+  - `memory.recall_index` - Lightweight index with previews (~50 tokens per fact)
+  - `memory.recall_details` - Full details on demand with provenance
+- TokenEstimator module for accurate query result sizing
+- 10x token reduction for initial memory searches
+- N+1 query elimination in Recall class (reduced from 2N+1 to 3 queries via batch loading)
+- IndexQuery object for cleaner full-text search logic
+- QueryOptions parameter object for consistent option handling
+
+**Semantic Shortcuts**
+- `memory.decisions` - Quick access to architectural decisions and accepted proposals
+- `memory.conventions` - Global coding conventions and style preferences
+- `memory.architecture` - Framework choices and architectural patterns
+- Shortcuts query builder with centralized predicate configuration
+- Pre-configured queries eliminate manual search construction
+
+**Claude Code Plugin**
+- Full plugin structure for seamless Claude Code integration
+- `.claude-plugin/plugin.json` manifest with marketplace metadata
+- `hooks/hooks.json` with prompt hooks for Claude-powered extraction
+- `skills/memory/SKILL.md` for `/memory` command
+
+**Claude-Powered Fact Extraction**
+- `memory.store_extraction` MCP tool for structured fact storage
+- Accepts JSON with entities, facts, and decisions
+- Prompt hooks trigger extraction on session stop
+- No API key required - uses Claude Code's own session
+- Full schema validation with truth maintenance
+
+**Developer Experience**
+- Exit code strategy for hooks with semantic constants:
+  - `SUCCESS = 0` - Operation completed successfully
+  - `WARNING = 1` - Completed with warnings (e.g., skipped ingestion)
+  - `ERROR = 2` - Operation failed
+- Comprehensive hook tests covering all event types (13 test cases)
+- PrivacyTag value object for type-safe tag handling
+- Empty query handling for FTS5 search
+
+**Testing & Quality**
+- 157 new test examples (grew from 426 to 583 total)
+- 100% coverage for TokenEstimator (accuracy-critical)
+- Comprehensive privacy tag tests including ReDoS protection
+- Hook exit code verification tests
+
+### Changed
+- CLI hook commands now return standardized exit codes instead of mixed returns
+- Recall queries optimized with batch loading for provenance and entities
+- Index searches use QueryOptions for consistent parameter handling
+
+### Documentation
+- README restructured for clarity and quick onboarding
+- New comprehensive examples documentation
+- Simplified getting started experience
 
 ## [0.1.0] - 2026-01-20
 

data/CLAUDE.md

@@ -75,43 +75,84 @@ Transcripts → Ingest → Index (FTS5)
 
 ### Module Structure
 
-- **`Store`**: SQLite database access via Sequel (`sqlite_store.rb`, `store_manager.rb`)
+#### Application Layer
+
+- **`CLI`**: Thin command router (`cli.rb`) - 41 lines
+  - Routes commands to dedicated command classes via Registry
+  - No business logic (pure dispatcher)
+
+- **`Commands`**: Individual command classes (`commands/`)
+  - Each command is a separate class (HelpCommand, DoctorCommand, etc.)
+  - All commands inherit from BaseCommand
+  - Dependency injection for I/O (stdout, stderr, stdin)
+  - 16 commands total, each focused on single responsibility
+
+- **`Configuration`**: Centralized ENV access (`configuration.rb`)
+  - Single source of truth for paths and environment variables
+  - Testable with custom ENV hash
+
+#### Core Domain Layer
+
+- **`Domain`**: Rich domain models with business logic (`domain/`)
+  - `Fact`: Facts with validation, status checking (active?, superseded?)
+  - `Entity`: Entities with type checking (database?, framework?)
+  - `Provenance`: Evidence with strength checking (stated?, inferred?)
+  - `Conflict`: Conflicts with status tracking (open?, resolved?)
+  - All domain objects are immutable (frozen) and self-validating
+
+- **`Core`**: Value objects and null objects (`core/`)
+  - Value objects: SessionId, TranscriptPath, FactId (type-safe primitives)
+  - Null objects: NullFact, NullExplanation (eliminates nil checks)
+  - Result: Success/Failure pattern for consistent error handling
+
+#### Infrastructure Layer
+
+- **`Store`**: SQLite database access via Sequel (`store/`)
+  - `SQLiteStore`: Database operations
+  - `StoreManager`: Dual-database connection manager
   - Schema includes: content_items, entities, facts, provenance, fact_links, conflicts
-  - Schema migrations in `ensure_schema!` and `migrate_to_v2!`
+  - Transaction safety for multi-step operations
+
+- **`Infrastructure`**: I/O abstractions (`infrastructure/`)
+  - `FileSystem`: Real filesystem wrapper
+  - `InMemoryFileSystem`: Fast in-memory testing without disk I/O
 
-- **`Ingest`**: Transcript reading and delta-based ingestion (`ingester.rb`, `transcript_reader.rb`)
+#### Business Logic Layer
+
+- **`Ingest`**: Transcript reading and delta-based ingestion (`ingest/`)
   - Tracks cursor position per session to avoid re-processing
 
-- **`Index`**: Full-text search using SQLite FTS5 (`lexical_fts.rb`)
-  - No embeddings required for MVP
+- **`Index`**: Full-text search using SQLite FTS5 (`index/`)
+  - Optimized with batch queries to eliminate N+1 issues
 
-- **`Distill`**: Fact extraction interface (`distiller.rb`, `null_distiller.rb`)
+- **`Distill`**: Fact extraction interface (`distill/`)
   - Pluggable distiller design (current: NullDistiller stub)
   - Extracts entities, facts, scope hints from content
 
-- **`Resolve`**: Truth maintenance and conflict resolution (`resolver.rb`, `predicate_policy.rb`)
+- **`Resolve`**: Truth maintenance and conflict resolution (`resolve/`)
   - Determines equivalence, supersession, or conflicts
   - PredicatePolicy controls single-value vs multi-value predicates
+  - Transaction safety for atomic operations
 
 - **`Recall`**: Query interface for facts (`recall.rb`)
   - Searches both global + project databases
+  - Batch queries to avoid N+1 performance issues
   - Returns facts with provenance receipts
 
-- **`Sweep`**: Maintenance and pruning (`sweeper.rb`)
+- **`Sweep`**: Maintenance and pruning (`sweep/`)
 
-- **`Publish`**: Snapshot generation to Claude Code memory files (`publish.rb`)
+- **`Publish`**: Snapshot generation (`publish.rb`)
+  - Uses FileSystem abstraction for testability
   - Modes: shared (repo), local (uncommitted), home (user directory)
 
-- **`MCP`**: Model Context Protocol server and tools (`mcp/server.rb`, `mcp/tools.rb`)
-  - Exposes memory tools to Claude Code: recall, explain, promote, status, conflicts, changes, sweep_now
+- **`MCP`**: Model Context Protocol server and tools (`mcp/`)
+  - Exposes memory tools to Claude Code
+  - Tools: recall, explain, promote, status, conflicts, changes, sweep_now
 
-- **`Hook`**: Hook entrypoint handlers (`hook/handler.rb`)
+- **`Hook`**: Hook entrypoint handlers (`hook/`)
   - Reads stdin JSON from Claude Code hooks
   - Routes to ingest/sweep/publish commands
 
-- **`CLI`**: Command-line interface (`cli.rb`)
-  - All user-facing commands and option parsing
-
 ### Database Schema
 
 Key tables (defined in `sqlite_store.rb`):
@@ -149,11 +190,28 @@ When writing tests:
 
 ### Adding a New CLI Command
 
-1. Add command name to `CLI#run` case statement
-2. Implement private method (e.g., `my_command_cmd`)
-3. Add parser method (e.g., `parse_my_command_options`)
-4. Update `print_help` output
-5. Add corresponding tests in `spec/claude_memory/cli_spec.rb`
+1. Create new command class in `lib/claude_memory/commands/` (e.g., `my_command.rb`)
+2. Inherit from `BaseCommand` and implement `call(args)` method
+3. Add command to `Commands::Registry::COMMANDS` hash
+4. Add corresponding tests in `spec/claude_memory/commands/my_command_spec.rb`
+5. Use dependency injection for I/O (stdout, stderr, stdin) for testability
+
+Example:
+```ruby
+class MyCommand < BaseCommand
+  def call(args)
+    opts = parse_options(args, {flag: false}) do |o|
+      OptionParser.new do |parser|
+        parser.on("--flag", "Enable flag") { o[:flag] = true }
+      end
+    end
+    return 1 if opts.nil?
+
+    stdout.puts "Command executed!"
+    0  # Exit code
+  end
+end
+```
 
 ### Adding a New MCP Tool
 
@@ -177,11 +235,16 @@ Single-value predicates (like "uses_database") supersede old values. Multi-value
 ## Important Files
 
 - `lib/claude_memory.rb`: Main module, requires, database path helpers
-- `lib/claude_memory/cli.rb`: All CLI command implementations (800+ lines)
+- `lib/claude_memory/cli.rb`: Thin command router (41 lines)
+- `lib/claude_memory/commands/`: Individual command classes (16 commands)
+- `lib/claude_memory/configuration.rb`: Centralized configuration and ENV access
+- `lib/claude_memory/domain/`: Domain models (Fact, Entity, Provenance, Conflict)
+- `lib/claude_memory/core/`: Value objects and null objects
+- `lib/claude_memory/infrastructure/`: I/O abstractions (FileSystem)
 - `lib/claude_memory/store/store_manager.rb`: Dual-database connection manager
-- `lib/claude_memory/resolve/resolver.rb`: Truth maintenance logic
-- `lib/claude_memory/recall.rb`: Fact query and merging logic
-- `docs/updated_plan.md`: Comprehensive architectural plan and milestones
+- `lib/claude_memory/resolve/resolver.rb`: Truth maintenance with transaction safety
+- `lib/claude_memory/recall.rb`: Optimized fact query with batch loading
+- `docs/quality_review.md`: Quality improvements and refactoring notes
 - `claude_memory.gemspec`: Gem metadata and dependencies
 
 ## MCP Integration

data/README.md

@@ -1,200 +1,109 @@
 # ClaudeMemory
 
-Turn-key Ruby gem providing Claude Code with instant, high-quality, long-term, self-managed memory using **Claude Code Hooks + MCP + Output Style**, with minimal dependencies (SQLite by default).
+**Long-term memory for Claude Code** - automatic, intelligent, zero-configuration
 
-## Features
+[![Gem Version](https://badge.fury.io/rb/claude_memory.svg)](https://badge.fury.io/rb/claude_memory)
 
-- **Automated ingestion**: Claude Code hooks trigger delta-based transcript ingestion
-- **Claude-powered fact extraction**: Uses Claude's own intelligence to extract facts (no API key needed)
-- **Truth maintenance**: Deterministic conflict/supersession resolution
-- **Full-text search**: SQLite FTS5 for fast recall without embeddings
-- **MCP integration**: Memory tools accessible directly in Claude Code
-- **Snapshot publishing**: Curated memory files for Claude Code's built-in system
-- **Claude Code Plugin**: Install as a plugin for seamless integration
+## What It Does
 
-## Installation
+ClaudeMemory gives Claude Code a persistent memory across all your conversations.
+It automatically:
+- ✅ Extracts durable facts from conversations (tech stack, preferences, decisions)
+- ✅ Remembers project-specific and global knowledge
+- ✅ Provides instant recall without manual prompting
+- ✅ Maintains truth (handles conflicts, supersession)
 
-```bash
-gem install claude_memory
-```
+**No API keys. No configuration. Just works.**
 
-Or add to your Gemfile:
+## Quick Start
 
-```ruby
-gem 'claude_memory'
+### Install
+```bash
+gem install claude_memory
 ```
 
-## Quick Start
-
+### Initialize
 ```bash
-# Initialize in your project (project-local)
-cd your-project
+# In your project
+cd my-project
 claude-memory init
 
-# Or install globally for all projects
+# Or globally for all projects
 claude-memory init --global
 
 # Verify setup
 claude-memory doctor
 ```
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `init` | Initialize ClaudeMemory in a project |
-| `db:init` | Initialize the SQLite database |
-| `ingest` | Ingest transcript delta |
-| `hook ingest` | Hook entrypoint for ingest (reads stdin JSON) |
-| `hook sweep` | Hook entrypoint for sweep (reads stdin JSON) |
-| `hook publish` | Hook entrypoint for publish (reads stdin JSON) |
-| `search` | Search indexed content |
-| `recall` | Recall facts matching a query |
-| `explain` | Explain a fact with provenance receipts |
-| `conflicts` | Show open conflicts |
-| `changes` | Show recent fact changes |
-| `publish` | Publish snapshot to Claude Code memory |
-| `sweep` | Run maintenance/pruning |
-| `serve-mcp` | Start MCP server for Claude Code |
-| `doctor` | Check system health |
-
-## Usage Examples
-
-### Ingest Content
+### Use with Claude Code
+Just talk naturally! Memory happens automatically.
 
-```bash
-claude-memory ingest \
-  --source claude_code \
-  --session-id sess-123 \
-  --transcript-path ~/.claude/projects/myproject/transcripts/latest.jsonl
 ```
+You: "I'm building a Rails app with PostgreSQL, deploying to Heroku"
+Claude: [helps with setup]
 
-### Recall Facts
-
-```bash
-claude-memory recall "database"
-# Returns facts + provenance receipts
-
-claude-memory recall "database" --scope project
-# Only facts scoped to current project
-
-claude-memory recall "preferences" --scope global
-# Only global facts (apply to all projects)
-
-claude-memory explain 42
-# Detailed explanation with supersession/conflict links
+# Behind the scenes:
+# - Session transcript ingested
+# - Facts extracted automatically
+# - No user action needed
 ```
 
-### Publish Snapshot
-
-```bash
-# Publish to .claude/rules/ (shared, default)
-claude-memory publish
-
-# Publish to local file (not committed)
-claude-memory publish --mode local
-
-# Publish to user home directory
-claude-memory publish --mode home
+**Later:**
 ```
-
-### MCP Tools
-
-When configured, these tools are available in Claude Code:
-
-- `memory.recall` - Search for relevant facts (supports scope filtering)
-- `memory.explain` - Get detailed fact provenance
-- `memory.promote` - Promote a project fact to global memory
-- `memory.store_extraction` - Store extracted facts from a conversation
-- `memory.changes` - Recent fact updates
-- `memory.conflicts` - Open contradictions
-- `memory.sweep_now` - Run maintenance
-- `memory.status` - System health check
-
-## Scope: Global vs Project
-
-Facts are scoped to control where they apply:
-
-| Scope | Description | Example |
-|-------|-------------|---------|
-| `project` | Applies only to the current project | "This app uses PostgreSQL" |
-| `global` | Applies across all projects | "I prefer 4-space indentation" |
-
-**Automatic detection**: The distiller recognizes signals like "always", "in all projects", or "my preference" and sets `scope_hint: "global"`.
-
-**Manual promotion**: Use `memory.set_scope` in Claude Code or the user can say "make that preference global" and Claude will call the tool.
-
-## Claude Code Plugin
-
-ClaudeMemory is available as a Claude Code plugin for seamless integration.
-
-### Install as Plugin
-
-```bash
-# Add the marketplace
-/plugin marketplace add /path/to/claude_memory
-
-# Install the plugin
-/plugin install claude-memory
+You: "Help me add a background job"
+Claude: "Based on my memory, you're using Rails with PostgreSQL..."
 ```
 
-### Plugin Components
+👉 **[See Getting Started Guide →](docs/GETTING_STARTED.md)**
+👉 **[View Example Conversations →](docs/EXAMPLES.md)**
 
-| Component | Description |
-|-----------|-------------|
-| **MCP Server** | Exposes memory tools to Claude |
-| **Hooks** | Automatic ingestion, extraction, and publishing |
-| **Skill** | `/memory` command for manual interaction |
+## How It Works
 
-### How Claude-Powered Extraction Works
+1. **You chat with Claude** - Tell it about your project
+2. **Facts are extracted** - Claude identifies durable knowledge
+3. **Memory persists** - Stored locally in SQLite
+4. **Automatic recall** - Claude remembers in future conversations
 
-ClaudeMemory uses **prompt hooks** to leverage Claude's own intelligence for fact extraction—no separate API key required:
+👉 **[Architecture Deep Dive →](docs/architecture.md)**
 
-1. **On session stop**: A prompt hook asks Claude to review what it learned
-2. **Claude extracts facts**: Using its understanding of the conversation, Claude identifies durable facts
-3. **Stores via MCP**: Claude calls `memory.store_extraction` to persist the facts
-4. **Truth maintenance**: The resolver handles conflicts and supersession automatically
+## Key Features
 
-This approach means:
-- ✅ No API key configuration needed
-- ✅ Uses Claude's full contextual understanding
-- ✅ Extracts only genuinely useful, durable facts
-- ✅ Respects scope (project vs global)
+- **Dual Scope**: Project-specific + global user preferences
+- **Privacy First**: `<private>` tags exclude sensitive data
+- **Progressive Disclosure**: Lightweight queries before full details
+- **Semantic Shortcuts**: Quick access to decisions, conventions, architecture
+- **Truth Maintenance**: Automatic conflict resolution
+- **Claude-Powered**: Uses Claude's intelligence to extract facts (no API key needed)
+- **Token Efficient**: 10x reduction in memory queries with progressive disclosure
 
-### Fact Types Extracted
+## Privacy Control
 
-| Predicate | Description | Example |
-|-----------|-------------|---------|
-| `uses_database` | Database technology | "PostgreSQL" |
-| `uses_framework` | Framework choice | "Rails", "React" |
-| `deployment_platform` | Where deployed | "Vercel", "AWS" |
-| `convention` | Coding standards | "4-space indentation" |
-| `decision` | Architectural choice | "Use microservices" |
-| `auth_method` | Authentication approach | "JWT tokens" |
-
-## Architecture
+Exclude sensitive data from memory using privacy tags:
 
 ```
-Transcripts → Ingest → FTS Index
-                    ↓
-        Claude Prompt Hook → Extract entities/facts/signals
-                    ↓
-         memory.store_extraction (MCP)
-                    ↓
-              Resolve → Truth maintenance (conflicts/supersession)
-                    ↓
-              Store → SQLite (facts, provenance, entities, scope)
-                    ↓
-              Publish → .claude/rules/claude_memory.generated.md
+You: "My API key is <private>sk-abc123</private>"
+Claude: [uses it during session]
+
+# Stored: "API endpoint configured with key"
+# NOT stored: "sk-abc123"
 ```
 
-## Configuration
+Supported tags: `<private>`, `<no-memory>`, `<secret>`
 
-The database location defaults to `.claude_memory.sqlite3` in the project root.
+## Documentation
 
-Override with `--db PATH` on any command.
+- 📖 [Getting Started](docs/GETTING_STARTED.md) - Step-by-step onboarding *(coming soon)*
+- 💡 [Examples](docs/EXAMPLES.md) - Use cases and workflows
+- 🔧 [Plugin Setup](docs/PLUGIN.md) - Claude Code integration
+- 🏗️ [Architecture](docs/architecture.md) - Technical deep dive
+- 📝 [Changelog](CHANGELOG.md) - Release notes
 
-## Development
+## For Developers
+
+- **Language:** Ruby 3.2+
+- **Storage:** SQLite3 (no external services)
+- **Testing:** 583 examples, 100% core coverage
+- **Code Style:** Standard Ruby
 
 ```bash
 git clone https://github.com/codenamev/claude_memory
@@ -203,10 +112,18 @@ bin/setup
 bundle exec rspec
 ```
 
+👉 **[Development Guide →](CLAUDE.md)**
+
+## Support
+
+- 🐛 [Report a bug](https://github.com/codenamev/claude_memory/issues)
+- 💬 [Discussions](https://github.com/codenamev/claude_memory/discussions)
+- 📧 Email: valentino@hanamirb.org
+
 ## License
 
-MIT License - see [LICENSE.txt](LICENSE.txt)
+MIT - see [LICENSE.txt](LICENSE.txt)
 
-## Contributing
+---
 
-Bug reports and pull requests welcome at https://github.com/codenamev/claude_memory
+**Made with ❤️ by [Valentino Stoll](https://github.com/codenamev)**