From cb578de05093d18ae2531165d5ecf80c4cd3a951 Mon Sep 17 00:00:00 2001 From: Evan Senter Date: Thu, 29 Jan 2026 00:01:33 -0800 Subject: [PATCH] docs: Add naming conventions section to CLAUDE.md Document consistent naming patterns for repo, package, CLI, paths, and environment variables - aligned with agent-event-bus. Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 86b6836..8f4cff2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,6 +12,27 @@ Queryable analytics for Claude Code session logs, exposed as an MCP server and C --- +## Naming Conventions + +Follow these patterns consistently (aligned with agent-event-bus): + +| Type | Value | +|------|-------| +| Repo | `agent-session-analytics` | +| Python package | `agent_session_analytics` | +| MCP server name | `agent-session-analytics` | +| CLI commands | `agent-session-analytics`, `agent-session-analytics-cli` | +| Resource URI | `agent-session-analytics://guide` | +| Data directory | `~/.claude/contrib/agent-session-analytics/` | +| Database | `~/.claude/contrib/agent-session-analytics/data.db` | +| Log files | `agent-session-analytics.log`, `agent-session-analytics.err` | +| LaunchAgent | `com.evansenter.agent-session-analytics.plist` | +| systemd service | `agent-session-analytics.service` | + +**Environment variables**: `AGENT_SESSION_ANALYTICS_*` prefix (e.g., `_DB`, `_URL`, `_AUTH_DISABLED`) + +--- + ## ⚠️ DATABASE PROTECTION **The database at `~/.claude/contrib/agent-session-analytics/data.db` contains irreplaceable historical data.**