docs: fix dev compose filename and add working directory notes for OTel commands

Author: bitflicker64

AGENTS.md

@@ -231,7 +231,7 @@ For distributed development:
 3. Build Store: `mvn clean package -pl hugegraph-store -am -DskipTests`
 4. Build Server with HStore backend: `mvn clean package -pl hugegraph-server -am -DskipTests`
 
-See Docker Compose examples: `docker/` directory. Single-node quickstart (pre-built images): `docker/docker-compose.yml`. Single-node dev build (from source): `docker/docker-compose-dev.yml`. 3-node cluster: `docker/docker-compose-3pd-3store-3server.yml`. See `docker/README.md` for full setup guide.
+See Docker Compose examples: `docker/` directory. Single-node quickstart (pre-built images): `docker/docker-compose.yml`. Single-node dev build (from source): `docker/docker-compose.dev.yml`. 3-node cluster: `docker/docker-compose-3pd-3store-3server.yml`. See `docker/README.md` for full setup guide.
 
 ### Debugging Tips
 

docker/README.md

@@ -5,7 +5,7 @@ This directory contains Docker Compose files for running HugeGraph:
 | File | Description |
 |------|-------------|
 | `docker-compose.yml` | Single-node cluster using pre-built images from Docker Hub |
-| `docker-compose-dev.yml` | Single-node cluster built from source (for developers) |
+| `docker-compose.dev.yml` | Single-node cluster built from source (for developers) |
 | `docker-compose-3pd-3store-3server.yml` | 3-node distributed cluster (PD + Store + Server) |
 
 ## Prerequisites
@@ -48,7 +48,7 @@ Builds images locally from source Dockerfiles. Best for **developers** who want
 
 ```bash
 cd docker
-docker compose -f docker-compose-dev.yml up -d
+docker compose -f docker-compose.dev.yml up -d
 ```
 
 - Images: built from source via `build: context: ..` with Dockerfiles
@@ -59,7 +59,7 @@ docker compose -f docker-compose-dev.yml up -d
 
 ### Key Differences
 
-| | `docker-compose.yml` (quickstart) | `docker-compose-dev.yml` (dev build) |
+| | `docker-compose.yml` (quickstart) | `docker-compose.dev.yml` (dev build) |
 |---|---|---|
 | **Images** | Pull from Docker Hub | Build from source |
 | **Who it's for** | End users | Developers |

hugegraph-server/hugegraph-dist/docker/README.md

@@ -92,6 +92,7 @@ If you want to customize the preloaded data, please mount the groovy scripts (no
 1. Start Open-Telemetry-Collector
 
     ```bash
+    # Run from the repository root
     docker compose -f hugegraph-server/hugegraph-dist/docker/example/docker-compose-trace.yaml -p hugegraph-trace up -d
     ```
 
@@ -104,6 +105,7 @@ If you want to customize the preloaded data, please mount the groovy scripts (no
 3. Stop Open-Telemetry-Collector
 
     ```bash
+    # Run from the repository root
     docker compose -f hugegraph-server/hugegraph-dist/docker/example/docker-compose-trace.yaml -p hugegraph-trace stop
     ```
 

hugegraph-store/AGENTS.md

@@ -129,7 +129,7 @@ bin/restart-hugegraph-store.sh
 2. HugeGraph Store cluster (3+ nodes)
 3. Proper configuration pointing Store nodes to PD cluster
 
-See Docker Compose examples in the repository root `../docker/` directory. Single-node quickstart (pre-built images): `../docker/docker-compose.yml`. Single-node dev build (from source): `../docker/docker-compose-dev.yml`. 3-node cluster: `../docker/docker-compose-3pd-3store-3server.yml`. See `../docker/README.md` for the full setup guide.
+See Docker Compose examples in the repository root `../docker/` directory. Single-node quickstart (pre-built images): `../docker/docker-compose.yml`. Single-node dev build (from source): `../docker/docker-compose.dev.yml`. 3-node cluster: `../docker/docker-compose-3pd-3store-3server.yml`. See `../docker/README.md` for the full setup guide.
 
 ## Configuration Files