chore: remove serena leftovers (hooks, permissions, docs, templates)#8518
Merged
Conversation
Serena MCP was removed from the project, but config and docs still referenced it — the SessionStart hook failed every session with "serena-hooks: not found". - .claude/settings.json: drop serena-hooks hooks (PreToolUse, SessionStart, Stop) and the mcp__serena__* permission - .serena/: delete tracked project files and memories - CLAUDE.md: drop the Serena tool section, keep Context7 - agentic/commands/: replace serena tool references with built-in Glob/Grep/Read/Edit equivalents in the audit/prime/agentic templates Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR finishes removing the previously-deleted Serena MCP integration by deleting the remaining Serena project artifacts and updating Claude/agentic command documentation to rely on built-in navigation/editing tools instead of mcp__serena__* and serena-hooks.
Changes:
- Removed Serena hook/permission configuration from
.claude/settings.jsonto stop Claude Code session startup failures. - Deleted tracked
.serena/project files and memories. - Updated CLAUDE + agentic audit/prime command docs to replace Serena tool references with Glob/Grep/Read/Edit guidance.
Reviewed changes
Copilot reviewed 25 out of 25 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
.claude/settings.json |
Removes mcp__serena__* allowlist entry and all serena-hooks startup/tool hooks. |
CLAUDE.md |
Drops Serena MCP tool documentation; keeps Context7 guidance only. |
agentic/commands/prime.md |
Replaces Serena activation/tooling section with built-in tool guidance. |
agentic/commands/prime-deep.md |
Replaces Serena tool catalog with built-in tool guidance. |
agentic/commands/audit/security-auditor.md |
Rewrites Serena/list_dir references into Glob/Grep/Read equivalents. |
agentic/commands/audit/quality-auditor.md |
Rewrites Serena/list_dir/search_for_pattern guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/observability-auditor.md |
Rewrites Serena/list_dir/find_symbol guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/llm-pipeline-auditor.md |
Rewrites Serena/list_dir/find_symbol guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/infra-auditor.md |
Rewrites list_dir/find_file/search_for_pattern guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/frontend-auditor.md |
Rewrites list_dir/get_symbols_overview/search_for_pattern guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/design-auditor.md |
Rewrites list_dir/get_symbols_overview guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/db-auditor.md |
Rewrites list_dir/get_symbols_overview/find_referencing_symbols guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/catalog-auditor.md |
Rewrites list_dir references into Glob guidance. |
agentic/commands/audit/backend-auditor.md |
Rewrites Serena/list_dir/find_symbol guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/agentic-auditor.md |
Rewrites list_dir/get_symbols_overview guidance into Glob/Grep/Read equivalents. |
agentic/commands/audit/audit.workflow.js |
Removes “Serena” mention from the cross-validation prompt instructions. |
agentic/commands/audit.md |
Updates orchestrator guidance to remove Serena tool assumptions and references. |
agentic/commands/agentic.md |
Updates audit-team guidance to remove Serena tool assumptions and references. |
.serena/project.yml |
Deletes the Serena project configuration file. |
.serena/memories/task_completion.md |
Deletes Serena memory file (task completion checklist). |
.serena/memories/style_guide.md |
Deletes Serena memory file (design system notes). |
.serena/memories/project_overview.md |
Deletes Serena memory file (repo overview). |
.serena/memories/commands.md |
Deletes Serena memory file (commands reference). |
.serena/memories/code_style.md |
Deletes Serena memory file (code style/conventions). |
.serena/.gitignore |
Deletes Serena-local ignore file. |
Comment on lines
10
to
12
| "mcp__plugin_playwright_playwright__*", | ||
| "mcp__serena__*", | ||
| "Bash(git commit *)", | ||
| "Bash(git push *)" |
Contributor
There was a problem hiding this comment.
Implemented in 502401e by removing the redundant Bash(git commit *) and Bash(git push *) entries while keeping the existing "Bash" permission.
Comment on lines
20
to
23
| @agentic/docs/project-guide.md | ||
| @agentic/commands/context.md | ||
| @docs/concepts/vision.md | ||
| @pyproject.toml |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Serena MCP was removed from the project, but config and docs still referenced it. The most visible symptom: every Claude Code session failed on startup with
This completes the removal:
.claude/settings.json: drop allserena-hookshooks (PreToolUse remind/auto-approve, SessionStart activate, Stop cleanup) and themcp__serena__*permission entry.serena/: delete the tracked project files and memories (were already deleted locally, now committed)CLAUDE.md: remove the Serena tool section; Context7 guidance keptagentic/commands/: replace Serena tool references (mcp__serena__*,list_dir,find_file,search_for_pattern,think_about_collected_information) with built-in Glob/Grep/Read/Edit equivalents across the audit auditors,audit.md,agentic.md,prime.md,prime-deep.md, andaudit.workflow.jsHistorical artifacts (
agentic/runs/,agentic/audits/,agentic/specs/) intentionally untouched.Verification
grep -rni serenaover the repo (excluding historical artifacts) returns zero hits.claude/settings.local.jsonwas cleaned separately (not part of this PR)🤖 Generated with Claude Code