docs: add AGENTS.md guide for GLQL development

Dmitry Gruzdrequested to merge
docs/add-agents-md into main

Summary

  • Add comprehensive guide for engineers and AI agents working with GLQL
  • Covers architecture, adding new data sources, key concepts, and common patterns
  • Focused on Rust implementation with practical examples

What does this MR do and why?

This MR adds AGENTS.md to help both human engineers and AI agents understand the GLQL architecture and how to extend it with new data sources. The guide provides:

  • Quick start commands for building, testing, and linting
  • Architecture overview of the compiler pipeline
  • Step-by-step guide for adding new queryable entities
  • Key concepts like field types, operators, and field mappings
  • Common patterns for feature flags, error handling, and subqueries
  • Code style guidelines

This is part of improving GLQL developer experience and making it easier for contributors to understand how to add new functionality.

Related issues

Checklist

  • Documentation added for new features
  • Follows project code style guidelines
Edited by Dmitry Gruzd

Merge request reports