Skip to content

docs: add AGENTS.md for AI contributors#989

Open
wustwyh wants to merge 1 commit into
GoogleCloudPlatform:mainfrom
wustwyh:docs/add-agents-md
Open

docs: add AGENTS.md for AI contributors#989
wustwyh wants to merge 1 commit into
GoogleCloudPlatform:mainfrom
wustwyh:docs/add-agents-md

Conversation

@wustwyh

@wustwyh wustwyh commented Jun 26, 2026

Copy link
Copy Markdown

Summary

Adds an AGENTS.md file to help AI coding agents (and human contributors) quickly understand the project layout, build/test commands, template development workflow, and contribution conventions.

The repository currently has README.md, CONTRIBUTING.md, and GEMINI.md, but lacks a concise AI-focused onboarding file. AGENTS.md fills that gap by summarizing the commands and patterns an agent needs before making changes.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation only
  • Refactor / internal cleanup

Test Plan

  • Verified the file renders correctly as Markdown.
  • Confirmed all referenced commands (make install, make lint, make test, _TEST_AGENT_COMBINATION=... make lint-templated-agents) exist in the repository's Makefile and CONTRIBUTING.md.
  • No code changes, so no functional tests required.

Related Issues

None.

Notes for Reviewers

This is a documentation-only addition. It does not modify any templates, CLI code, or tests.

Add an AGENTS.md quick-reference covering project layout,
development commands, template workflow, code style, and
agent-specific contribution tips.
@google-cla

google-cla Bot commented Jun 26, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces AGENTS.md, a quick-reference guide for AI and human contributors to the Agent Starter Pack. The feedback suggests correcting the path to the Go templates to use the full repository path agent_starter_pack/base_templates/go/ instead of the relative one to avoid confusion.

Comment thread AGENTS.md
## Code Style

- Python: `ruff` (line length 88, target `py311`), `ty` type checker, `codespell`.
- Go templates: follow the conventions in `base_templates/go/`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The path to the Go templates is agent_starter_pack/base_templates/go/ rather than base_templates/go/. Let's update this to use the full path from the repository root to avoid confusion for contributors and AI agents.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant