---
name: addressing-agent-comments
description: Finds AGENT comments in code, gathers feedback, and carries out requested changes. Use when scanning a repo for inline agent notes, decision requests, or tooling tags.
metadata:
  source: https://github.com/ampcode/amp-contrib
---

Search for inline `AGENT:` comments, read the surrounding code, and follow through on the request.

## When to use

- You need to collect and resolve inline agent notes or change requests
- A repo uses a tag like AGENT: to point at work items
- You are asked to scan for inline feedback embedded in code

## Search process

1. Identify the instruction tag for the repo. Default to `AGENT:` if none is provided.
2. Use ripgrep to find the tag with context:

```bash
rg -n --fixed-strings "AGENT:" -C 3
```

3. If multiple tags are used, repeat the search for each tag.

## Review process

- Read each comment with surrounding code to understand scope and intent
- Make the change or address the concern where feasible
- If a request is unclear, document assumptions and raise questions
- Update or remove resolved AGENT: comments

## Output format

- Group findings by file path
- Include line numbers and relevant context for each comment
- Summarize key themes and action items at the end

## Expected actions

After finding AGENT: comments:

1. Analyze the request in each comment
2. Make the change, or explain why you did not
3. Resolve or update the instruction comment
4. Provide a brief summary of actions taken and any open questions