Google GitGoogle Git
Sign in
apache/fory/refs/heads/main/./.agents
tree: 5492270cf97a8d51de14fdad488354a2ac0d2226
  1. languages/
  2. skills/
  3. testing/
  4. ci-and-pr.md
  5. docs-and-formatting.md
  6. README.md
  7. repo-reference.md
.agents/README.md

Agent Reference Index

Load AGENTS.md first. Do not load every file under .agents/ by default; read only the files that match the task.

Shared References

  • repo-reference.md: repo layout, protocol overview, compiler notes, and runtime map.
  • docs-and-formatting.md: docs, specs, markdown formatting, publishing notes, and generated-artifact rules.
  • ci-and-pr.md: code review workflow, review red flags, validation guidance, GitHub Actions triage, PR expectations, and commit message format.
  • testing/integration-tests.md: integration_tests/ prerequisites, regeneration rules, and commands.

Runtime References

  • languages/java.md: Java runtime rules, module map, Maven commands, and Java-specific debugging.
  • languages/csharp.md: C# rules, dotnet commands, and Java-driven C# xlang validation.
  • languages/cpp.md: C++ rules, Bazel/arch constraints, core layout, and debugging/profile pointers.
  • languages/python.md: Python/Cython modes, Bazel build variants, tests, and debugging workflow.
  • languages/go.md: Go rules, go test workflow, and panic/debug guidance.
  • languages/rust.md: Rust rules, cargo workflow, and debug/backtrace guidance.
  • languages/swift.md: Swift rules, lint/test workflow, and Java-driven xlang validation.
  • languages/javascript.md: JavaScript/TypeScript commands and package-manager expectations.
  • languages/dart.md: Dart codegen, test, and analysis commands.
  • languages/kotlin.md: Kotlin build/test commands, generated Kotlin source rules, and dependency on installed Java artifacts.
  • languages/scala.md: Scala build/test/format commands and dependency on installed Java artifacts.

Common Loading Recipes

  • Java or JVM runtime work:
    • AGENTS.md
    • languages/java.md
    • repo-reference.md
  • Cross-language protocol or xlang work:
    • AGENTS.md
    • docs-and-formatting.md
    • testing/integration-tests.md
    • every touched runtime file under languages/
  • Compiler/codegen work that emits runtime-specific source:
    • AGENTS.md
    • repo-reference.md
    • relevant runtime file under languages/
  • Performance work:
    • AGENTS.md
    • relevant runtime file under languages/
    • docs-and-formatting.md
    • skill-specific references if using a performance skill
  • Apache Fory PR, branch, commit-range, local-diff code review, or CI triage:
    • AGENTS.md
    • ci-and-pr.md
    • relevant runtime file under languages/
  • Independent general reviewer required by AI_POLICY.md:
    • Follow the AGENTS.md independent-review carve-out if tooling auto-loads AGENTS.md.
    • Do not load ci-and-pr.md or use copied Fory-specific review checklist prompts.

Canonicality

  • Treat the files in this directory as the canonical agent-specific guidance.
  • Review workflow, review red flags, and PR preparation rules belong in ci-and-pr.md; runtime-specific details belong in languages/, and cross-language validation details belong in testing/.