chore(AI): Recommend OpenSpec for scoping AI-assisted changes

[MaxymVlasov]

Put an x into the box if that apply:

• This PR introduces breaking change.
• This PR fixes a bug.
• This PR adds new functionality.
• This PR enhances existing functionality.

Description of your changes

What

_{This section was generated by AI.}

• Split out of #1002's OpenSpec-adjacent bits, per this review, so that PR's tool-version pinning work doesn't have to wait on this.
• Adds a "Recommended tooling" section to .github/AI_POLICY.md recommending contributors scope AI-assisted changes with OpenSpec's propose/apply workflow before code gets written.
• Adds .agents/skills/openspec-* and .agents/commands/opsx/* to .gitignore, since openspec init generates those locally per-contributor and they must never be committed.
• Wires the openspec-* skills into AGENTS.md's skill-routing table - the skill files are gitignored/local-only, but the routing metadata is meant to stay in the shared repo.

Why

How can we test changes

_{This section was generated by AI.}

Read .github/AI_POLICY.md and .gitignore - no code/behavior change, documentation and ignore-rules only.

Assisted-by

_{Specific models used per commit are specified in the commit messages.}

• Assisted-by: Sisyphus:claude-sonnet-5 opencode

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds OpenSpec workflow guidance, routes six OpenSpec skills in AGENTS.md, and ignores locally generated OpenSpec agent commands and skills.

Changes

OpenSpec tooling

Layer / File(s)	Summary
Document and ignore generated OpenSpec content .github/AI_POLICY.md, .gitignore	Adds OpenSpec installation, initialization, scoping, and local-generation guidance, plus ignore rules for generated OpenSpec agent files.
Route OpenSpec skills AGENTS.md	Adds six OpenSpec task-to-skill mappings to the skill-routing table.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
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.
Title check	✅ Passed	The title clearly summarizes the main change: recommending OpenSpec for scoping AI-assisted changes.
Description check	✅ Passed	The description directly matches the documented OpenSpec policy, ignore rules, and AGENTS routing updates.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch openspec_ai_policy

---

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.}

[coderabbitai]

Actionable comments posted: 2

🤖 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 @.github/AI_POLICY.md:
- Line 19: Update the OpenSpec workflow guidance in AI_POLICY.md to avoid
presenting “/opsx:propose” and “/opsx:apply” as universal syntax. Retain the
workflow intent while directing readers to the generated command configuration
or OpenSpec documentation, and clarify that command syntax depends on the AI
assistant.

In @.gitignore:
- Line 181: Update the comment describing OpenSpec-generated files to use the
correct tool name, replacing “openspec.ai” with “OpenSpec” or “openspec.dev”
while preserving the comment’s meaning.

🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 18670abe-97c4-45fe-b1bb-40e25dfae2af

📥 Commits

Reviewing files that changed from the base of the PR and between bf9dd9c and dd9fd5b.

📒 Files selected for processing (2)

• .github/AI_POLICY.md
• .gitignore

[Copilot]

Pull request overview

This PR updates contributor-facing documentation and repository hygiene to encourage scoping AI-assisted work with OpenSpec before code is written, and to ensure OpenSpec-generated local agent assets are not accidentally committed.

Changes:

• Add an OpenSpec “Recommended tooling” section to .github/AI_POLICY.md describing the propose/apply workflow.
• Ignore locally generated OpenSpec agent skills/commands via .gitignore.
• Extend AGENTS.md’s skill-routing table with OpenSpec-related entries.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 2 comments.

File	Description
AGENTS.md	Adds OpenSpec skill-routing entries so contributors know which skills to use for spec-driven scoping.
.gitignore	Ignores OpenSpec-generated .agents/... files to keep local-only assets out of commits.
.github/AI_POLICY.md	Recommends OpenSpec as a workflow tool for scoping AI-assisted changes before implementation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.