Add agent AI policy instructions

[sij411]

Summary

Adds agent-facing instructions so coding agents read AI_POLICY.md before contributing and include the required Assisted-by trailer when creating commits.

Also updates AI_POLICY.md so AI disclosure is required in commit messages.

Validation

• mise run check

Summary by CodeRabbit

• Documentation
  • Introduced guidance for AI-assisted development, including agent workflow and commit message requirements
  • Updated AI disclosure policy to require Assisted-by trailer format in commits for identifying AI-assisted portions of work
  • Clarified that Co-authored-by trailers are not appropriate for AI assistants

[coderabbitai]

Warning

Review limit reached

@sij411, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 30 minutes and 33 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more credits in the billing tab to continue.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8d0fef50-6536-45c8-bbbd-a931bdaf2f36

📥 Commits

Reviewing files that changed from the base of the PR and between 7fb688e and a258668.

📒 Files selected for processing (3)

• .agents/skills/commit/SKILL.md
• AGENTS.md
• AI_POLICY.md

📝 Walkthrough

Walkthrough

This PR establishes AI disclosure requirements by clarifying the policy to mandate Assisted-by trailer trailers in commit messages, then documents how LLM agents should comply through high-level instructions and a Git commit skill guide for staged changes.

Changes

AI Disclosure Policy and Agent Workflow

Layer / File(s)	Summary
AI disclosure policy clarification AI_POLICY.md	The policy is updated to explicitly require stating which parts of work were AI-assisted in commit messages using the Assisted-by trailer format, replacing earlier wording that mentioned both pull request descriptions and commit messages.
Agent guidelines and commit workflow AGENTS.md, .agents/skills/commit/SKILL.md	AGENTS.md provides agent-level instruction on following the AI policy, required disclosure via Assisted-by trailers, and development workflow guidance. .agents/skills/commit/SKILL.md defines the operational commit skill that enforces AI disclosure trailers while committing staged changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

🐰 A rabbit hops through policy halls,
Marking trails with "Assisted-by" calls,
Agents now guided with clear, honest words—
AI disclosure, fair and assured! 🌿

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change—adding AI policy instructions for agents, which is reflected in all three modified files (AGENTS.md, SKILL.md, and AI_POLICY.md updates).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.agents/skills/commit/SKILL.md:
- Around line 14-16: The fenced code block containing "Assisted-by:
Codex:gpt-5.5" in SKILL.md needs a language specifier; update the
triple-backtick fence to include an appropriate language token such as text or
gitcommit (e.g., ```text or ```gitcommit) so the block renders consistently
across viewers and syntax highlighters.

In `@AGENTS.md`:
- Around line 23-25: Update the fenced code block that contains the line
"Assisted-by: Codex:gpt-5.5" to include a language specifier (for example change
the opening fence to ```gitcommit or ```text and keep the closing fence
matching) so the block renders with proper syntax highlighting; locate the block
in AGENTS.md (the fence surrounding the "Assisted-by: Codex:gpt-5.5" line) and
apply the change.
- Line 14: Replace the literal "<AI\_POLICY.md>" reference with a plain file
reference by removing the angle brackets and backslash escape; change
"<AI\_POLICY.md>" to either AI_POLICY.md or a proper Markdown link like
[AI_POLICY.md](AI_POLICY.md) so the underscore is not escaped and the file name
renders correctly.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c59a0050-e8c3-4872-a9bf-7fcda8816a19

📥 Commits

Reviewing files that changed from the base of the PR and between a635fd8 and 7fb688e.

📒 Files selected for processing (3)

• .agents/skills/commit/SKILL.md
• AGENTS.md
• AI_POLICY.md