Skip to content

docs: add agent repository instructions#3755

Merged
gantoine merged 2 commits into
masterfrom
posthog-code/add-agent-repository-guide
Jul 15, 2026
Merged

docs: add agent repository instructions#3755
gantoine merged 2 commits into
masterfrom
posthog-code/add-agent-repository-guide

Conversation

@gantoine

@gantoine gantoine commented Jul 15, 2026

Copy link
Copy Markdown
Member

Description
Explain the changes or enhancements you are proposing with this pull request.

Adds a regular AGENTS.md file that directs agent-compatible tooling to the canonical repository instructions in CLAUDE.md.

Using a regular file keeps discovery working on checkouts configured with core.symlinks=false, while avoiding duplicated repository guidance.

Validation

  • trunk fmt
  • trunk check
  • Confirmed AGENTS.md is a regular file, not a symlink
  • git diff --cached --check

AI Assistance Disclosure

PostHog Code was used to inspect the change, run verification, create the branch and commits, address review feedback, and prepare this pull request. The canonical repository instructions remain maintained in CLAUDE.md.

Checklist
Please check all that apply.

  • I've tested the changes locally
  • I've updated relevant comments
  • I've assigned reviewers for this PR
  • I've added unit tests that cover the changes

Screenshots (if applicable)

Not applicable.


Created with PostHog Code

Generated-By: PostHog Code
Task-Id: bcf86d4d-de3a-43ff-800c-c3e922acdc14
Copilot AI review requested due to automatic review settings July 15, 2026 20:05

Copilot AI 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@greptile-apps

greptile-apps Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds an agent-compatible alias for the existing repository guide. The main change is:

  • Adds AGENTS.md as a symbolic link to CLAUDE.md.

Confidence Score: 4/5

The guide alias needs a portability fix before merging.

  • Symlink-capable checkouts resolve the existing guide correctly.
  • Checkouts with core.symlinks=false expose only the text CLAUDE.md, so agent tooling misses the instructions.

AGENTS.md

Important Files Changed

Filename Overview
AGENTS.md Adds a relative symlink to CLAUDE.md, with a portability issue on checkouts that materialize symlinks as plain files.

Fix All in Claude Code

Reviews (1): Last reviewed commit: "docs: add agent repository guide alias" | Re-trigger Greptile

Comment thread AGENTS.md Outdated
Generated-By: PostHog Code
Task-Id: bcf86d4d-de3a-43ff-800c-c3e922acdc14
@gantoine gantoine changed the title docs: add agent repository guide alias docs: add agent repository instructions Jul 15, 2026
@gantoine
gantoine merged commit 1c7d633 into master Jul 15, 2026
8 checks passed
@gantoine
gantoine deleted the posthog-code/add-agent-repository-guide branch July 15, 2026 20:31
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.

2 participants