# Agent Instructions — Virtual Sales Rep

This file is read by Claude Code, OpenCode, Codex, and other agents that recognise `AGENTS.md`.

The full workspace instructions — skills, trigger phrases, Jira defaults, git rules, and codebase conventions — are in `.github/copilot-instructions.md`.

Read that file **in full** at the start of every session before taking any action.

---

## Orchard Organisational Patterns — Priority Rule

**Always favour established Orchard organisational patterns over patterns introduced in this repository.**

This codebase is a POC/replatform prototype. Org-wide patterns take precedence.

### Rules

1. **Org pattern wins.** When a pattern appears in 2+ `@theorchard/*` packages or repos it is an organisational pattern. Use it, even if the current workspace uses a different approach.
2. **Foundational patterns are mandatory.** Auth, routing, data-access, error-handling, server setup, testing — these follow the org standard without exception.
3. **Single-use / odd patterns: mention, don't enforce.** If a pattern appears in only one repo it is not a standard. Flag it in your response but do not require it here.
4. **When uncertain, check the reference repos** in `research/other_repos/` (suite-frontend, suite-apollo, graphql-server, connector-*, frontend-react-components) before deciding.
5. **This rule overrides** any workspace-local pattern, ticket instruction, or POC convenience shortcut.

## Authorship / Co-authorship

Never add `Co-authored-by:` trailers to git commits.
Never add co-authorship credits to pull request descriptions or bodies.
This applies to all commits, PRs, and any version-controlled artifact — without exception.