docs: address review feedback (clarify entry point, NumPy focus, path resolution)

Author: napetrov

.github/copilot-instructions.md

@@ -3,14 +3,18 @@
 ## Source of truth
 This file is canonical for Copilot behavior in this repository.
 
-`AGENTS.md` files provide directory scope/guardrails for AGENTS-aware tools and should not duplicate Copilot policy text.
+For project context and directory routing, read root `AGENTS.md` first.
+
+`AGENTS.md` files provide directory scope/guardrails and should not duplicate Copilot policy text.
 
 ## Mandatory flow
-Read root `AGENTS.md`, then nearest local `AGENTS.md` for edited files; most specific wins.
+1. Read root `AGENTS.md`.
+2. Read nearest local `AGENTS.md` for edited files.
+3. Most specific AGENTS wins when multiple apply.
 
 ## Contribution expectations
 - Keep diffs minimal and scoped to the task.
-- Preserve API behavior by default.
+- Preserve NumPy-compatible API behavior by default.
 - For behavior/API changes: update tests, and docs/examples when user-visible.
 - For bug fixes: prefer adding regression coverage.
 
@@ -19,6 +23,7 @@ Read root `AGENTS.md`, then nearest local `AGENTS.md` for edited files; most spe
 - Do not invent or hardcode versions, flags, or matrix values.
 
 ## Source-of-truth files
+All paths relative to project root:
 - Build/config: `CMakeLists.txt`, `pyproject.toml`, `setup.py`, `setup.cfg`
 - CI/checks: `.github/workflows/`
 - Style/lint: `.pre-commit-config.yaml`, `.clang-format`, `.flake8`

.github/instructions/build.instructions.md

@@ -4,6 +4,8 @@ applyTo: "{CMakeLists.txt,pyproject.toml,setup.py,setup.cfg,**/CMakeLists.txt}"
 
 # Build Instructions for GitHub Copilot
 
+All paths below are relative to project root.
+
 - Reuse existing build/config patterns.
 - Keep mutable build details in source-of-truth files.
 - Avoid introducing parallel build paths unless requested.

AGENTS.md

@@ -1,22 +1,23 @@
 # AGENTS.md
 
-This file is for AGENTS-aware tools.
+Entry point for agent context in this repo.
 
 ## What this repository is
 `dpnp` is the Data Parallel Extension for NumPy: a NumPy-compatible Python API with accelerated execution backends and cross-platform packaging/CI.
 
 ## How to work in this repo
 - Keep changes small and single-purpose (bug fix, perf, docs, or infra).
-- Preserve API behavior by default; call out intentional behavior changes in PR text.
+- Preserve NumPy-compatible API behavior by default; call out intentional behavior changes in PR text.
 - Pair user-visible changes with tests and docs/examples updates.
 - Avoid duplicating mutable details (versions/flags/matrix) in instruction docs.
 
 For Copilot behavior policy (flow, source-of-truth, edit hygiene), see:
 - `.github/copilot-instructions.md` (canonical for Copilot behavior)
 
 ## Directory map
+Below directories have local `AGENTS.md` for deeper context:
 - `.github/AGENTS.md` — CI/workflow/automation context
-- `dpnp/AGENTS.md` — core implementation behavior guardrails
+- `dpnp/AGENTS.md` — core NumPy-compatible implementation guardrails
 - `doc/AGENTS.md` — documentation updates and consistency
 - `examples/AGENTS.md` — runnable user-facing examples
 - `benchmarks/AGENTS.md` — reproducible performance evaluation

dpnp/AGENTS.md

@@ -1,7 +1,7 @@
 # AGENTS.md — dpnp/
 
-Core package implementation and Python/Cython-facing behavior.
+Core NumPy-compatible package implementation and Python/Cython-facing behavior.
 
-- Preserve API behavior and compatibility by default.
+- Preserve NumPy API compatibility by default.
 - Keep dtype/shape/error behavior explicit.
 - For test policy, follow `.github/instructions/testing.instructions.md`.