feat: Introduce AI agent rules and specialized skills

[willum070]

Summary

This PR standardizes the repository for autonomous agent assistance by establishing a centralized knowledge base and tooling suite in the new .agents/ directory. By embedding these guidelines directly into the repository, any AI assistant or future contributor will automatically discover and adhere to our established patterns, severely reducing CI pipeline failures and review cycles.

Key Additions

1. Agent Rules (.agents/rules/)
Contains strict, file-level triggered guidelines detailing how samples must be written and modernized. Key rules include:

• CI Pipeline Alignment: Explicit instructions ensuring agents pass build-single.sh checks (e.g., enforcing void init(), using // prettier-ignore inside script tags, and avoiding direct global google.maps namespace access).
• Security & Quality: Enforcing modern Promise-based architectures (via Promise.all and importLibrary), proper DOM clearing techniques (using replaceChildren() instead of innerHTML), and secure text rendering.
• Dynamic Key Injection: Standardizing the GOOGLE_MAPS_API_KEY placeholder across all sample code to ensure CI scripts run successfully.
• Modern Architecture: Establishing standards for <gmp-map>, <gmp-map-3d>, React patterns, and advanced Maps APIs.

2. Agent Skills (.agents/skills/)
Packages specialized SOPs that can be invoked to automate complex repository tasks.

• code-review: Guidelines for agentic code reviews specifically geared toward js-api-samples.
• migration: Runbooks and checklists for transitioning legacy samples to the js-api-samples standards.
• refactor: Focused patterns for migrating standard 2D samples from programmatic div instantiation to declarative Web Components.
• refactor-3d: Specialized standards for migrating Maps 3D samples to be TypeScript-centric.

Impact

These rules act as the "source of truth" for code generation. When developers use agentic AI to create or refactor samples moving forward, the agent will seamlessly inject the correct bootstrapping code, adhere to our linting strictness, and correctly implement our Web Component patterns without requiring human correction.

[snippet-bot]

Here is the summary of changes.

You are about to add 7 region tags.

• .agents/rules/migration_standards.md:22, tag maps_map_simple
• .agents/rules/migration_standards.md:344, tag maps_sample_name
• .agents/skills/migration/SKILL.md:44, tag maps_polyline_simple
• .agents/skills/migration/SKILL.md:51, tag maps_polyline_simple
• .agents/skills/migration/SKILL.md:58, tag maps_polyline_simple
• .agents/skills/migration/SKILL.md:185, tag maps_rectangle_event
• .agents/skills/migration/SKILL.md:200, tag maps_rectangle_event

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment