jdaugherty commented on code in PR #15568: URL: https://github.com/apache/grails-core/pull/15568#discussion_r3254725953
########## .agents/skills/codebase-memory/SKILL.md: ########## @@ -0,0 +1,104 @@ +--- +name: codebase-memory-setup +description: Helps the developer set up codebase-memory-mcp locally +license: Apache-2.0 +--- +<!-- +SPDX-License-Identifier: Apache-2.0 + +Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0. +--> + +--- +name: codebase-memory-setup +description: > +Verify and set up the codebase-memory MCP server for Grails-Core architectural navigation. +Use this skill at the start of any Grails-Core session to detect whether the MCP server is +active, prompt the user to install it if missing, and provide step-by-step configuration +instructions. Trigger whenever working with grails-core and MCP tool availability is unknown, +or when the user asks about faster codebase navigation, architectural mode, or MCP setup. +--- + +# Codebase Memory MCP: Environment Verification & Setup + +This skill governs how to verify, onboard, and configure the `codebase-memory` MCP server when +working in the Grails-Core repository. It enables "Architectural Mode" — a significantly faster +mode of codebase navigation using graph-based memory tools. + +--- + +## Step 1: Detect Operating Mode (Mandatory on Load) + +Before doing anything else, check your available tool definitions for the presence of any of +these tools: + +- `index_repository` +- `search_graph` +- `trace_call_path` +- `query_graph` + +| Condition | Mode | +|---|---| +| Tools **present** | **Architectural Mode** — proceed normally | +| Tools **absent** | **Standard Mode** — proceed to Step 2 | + +--- + +## Step 2: Proactive Onboarding (Standard Mode Only) + +If the MCP server is **not** detected, interrupt the current flow (unless addressing a critical +fix) and present the following message to the user: + +> "I've detected that this repository is optimized for **Codebase Memory MCP**, which allows me +> to navigate the Grails-Core architecture 90% faster. However, the server is not currently +> running in your environment. Would you like me to help you install it now?" + +Wait for the user's response before continuing. + +--- + +## Step 3: Installation (If User Approves) + +The package ships as a **static binary** (not npm). Use the appropriate one-liner for the user's +platform, or run it yourself if you have shell access. + +**macOS / Linux (bash):** + +```bash +curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash Review Comment: @borinquenkid it's possible to setup code base memory out side of a project. I'd like to remove this and suggest we do that for this skill if it's needed. You can also setup global skills. Installing third party binaries on a machine is an avenue of security compromise, so this way we keep people who checkout this project safe. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
