Backport PR #3473 to release/v1.7 for Add AGENTS.md for AI Co-Worker standardization

[vdaas-ci]

Add AGENTS.md for AI Co-Worker standardization

• Unify AGENTS.md and GEMINI.md concepts into a single comprehensive guide.
• Define "Senior Cloud-Native Distributed Systems Engineer" persona.
• Establish "Plan -> Execute -> Show -> Propose" working style.
• Set strict zero-diff policies and mandatory Makefile workflows.
• Detail MCP tooling and routing rules.
• Document critical architecture context (NGT, gRPC, K8s).
• Provide explicit "Recommended Local Development Workflow" including k3d, helm, and e2e/v2 targets.
• Outline gRPC error handling and streaming patterns.

---

PR created automatically by Jules for task 9898591043237542042 started by @kpango

Summary by CodeRabbit

• Documentation
  • Added a comprehensive agents development guide covering guidelines, patterns, workflows and repo mapping.
• Chores
  • Updated tool/runtime version references across templates and dependency manifests.
  • CI/workflow actions and scanning step references updated.
  • Normalized several Kubernetes/CRD JSON serialization tags to ensure fields are always present.
• Style
  • Various formatting and build-script tidy-ups with no functional impact.
• Tests
  • Widespread test scaffolding and iteration updates for consistency.

[cloudflare-workers-and-pages]

Deploying vald with    Cloudflare Pages

Latest commit:	e5df117
Status:	✅  Deploy successful!
Preview URL:	https://57a63f2c.vald.pages.dev
Branch Preview URL:	https://backport-release-v1-7-doc-ad.vald.pages.dev

View logs

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)

• main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: c10927f8-cf10-4658-99fa-149d7143e444

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch backport/release/v1.7/doc/add-agents-md-9898591043237542042

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[vdaas-ci]

[WARNING:INTCFG] Changes in internal/config may require you to change Helm charts. Please check.

[vdaas-ci]

[CHATOPS:HELP] ChatOps commands.

• 🙆‍♀️ /approve - approve
• 🍱 /format - format codes and add licenses
• ✅ /gen-test - generate test codes
• 🏷️ /label - add labels
• 🔚 2️⃣ 🔚 /label actions/e2e-deploy - run E2E deploy & integration test

[codecov]

Codecov Report

❌ Patch coverage is 5.71429% with 66 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (release/v1.7@8452ad1). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
hack/benchmark/internal/operation/search.go	0.00%	16 Missing ⚠️
internal/circuitbreaker/breaker.go	0.00%	10 Missing ⚠️
hack/benchmark/internal/operation/insert.go	0.00%	8 Missing ⚠️
hack/benchmark/internal/operation/remove.go	0.00%	8 Missing ⚠️
hack/benchmark/internal/assets/hdf5_loader.go	0.00%	4 Missing ⚠️
hack/helm/schema/crd/main.go	0.00%	4 Missing ⚠️
hack/benchmark/core/benchmark/strategy/util.go	0.00%	3 Missing ⚠️
...k/benchmark/core/benchmark/strategy/bulk_insert.go	0.00%	2 Missing ⚠️
...mark/core/benchmark/strategy/bulk_insert_commit.go	0.00%	2 Missing ⚠️
hack/benchmark/core/benchmark/strategy/strategy.go	0.00%	2 Missing ⚠️
... and 7 more

Additional details and impacted files

@@               Coverage Diff               @@
##             release/v1.7    #3487   +/-   ##
===============================================
  Coverage                ?   25.85%           
===============================================
  Files                   ?      500           
  Lines                   ?    42392           
  Branches                ?        0           
===============================================
  Hits                    ?    10962           
  Misses                  ?    30700           
  Partials                ?      730           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Matts966]

/format

[vdaas-ci]

[FORMAT] Updating license headers and formatting go codes triggered by Matts966.

[github-actions]

[file name cspell] _{reported by reviewdog 🐶}
Unknown word (textwrap) Suggestions: [textural, textuary, tetra, tetrad, tetras]

[Matts966]

NGT errors can be resolved by the next PR.