Skip to content

docs: restructure AGENTS.md and add an AI contributions policy - #51

Merged
kodiakhq[bot] merged 2 commits into
mainfrom
claude/posthog-js-agents-policy-cl5pap
Aug 18, 2026
Merged

docs: restructure AGENTS.md and add an AI contributions policy#51
kodiakhq[bot] merged 2 commits into
mainfrom
claude/posthog-js-agents-policy-cl5pap

Conversation

@RedStar071

@RedStar071RedStar071 commented Aug 18, 2026

Copy link
Copy Markdown
Member

Reshape AGENTS.md along the structure PostHog/posthog-js uses for its
agent guide: an overview with the pinned toolchain versions, folder
structure, a workspace package table, environment setup, a command
reference with Turborepo filters, a CI workflow table, an important-files
table, and troubleshooting. The architecture boundaries and the safety
and determinism rules are kept verbatim, and the Skilld-managed block at
the end of the file is preserved.

Add AI_POLICY.md, adapted from PostHog's policy to this repository: the
contributor owns the diff, respects the package boundaries, runs the full
check set with deterministic tests, and discloses agent involvement.
Model output stays untrusted input, security reports follow SECURITY.md,
and unsolicited AI-generated reviews are not accepted.

Add the Agent context section the policy refers to in the pull request
template, and link the policy from CONTRIBUTING.md.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01E7MKWqd4RdBJPCywtWA3zf


View with [code]smithAutofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Note

Add AI contributions policy and restructure AGENTS.md development guide

  • Adds AI_POLICY.md defining standards for AI-assisted contributions: ownership requirements, architecture boundary rules, required verification commands, disclosure expectations, and consequences for non-compliance.
  • Expands AGENTS.md from a minimal instruction file into a full development guide covering environment setup, folder structure, toolchain, scripts, CI/CD workflows, and architecture boundaries.
  • Updates PULL_REQUEST_TEMPLATE.md with an 'Agent context' section requiring contributors to disclose AI tool usage and describe what they verified themselves.
  • Adds a reference to AI_POLICY.md in CONTRIBUTING.md for contributors using AI agents.

Macroscope summarized 6ae7532.

Reshape AGENTS.md along the structure PostHog/posthog-js uses for its
agent guide: an overview with the pinned toolchain versions, folder
structure, a workspace package table, environment setup, a command
reference with Turborepo filters, a CI workflow table, an important-files
table, and troubleshooting. The architecture boundaries and the safety
and determinism rules are kept verbatim, and the Skilld-managed block at
the end of the file is preserved.
Add AI_POLICY.md, adapted from PostHog's policy to this repository: the
contributor owns the diff, respects the package boundaries, runs the full
check set with deterministic tests, and discloses agent involvement.
Model output stays untrusted input, security reports follow SECURITY.md,
and unsolicited AI-generated reviews are not accepted.
Add the Agent context section the policy refers to in the pull request
template, and link the policy from CONTRIBUTING.md.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E7MKWqd4RdBJPCywtWA3zf
@vercel

vercelBot commented Aug 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
agent-zero-dashboardErrorErrorAug 18, 2026 9:05pm
agent-zero-docsReadyReadyPreviewAug 18, 2026 9:05pm

@macroscopeapp

macroscopeappBot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Approvability

Verdict: Approved at be52bf2

Macroscope's review found this PR approvable — Documentation-only changes restructuring AGENTS.md and adding an AI contributions policy. No runtime code is modified - all changes are markdown files containing contributor guidelines and development documentation.

No code changes detected at 6ae7532. Prior analysis still applies.

You can add or adjust custom eligibility rules. Learn more.

@kodiakhq
kodiakhqBot merged commit 19b59dc into mainAug 18, 2026
18 of 20 checks passed
@kodiakhq
kodiakhqBot deleted the claude/posthog-js-agents-policy-cl5pap branch August 18, 2026 21:04
Sign up for freeto 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

@RedStar071