fix: AI tools ignore GitHub repo conventions - PR templates, CONTRIBUTING.md not auto-discovered #31899

[biisal]

Issue for this PR

Closes #31899

Type of change

• Bug fix
• New feature
• Refactor / code improvement
• Documentation

What does this PR do?

Issue

• instruction discovery only checked AGENTS.md, CLAUDE.md, and CONTEXT.md.
• The search stopped after finding the first instruction file, skipping others.
• PR templates and contributing guidelines were not included in the prompts.

Changes

• Added support for CONTRIBUTING.md and common PR template locations.
• Updated instruction discovery to collect all supported instruction files instead of stopping at the first match.
• Changed Instruction.find and resolve to handle multiple instruction files.
• Updated prompts to:

How did you verify your code works?

Unit Tests : Added tests to verify multi-file instruction support:

• find returns all instruction files in a directory.
• resolve correctly loads multiple instruction files from parent directories.
• systemPaths and system load both AGENTS.md and CONTRIBUTING.md into the prompt context.

cd packages/opencode
bun test test/session/instruction.test.ts

Result: All 12 tests passed.

Regression Testing: Ran the full session test suite to ensure no regressions from the find signature change and discovery logic updates.

cd packages/opencode
bun test test/session/

Result: All 364 tests passed.

Type Checking

• Verified the package compiles successfully.

cd packages/opencode
bun typecheck

Result: No type errors.

Screenshots / recordings

If this is a UI change, please include a screenshot or recording.

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

If you do not follow this template your PR will be automatically rejected.

[github-actions]

Hey! Your PR title FIX: AI tools ignore GitHub repo conventions - PR templates, CONTRIBUTING.md not auto-discovered #31899 doesn't follow conventional commit format.

Please update it to start with one of:

• feat: or feat(scope): new feature
• fix: or fix(scope): bug fix
• docs: or docs(scope): documentation changes
• chore: or chore(scope): maintenance tasks
• refactor: or refactor(scope): code refactoring
• test: or test(scope): adding or updating tests

Where scope is the package name (e.g., app, desktop, opencode).

See CONTRIBUTING.md for details.

[github-actions]

Thanks for updating your PR! It now meets our contributing guidelines. 👍