docs: index agent guidance with canonical source links

[rianjs]

Goal

Convert this repo's agent guidance into thin indexes instead of duplicating shared conventions.

Canonical references should point to GitHub as the source of truth, with adjacent local paths listed only as workspace conveniences.

Example:

Source of truth: https://github.com/open-cli-collective/cli-common/blob/main/docs/release.md
Local convenience copy, if present: ../cli-common/docs/release.md

Scope

• Make AGENTS.md and CLAUDE.md peer entrypoints where both exist.
• Do not have one agent file point to another agent file as the source of truth.
• Remove duplicated shared release/CI/convention prose from agent files.
• Link to canonical shared standards in:
  • https://github.com/open-cli-collective/cli-common/tree/main/docs
  • https://github.com/open-cli-collective/.github
• Include local adjacent paths only as convenience fallbacks.

Repo-specific notes

• Use the existing concise guidance as the newer-pattern baseline, but add local-path fallback wording beside canonical GitHub URLs.

Acceptance Criteria

• Agent entrypoints are short indexes, not duplicated convention containers.
• Every shared-standard local path has a paired GitHub source-of-truth URL.
• Repo-specific architecture and commands remain easy to find.
• Cross-repo conventions live in shared docs or automation, not copied into each repo.

[rianjs]

codereview-cli #5 Plan

Goal

Turn codereview-cli's agent guidance into an index that points to canonical shared standards and one repo-local, agent-agnostic development guide.

Scope

• Add docs/development.md as the repo-local guide for codereview-cli-specific facts only: scaffold status, intended binary, quick commands, local workflow file names, local release packaging status, and branch policy summary.
• Keep docs/development.md as an index for shared mechanics: it may name this repo's workflow files and current packaging status, but must link out for shared CI/release/distribution behavior instead of restating gates, job contracts, token handoff, version math, or channel mechanics.
• Replace CLAUDE.md with a short Claude entrypoint that points to docs/development.md and uses the established Source of truth: / Local convenience copy, if present: pattern for shared cli-common and .github references.
• Add AGENTS.md as the Codex peer entrypoint with the same repo-local and shared source references. Do not make either agent file point to the other.
• Remove duplicated shared CI/release mechanics from agent files and avoid moving that duplication into docs/development.md.

Source Reference Requirements

• cli-common standards:
  • Source of truth: https://github.com/open-cli-collective/cli-common/blob/main/docs/repo-layout.md, ci.md, release.md, and distribution.md
  • Local convenience copies: ../cli-common/docs/repo-layout.md, ../cli-common/docs/ci.md, ../cli-common/docs/release.md, and ../cli-common/docs/distribution.md
• Shared automation:
  • Source of truth: https://github.com/open-cli-collective/.github
  • Local convenience copy: ../.github

Out of Scope

• No changes to Go code, workflows, packaging, or branch protection.
• No broad rewrite of README or CONTRIBUTING.
• No detailed restatement of shared CI/release/distribution rules in any guidance file touched by this ticket.

Verification

• git diff --check
• rg -n -F "Source of truth:" AGENTS.md CLAUDE.md docs/development.md
• rg -n -F "Local convenience copy, if present:" AGENTS.md CLAUDE.md docs/development.md
• rg -n "CLAUDE.md" AGENTS.md should return no dependency from AGENTS to CLAUDE.
• rg -n "AGENTS.md" CLAUDE.md should return no dependency from CLAUDE to AGENTS.
• rg -n "build-platform|GITHUB_RUN_NUMBER|RELEASE_TAG_TOKEN|identity-check|pr-title" AGENTS.md CLAUDE.md docs/development.md should return no duplicated shared mechanics in the touched guidance.
• Review git diff -- AGENTS.md CLAUDE.md docs/development.md to confirm docs-only scope and repo-local facts only.