From d3d72e5f6c91af9a4a8f6447f544a80439b61cf7 Mon Sep 17 00:00:00 2001 From: Ben Date: Tue, 3 Mar 2026 11:26:12 +0100 Subject: [PATCH] chore: remove .claude submodule and investigations tool references The .claude submodule points to a private repo which breaks public clones. Removed it from git tracking and added .claude/ to .gitignore so OpenTrace developers can optionally clone it locally. Also removed the investigations tools row from the README since those tools are no longer exposed. Co-Authored-By: Claude Opus 4.6 --- .claude | 1 - .gitignore | 4 ++-- .gitmodules | 3 --- CLAUDE.md | 10 +--------- CONTRIBUTING.md | 12 +++--------- README.md | 1 - cspell.json | 2 -- 7 files changed, 6 insertions(+), 27 deletions(-) delete mode 160000 .claude delete mode 100644 .gitmodules diff --git a/.claude b/.claude deleted file mode 160000 index 733082f..0000000 --- a/.claude +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 733082f07959f18be9bb2d0a74913d5fdb72e251 diff --git a/.gitignore b/.gitignore index 6b12a20..2f01cd6 100644 --- a/.gitignore +++ b/.gitignore @@ -8,8 +8,8 @@ .DS_Store Thumbs.db -# Local settings -.claude/settings.local.json +# Local settings (clone opentrace/.claude here for shared agents/commands) +.claude/ # Environment files .env diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index 34cdaf7..0000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[submodule ".claude"] - path = .claude - url = git@github.com:opentrace/.claude.git diff --git a/CLAUDE.md b/CLAUDE.md index 2a43cf2..1cac77c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,18 +8,12 @@ This is the **OpenTrace Claude Code Plugin** — a Claude Code plugin that conne ## Architecture -The repository has two layers: - -1. **Plugin layer** (this repo) — Contains the plugin manifest, MCP server configuration, and plugin-specific hooks. This is what gets installed via `claude plugin install`. -2. **Shared `.claude` submodule** — A git submodule (`opentrace/.claude`) containing shared agents, commands, hooks, and settings used across OpenTrace projects. Changes to shared settings must be submitted to the [.claude repository](https://github.com/opentrace/.claude) separately. - ### Key Files - `.claude-plugin/plugin.json` — Plugin manifest: name, version, MCP server references, and hook definitions - `.claude-plugin/marketplace.json` — Marketplace metadata for plugin discovery - `mcp-servers/opentrace.json` — MCP server configuration pointing to `https://api.opentrace.ai/mcp/v1` - `hooks/` — Plugin hooks (see below) -- `.claude/` — Git submodule with shared agents, commands, and settings (do not edit directly in this repo) ### Plugin Hooks @@ -57,14 +51,12 @@ The standard development cycle is: edit files → `make dev` → restart Claude ### First-Time Setup ```bash -git clone --recurse-submodules git@github.com:opentrace/claude-code.git +git clone git@github.com:opentrace/claude-code.git cd claude-code make marketplace-add make install ``` -If cloned without submodules: `git submodule update --init --recursive` - ### Testing Changes There is no automated test suite. Testing is manual: diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 50b8a7f..5a37d91 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,14 +2,9 @@ ## Local Development Setup -1. **Clone the repository** (with submodules): +1. **Clone the repository**: ```bash - git clone --recurse-submodules git@github.com:opentrace/claude-code.git - ``` - - If you already cloned without submodules: - ```bash - git submodule update --init --recursive + git clone git@github.com:opentrace/claude-code.git ``` 2. **Add the local repository as a marketplace**: @@ -34,7 +29,6 @@ claude plugin install opentrace ## Project Structure ``` -.claude/ # Shared Claude Code settings (git submodule) hooks/ session-start # Hook that runs when a Claude Code session starts mcp-servers/ @@ -47,7 +41,7 @@ CONTRIBUTING.md - **Hooks** live in `hooks/`. Changes are picked up on the next Claude Code session. - **MCP server config** lives in `mcp-servers/opentrace.json`. Restart Claude Code after changes. -- **Shared settings** are in the `.claude` submodule. If you need to modify shared settings, submit changes to the [.claude repository](https://github.com/opentrace/.claude) separately. +- **Shared settings** (optional): OpenTrace developers can clone [opentrace/.claude](https://github.com/opentrace/.claude) into `.claude/` for shared agents and commands. This directory is gitignored. ## Submitting Changes diff --git a/README.md b/README.md index e7aef2d..2ea8667 100644 --- a/README.md +++ b/README.md @@ -62,7 +62,6 @@ Identifies all dependent components and highlights critical paths. | **Discovery** | `search_nodes`, `query_nodes`, `get_node`, `find_similar_nodes` | | **Traversal** | `traverse_dependencies`, `traverse_incoming`, `traverse_outgoing`, `get_neighbors` | | **Analysis** | `find_path`, `get_node_statistics` | -| **Investigations** | `list_investigations`, `get_investigation` | | **Source** | `load_source` (GitHub/GitLab integration) | **Analysis Prompts**: `discover_architecture`, `impact_analysis`, `dependency_analysis` diff --git a/cspell.json b/cspell.json index 00ecf2a..9cd6098 100644 --- a/cspell.json +++ b/cspell.json @@ -11,8 +11,6 @@ "words": [ "opentrace", "codebase", - "submodule", - "submodules", "guardrail", "guardrails", "hookSpecificOutput",