Improved agent skills definitions.

Co-authored-by: Cole Greer <112986082+Cole-Greer@users.noreply.github.com>

Author: spmallette

.skills/tinkerpop-dev/references/build-dotnet.md

@@ -61,7 +61,7 @@ Run from the repository root.
 
 Build and test (requires Docker):
 ```bash
-mvn clean install -pl gremlin-dotnet,gremlin-dotnet-source,gremlin-dotnet-tests
+mvn clean install -pl :gremlin-dotnet,:gremlin-dotnet-source,:gremlin-dotnet-tests
 ```
 
 The test execution uses Docker Compose to:

.skills/tinkerpop-dev/references/build-go.md

@@ -21,7 +21,7 @@ under the License.
 
 ## Requirements
 
-- **Go 1.22+** — optional for local development; Docker handles test execution via Maven.
+- **Go 1.25+** — optional for local development; Docker handles test execution via Maven.
 - **Docker and Docker Compose** — required for running tests through Maven.
 - **Maven** — preferred build orchestration.
 
@@ -56,7 +56,7 @@ Run from the repository root.
 
 Build and test (requires Docker):
 ```bash
-mvn clean install -Pglv-go -pl gremlin-go
+mvn clean install -Pglv-go -pl :gremlin-go
 ```
 
 The Maven build uses Docker Compose to:

.skills/tinkerpop-dev/references/build-java.md

@@ -28,14 +28,14 @@ mvn clean install -pl <module-name>
 
 Examples:
 ```bash
-mvn clean install -pl tinkergraph-gremlin
-mvn clean install -pl gremlin-core
-mvn clean install -pl gremlin-server
+mvn clean install -pl :tinkergraph-gremlin
+mvn clean install -pl :gremlin-core
+mvn clean install -pl :gremlin-server
 ```
 
 Build a module and its dependencies:
 ```bash
-mvn clean install -pl gremlin-server -am
+mvn clean install -pl :gremlin-server -am
 ```
 
 ## Gremlin Server
@@ -47,7 +47,7 @@ mvn clean install -pl :gremlin-server -am -DskipTests
 
 Run gremlin-server integration tests:
 ```bash
-mvn clean install -pl gremlin-server -DskipIntegrationTests=false
+mvn clean install -pl :gremlin-server -DskipIntegrationTests=false
 ```
 
 Start Gremlin Server with Docker using the standard test configuration:
@@ -74,7 +74,7 @@ mvn clean install -DtestIteratorLeaks=false
 
 Specify a test seed for reproducible `Random` behavior:
 ```bash
-mvn clean install -DtestSeed
+mvn clean install -DtestSeed=<seed-value>
 ```
 When a test fails, the seed is printed in build output (look for "TestHelper" logger).
 Re-run with the same seed to reproduce.
@@ -94,7 +94,7 @@ mvn -Dmaven.javadoc.skip=true --projects tinkergraph-gremlin test
 
 Build Docker images of Gremlin Server and Console:
 ```bash
-mvn clean install -pl gremlin-server,gremlin-console -DdockerImages
+mvn clean install -pl :gremlin-server,:gremlin-console -DdockerImages
 ```
 
 Skip automatic Docker image build:

.skills/tinkerpop-dev/references/build-javascript.md

@@ -42,7 +42,7 @@ gremlin-js/
 
 ## Requirements
 
-- **Node.js 20+** / **npm 10+** — optional; Maven downloads a local copy.
+- **Node.js 22+** / **npm 10+** — optional; Maven downloads a local copy.
 - **Docker and Docker Compose** — required for integration and feature tests.
 - **Maven** — preferred orchestration.
 
@@ -64,7 +64,7 @@ mvn clean install -pl :gremlint -DskipTests
 ```
 
 **`-DskipTests` behavior:**
-- Skips Docker-based integration and feature tests for `gremlin-javascript`
+- Skips Docker-based integration, unit, and feature tests for `gremlin-javascript`
 - Skips `npm run validate` (which includes `npm test`) for `gremlin-mcp`
 - Still runs `npm run build` and `npm run lint` for all modules
 
@@ -75,7 +75,7 @@ mvn clean install -pl :gremlin-javascript
 
 If building in isolation fails due to a missing parent:
 ```bash
-mvn clean install -pl gremlin-js -DskipTests
+mvn clean install -pl :gremlin-js -DskipTests
 ```
 
 ## npm Commands
@@ -121,7 +121,7 @@ rather than by relative path (`./node_modules/.bin/...`) because dependencies ar
 
 - **`package-lock.json`** — regenerated by `npm install` from `gremlin-js/`. Do not edit
   manually. After any `package.json` change in any child, run `npm install` from
-  `gremlin-js/` and commit the updated lockfile.
+  `gremlin-js/`.
 - **`gremlin-js/pom.xml`** — the `frontend-maven-plugin` block runs `npm ci` with
   `<inherited>false</inherited>` so it executes only once at this level. Removing or
   moving it will break partial `-pl` child builds.

.skills/tinkerpop-dev/references/dev-environment-setup.md

@@ -39,11 +39,11 @@ GLV builds and many integration tests will be skipped.
 - **Docker and Docker Compose** — required for all GLV test execution. Docker Desktop includes
   both. GLV tests run inside Docker containers, so local language runtimes are optional for
   test execution via Maven.
-- **Python 3.9+** — optional for local development; Docker handles test execution.
-- **Node.js 20+ / npm 10+** — optional; Maven downloads a local copy via `frontend-maven-plugin`.
+- **Python 3.10+** — optional for local development; Docker handles test execution.
+- **Node.js 22+ / npm 10+** — optional; Maven downloads a local copy via `frontend-maven-plugin`.
   Consider [nvm](https://github.com/nvm-sh/nvm) for version management.
 - **.NET SDK 8.0+** — optional; Docker handles test execution.
-- **Go 1.22+** — optional; Docker handles test execution.
+- **Go 1.25+** — optional; Docker handles test execution.
 
 ## Environment Verification
 
@@ -95,9 +95,9 @@ Once `.glv` files are in place, a standard `mvn clean install` will include thos
 The `.glv` files are gitignored.
 
 Alternatively, activate GLV builds explicitly with Maven profiles without `.glv` files:
-- Python: `mvn clean install -Pglv-python -pl gremlin-python`
-- .NET: `mvn clean install -pl gremlin-dotnet,gremlin-dotnet-source,gremlin-dotnet-tests`
-- Go: `mvn clean install -Pglv-go -pl gremlin-go`
+- Python: `mvn clean install -Pglv-python -pl :gremlin-python`
+- .NET: `mvn clean install -Pgremlin-dotnet -pl :gremlin-dotnet,:gremlin-dotnet-source,:gremlin-dotnet-tests`
+- Go: `mvn clean install -Pglv-go -pl :gremlin-go`
 
 ## Groovy / Ivy Configuration
 

.skills/tinkerpop-dev/references/documentation.md

@@ -43,87 +43,3 @@ Do not use Markdown in the main docs tree. Use AsciiDoc.
 1. Place new content in the appropriate book (reference, dev, recipes, etc.).
 2. Update the relevant `index.asciidoc` so the new content is included in the build.
 3. Follow existing patterns for section structure and formatting.
-
-## Generating Documentation
-
-Documentation generation requires:
-- Java 11 (specifically for doc generation)
-- Hadoop 3.3.x in pseudo-distributed mode
-- GNU versions of `grep`, `awk` (4.0.1+), `sed`, `findutils`, `diffutils`
-  (on macOS, install via Homebrew)
-- `zip` utility
-
-Generate documentation:
-```bash
-bin/process-docs.sh
-```
-Output goes to `target/docs/`.
-
-Dry run (don't evaluate code blocks):
-```bash
-bin/process-docs.sh --dryRun
-```
-
-Dry run for specific files:
-```bash
-bin/process-docs.sh --dryRun docs/src/reference/the-graph.asciidoc,docs/src/tutorial/getting-started,...
-```
-
-Full run for specific files only:
-```bash
-bin/process-docs.sh --fullRun docs/src/reference/the-graph.asciidoc,...
-```
-
-Process a single file:
-```bash
-docs/preprocessor/preprocess-file.sh \
-  $(pwd)/gremlin-console/target/apache-tinkerpop-gremlin-console-*-standalone \
-  "" "*" $(pwd)/docs/src/xyz.asciidoc
-```
-
-Documentation can also be generated with Docker:
-```bash
-docker/build.sh -d
-```
-
-## Website Generation
-
-Generate the website locally (no Hadoop or special infrastructure needed):
-```bash
-bin/generate-home.sh
-```
-Output goes to `target/site/home`.
-
-The `docs/gremlint` web app requires Node.js and npm to be installed locally for
-website generation and publishing.
-
-## JavaDoc / JSDoc
-
-Generate JavaDocs and JSDoc:
-```bash
-mvn process-resources -Djavadoc
-```
-- JavaDoc output: `target/site/apidocs/`
-- JSDoc output: `gremlin-js/gremlin-javascript/doc/`
-
-Use Java 11 for JavaDoc generation.
-
-## Publishing
-
-Deploy documentation:
-```bash
-bin/publish-docs.sh svn-username
-```
-
-Publish website:
-```bash
-bin/publish-home.sh <username>
-```
-
-## Common Issues
-
-- **"Error grabbing grapes"** during plugin installation: delete the problematic
-  dependency directories from both `~/.m2/` and `~/.groovy/grapes/`.
-- **Unexpected OLAP failures**: usually a jar conflict from modified Hadoop/Spark
-  dependencies. Check `DependencyGrabber` class and plugin loading paths.
-- **awk version**: version 4.0.1 is required.

.skills/tinkerpop-dev/scripts/check-env.sh

@@ -44,13 +44,15 @@ echo ""
 echo "Core prerequisites:"
 if command -v java &>/dev/null; then
     java_version=$(java -version 2>&1 | head -1 | sed 's/.*"\(.*\)".*/\1/' | cut -d. -f1)
-    if [[ "$java_version" -ge 11 ]]; then
-        ok "Java $java_version (11+ required)"
+    if [[ "$java_version" -eq 11 || "$java_version" -eq 17 ]]; then
+        ok "Java $java_version (11 or 17 required)"
+    elif [[ "$java_version" -gt 17 ]]; then
+        bad "Java $java_version found — only Java 11 or 17 are supported (use sdkman.io to switch)"
     else
-        bad "Java $java_version found — version 11 or 17 required"
+        bad "Java $java_version found — version 11 or 17 required (use sdkman.io to install)"
     fi
 else
-    bad "Java not found — install Java 11 or 17 (try sdkman.io)"
+    bad "Java not found — install Java 11 or 17 (use sdkman.io)"
 fi
 
 # --- Maven ---
@@ -87,15 +89,15 @@ echo "Optional (GLV development):"
 # --- Python ---
 if command -v python3 &>/dev/null; then
     py_version=$(python3 --version 2>&1 | grep -oE '[0-9]+\.[0-9]+')
-    ok "Python $py_version (3.9+ recommended for gremlin-python local dev)"
+    ok "Python $py_version (3.10+ recommended for gremlin-python local dev)"
 else
     skip "Python 3 not found — Docker handles test execution, but local dev needs it"
 fi
 
 # --- Node.js ---
 if command -v node &>/dev/null; then
     node_version=$(node --version 2>/dev/null | sed 's/v//')
-    ok "Node.js $node_version (20+ recommended for gremlin-js local dev)"
+    ok "Node.js $node_version (22+ recommended for gremlin-js local dev)"
 else
     skip "Node.js not found — Maven downloads a local copy automatically"
 fi
@@ -111,7 +113,7 @@ fi
 # --- Go ---
 if command -v go &>/dev/null; then
     go_version=$(go version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+(\.[0-9]+)?')
-    ok "Go $go_version (1.22+ recommended for gremlin-go local dev)"
+    ok "Go $go_version (1.25+ recommended for gremlin-go local dev)"
 else
     skip "Go not found — Docker handles test execution"
 fi

docs/src/dev/developer/development-environment.asciidoc

@@ -568,7 +568,7 @@ supported:
 A list of command line options is provided by `docker/build.sh --help`. The container will install,
 configure and start all required dependencies, such as Hadoop.
 
-By default, this script will run every module in the project. However, if you are planning on working on just  
+By default, this script will run every module in the project. However, if you are planning on working on just a 
 small set of the modules (e.g. the GLVs) then you can use the script options to reduce the modules included by
 specifically selecting which modules you want. This behavior is currently supported for the non-Java GLVs and
 gremlin-console. This option will include only the selected modules as well as gremlin-server, gremlin-test,

pom.xml

@@ -485,6 +485,12 @@ limitations under the License.
                         <exclude>**/.project</exclude>
                         <exclude>**/.settings/**</exclude>
                         <exclude>**/.idea/**</exclude>
+                         <exclude>**/.claude/**</exclude>
+                         <exclude>**/.codex/**</exclude>
+                         <exclude>**/.copilot/**</exclude>
+                         <exclude>**/.cursor/**</exclude>
+                         <exclude>**/.kiro/**</exclude>
+                         <exclude>**/.junie/**</exclude>
                         <exclude>.repository/**</exclude>
                         <exclude>**/target/**</exclude>
                         <exclude>data/*.txt</exclude>

source-release.xml

@@ -48,6 +48,14 @@
                      of these files will be present. So, it's safer to exclude them.
                 -->
 
+                <!-- AI coding agent directories -->
+                <exclude>**/.claude/**</exclude>
+                <exclude>**/.codex/**</exclude>
+                <exclude>**/.copilot/**</exclude>
+                <exclude>**/.cursor/**</exclude>
+                <exclude>**/.kiro/**</exclude>
+                <exclude>**/.junie/**</exclude>
+
                 <!-- IDEs -->
                 <exclude>%regex[(?!((?!${project.build.directory}/)[^/]+/)*src/)(.*/)?maven-eclipse\.xml]</exclude>
                 <exclude>%regex[(?!((?!${project.build.directory}/)[^/]+/)*src/)(.*/)?\.project]</exclude>
@@ -81,10 +89,6 @@
                 <exclude>docs/gremlint/package-lock.json</exclude>
                 <exclude>docs/gremlint/node_modules/**</exclude>
                 <exclude>docs/gremlint/build/**</exclude>
-                <exclude>gremlin-js/gremlint/node_modules/**</exclude>
-                <exclude>gremlin-js/gremlint/node/**</exclude>
-                <exclude>gremlin-js/node_modules/**</exclude>
-                <exclude>gremlin-js/node/**</exclude>
                 <exclude>gremlin-dotnet/.glv</exclude>
                 <exclude>gremlin-dotnet/gremlin-*/**</exclude>
                 <exclude>gremlin-dotnet/src/docfx/**</exclude>
@@ -106,6 +110,10 @@
                 <exclude>gremlin-python/src/main/python/.idea/**</exclude>
                 <exclude>gremlin-python/src/main/python/.eggs/**</exclude>
                 <exclude>gremlin-python/src/main/python/**/__pycache__/**</exclude>
+                <exclude>gremlin-js/gremlint/node_modules/**</exclude>
+                <exclude>gremlin-js/gremlint/node/**</exclude>
+                <exclude>gremlin-js/node_modules/**</exclude>
+                <exclude>gremlin-js/node/**</exclude>
                 <exclude>gremlin-js/gremlin-javascript/.glv</exclude>
                 <exclude>gremlin-js/gremlin-javascript/.idea/**</exclude>
                 <exclude>gremlin-js/gremlin-javascript/gremlin-*/**</exclude>
@@ -116,12 +124,12 @@
                 <exclude>gremlin-js/gremlin-javascript/.duel-cache/**</exclude>
                 <exclude>gremlin-js/gremlin-javascript/build/**</exclude>
                 <exclude>gremlin-js/gremlin-javascript/examples/node/node_modules/**</exclude>
-                <exclude>gremlin-go/.glv</exclude>
-                <exclude>gremlin-go/gremlin-*/**</exclude>
-                <exclude>gremlin-go/coverage.out</exclude>
                 <exclude>gremlin-js/gremlin-mcp/node_modules/**</exclude>
                 <exclude>gremlin-js/gremlin-mcp/node/**</exclude>
                 <exclude>gremlin-js/gremlin-mcp/dist/**</exclude>
+                <exclude>gremlin-go/.glv</exclude>
+                <exclude>gremlin-go/gremlin-*/**</exclude>
+                <exclude>gremlin-go/coverage.out</exclude>
             </excludes>
         </fileSet>
         <!-- license, readme, etc. calculated at build time -->