docs: add comprehensive AGENTS.md documentation (hetzner) #3715
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
nogueiraanderson
force-pushed
the
feat/agents-md-hetzner
branch
from
b75e652 to
180cab8
Compare
- Add ppg/AGENTS.md: PostgreSQL with ARM64 support (138+ files, 27 ARM jobs) - Add pdmdb/AGENTS.md: Distribution MongoDB testing - Add pdps/AGENTS.md: Distribution Percona Server with Perl DBD-MySQL - Add pdpxc/AGENTS.md: Distribution XtraDB Cluster with operator integration - Add proxysql/AGENTS.md: ProxySQL 2.x + 3.x support - Add percona-telemetry-agent/AGENTS.md: Telemetry agent packaging - Add prel/AGENTS.md: Percona Release tool pipelines - Add pcsm/AGENTS.md: Cloud Service Manager with ARM64 Docker support - Add pmm/v3/AGENTS.md: PMM v3 (no EKS/OpenShift, legacy AWS staging) - Add pmm/AGENTS.md: PMM pipelines (no OpenShift in hetzner) - Add IaC/AGENTS.md: Infrastructure with htz.cloud.groovy integration - Add root AGENTS.md: Hetzner branch navigation and dual-cloud setup Follows 2025 AGENTS.md best practices with Hetzner-specific: - ARM64 architecture support (ppg, pcsm) - Dual cloud provider (Hetzner + AWS) - Conditional agent labels based on CLOUD parameter - No EKS/OpenShift (removed for Hetzner optimization) - 10 htz.cloud.groovy integration files All files enriched with git history and validation commands.
nogueiraanderson
force-pushed
the
feat/agents-md-hetzner
branch
from
180cab8 to
26261dc
Compare
- Remove non-Hetzner AGENTS.md files (ps, pxc, pxb, pdmdb, pdps, pdpxc, proxysql, prel, percona-telemetry-agent, cloud) - these belong in master - Keep 9 Hetzner-specific AGENTS.md files with active development - Enrich pmm/, pmm/v3/, ppg/, psmdb/, pbm/ with job inventories - Add vars/AGENTS.md for shared library documentation - Update root AGENTS.md to reflect hetzner-only scope - Add Jenkins Instance Summary with job-to-file coverage stats Components documented in hetzner branch: - pmm/, pmm/v3/ - PMM without OpenShift/EKS - ppg/ - PostgreSQL with 27 ARM64 files - psmdb/, pbm/ - MongoDB with hetzner-* jobs - pcsm/ - Cloud Service Manager with ARM64 - vars/, IaC/ - Shared infrastructure
- Remove verbose Hetzner job inventory from root AGENTS.md - Add compact Jenkins CLI section with quick commands - Add curl API equivalents (URL-encoded brackets) - Add job patterns for each product directory - Reference root AGENTS.md for auth setup in subdirectories
Each AGENTS.md now has a dedicated # Jenkins section that groups: - Instance URL - CLI commands - API/curl commands - Job patterns - Credentials
PMM: - Update date to 2025-12 - Add pmm3-ha-eks-cleanup DISABLED alert - Add ROSA HA jobs documentation - Add Lambda cleanup function reference (LambdaOpenShiftCleanup) - Add feature-build and migration-tests - Note scripts missing from repo PSMDB: - Document Hetzner migration (hetzner-* job prefixes) - Active versions: 6.0, 7.0, 8.0 only - 209 total jobs (111 active, 60 disabled) - Job dependency graph with fan-in/fan-out metrics - Upstream triggers split by Active (Hetzner) vs Disabled (AWS) - Add Hetzner Migration section in Notes
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
# Jenkinssections~/bin/jenkins) and curl API equivalentsWhy
AGENTS.md is an emerging standard (20,000+ repos) that serves as "README for AI agents." It helps AI coding assistants understand project structure, patterns, and boundaries.
Changes
9 files updated: root, pmm, pmm/v3, psmdb, pbm, ppg, pcsm, IaC, vars
Each
# Jenkinssection includes: Instance/URL, CLI commands, API/curl, job patterns, credentials.