docs: make development host-neutral and merge CLAUDE.md into AGENTS.md

[antonbabenko]

Summary

Development of this repo no longer assumes Claude Code. Any coding agent (Codex, Cursor, Gemini, Kiro, OpenCode, Claude Code) can pick it up from AGENTS.md.

• AGENTS.md is a short (~95 lines) host-neutral dev guide. It covers:
  • commands, including npm run sync / sync:check
  • the docs checklist
  • a map of which generator writes which file
  • release rules
  • the pre-PR consensus review, with per-host instructions and prerequisites
  • a pointer table into deeper docs
• docs/dev/architecture.md and docs/dev/design-decisions.md hold the former CLAUDE.md detail, moved word for word.
• CLAUDE.md is removed.
• docs/tool-guide.md is the old user-facing AGENTS.md tool guide, moved. scripts/hosts/{codex,kiro,antigravity}.js read it there. Regenerated host artifacts changed only in their banner and intro paragraph. Links are repointed in README, TECHNICAL, server/mcp/README.md, docs/hosts/, public-docs/hosts/, core/grounding.js and the validate.yml message.
• README.md presents deliberation as multi-host. The Install section opens with a path for each host, and "Claude" became "your agent" where it meant the host agent.
• CONTRIBUTING.md:
  • host-neutral quick start and testing
  • accurate project tree, release-bump table, JavaScript code style
  • rewritten Adding a New Provider. The config-only path covers OpenAI-compatible endpoints: the unified server uses one global providers.openrouter.apiBase, a per-record apiBase works only in the standalone bridge, and a warning says where the key is sent. A checklist for a new built-in transport is checked against the code.

Test plan

• npm run check - 1163 pass, 0 fail, 1 skipped
• npm run sync:check - personas, 52 host artifacts and command fallbacks up to date
• Relative-link and anchor check over the changed docs - 0 broken
• /consensus code review: 3 rounds, converged (codex, gemini, grok, kimi-k3, glm-5-3-flash all APPROVE)

Consensus review: deferred and dismissed issues

Deferred:

• Claude Code may not load AGENTS.md without a CLAUDE.md. Removing CLAUDE.md was an explicit maintainer decision. If it is needed, the fallback is a one-line CLAUDE.md containing @AGENTS.md.
• The API-key-to-custom-apiBase warning should also go in SETUP/TECHNICAL. That gap predates this change. Follow-up.

Dismissed:

• "Provider checklist symbols are unverified." Each symbol was grep-confirmed, and codex and gemini read the code without finding a wrong one.
• "Telemetry / config history is undocumented." This diff doesn't touch it, and it is documented in TECHNICAL.md and the tool guide.
• "'When not to delegate' guidance is lost." It is still in docs/tool-guide.md and rules/triggers.md.
• "There are stale references or broken anchors." A grep and a link check found none.
• "Release automation reads the moved table." Releases are driven by commit prefixes, not docs.
• "The pre-PR diff hardcodes master." master is the default branch and the release trigger.

[github-actions]

This PR is included in v3.27.0 🎉

Claude Code

/plugin marketplace update antonbabenko
/reload-plugins

If the update still shows the old version, the marketplace re-pin is a few minutes behind; run it again shortly.

Codex, Kiro, Cursor, OpenCode plugins: update deliberation from your host's plugin manager.

MCP server (any host): @antonbabenko/deliberation-mcp@3.27.0 is published. Restart your host to pick it up.