AGENTS.md

Project entrypoint for this repository. Keep this file short and repo-local so it works the same way on Windows, Mac, and Codex Cloud.

Always-On Rules

1. Do not fabricate missing facts. If information is insufficient, say 信息缺失.
2. Keep outputs practical, clear, and structured. Avoid slogans, fluff, and unsupported certainty.
3. Distinguish facts, inferences, uncertainties, and recommendations when doing multi-agent or multi-perspective work.
4. Do not enter /room or /debate unless the user explicitly starts with that command or is already continuing inside that mode.
5. Prefer repo-relative paths and repo-local references over machine-specific absolute home-directory paths.

Source Of Truth

Treat this repository as the long-term source of truth for the round-table system.

Primary source directories:

• README.md
• LAUNCH.md
• AGENTS.md
• docs/
• schemas/
• agents/
• config/
• roundtable_core/
• scripts/
• skills_src/
• evals/
• prompts/
• examples/
• .codex/skills/debate-roundtable-skill/
• .codex/skills/room-skill/
• .codex/skills/agent-builder-skill/
• .codex/skills/*/roundtable-profile.md
• .claude/skills/ (Claude Code project-skill adapter layer only; not protocol implementation)

Historical material lives under:

• reports/
• artifacts/

Development Sync

For every new development task, follow:

• docs/source-truth-map.md
• docs/development-sync-protocol.md
• docs/release-readiness.md when deciding launch readiness or remaining blockers
• docs/release-candidate-scope.md when creating a launch/support claim
• docs/agent-continuity-checkpoints.md when host-level memory is read-only or another agent will continue the work
• docs/superpowers/local-development-integration.md when local Superpowers is installed

Default rule:

• develop locally
• verify locally
• commit verified changes
• push to origin/main
• report completed work, verification, and remaining gaps

Do not treat exploratory local edits as complete work. Do not treat reports/ as the active implementation source.

Local Superpowers is a workflow helper, not a source-of-truth override.

Room Roundtable

/room is an explicit-only stateful roundtable mode. It is not the default mode.

Command Discovery Hint

For complex strategy, product, risk, or decision questions, you may briefly suggest that the user can choose /room or /debate. This is only a hint, not a mode switch.

Examples:

• Ordinary factual question: answer directly; no /room or /debate hint.
• Complex product/startup judgment: "这个问题适合用 /room 先探索，或用 /debate 做正式判断。你可以直接输入 /room ... 或 /debate ...。"
• Only after the user explicitly starts with /room or /debate do you enter that workflow.

On /room, use:

• Skill: .codex/skills/room-skill/SKILL.md
• Claude Code project skill: .claude/skills/room/SKILL.md
• Supporting docs:
  • docs/room-runtime-status.md
  • docs/room-runtime-bridge.md
  • docs/host-adapter-architecture.md
  • docs/generic-local-agent-adapter.md
  • docs/local-agent-host-recipes.md
  • docs/third-party-agent-wrapper-recipes.md
  • docs/provider-live-readiness.md
  • docs/release-readiness.md
  • docs/release-candidate-scope.md
  • docs/claude-code-skill-adapter.md
  • docs/room-architecture.md
  • docs/room-selection-policy.md
  • docs/room-chat-contract.md
  • docs/agent-registry.md
  • docs/room-to-debate-handoff.md
  • schemas/room-session.schema.json
  • prompts/room-selection.md
  • prompts/room-chat.md
  • prompts/room-summary.md
  • prompts/room-upgrade.md

Debate Roundtable

/debate is an explicit-only roundtable dispatcher. It is not the default mode.

On /debate, use:

• Skill: .codex/skills/debate-roundtable-skill/SKILL.md
• Claude Code project skill: .claude/skills/debate/SKILL.md
• Supporting docs:
  • docs/debate-runtime-bridge.md
  • docs/host-adapter-architecture.md
  • docs/generic-local-agent-adapter.md
  • docs/local-agent-host-recipes.md
  • docs/third-party-agent-wrapper-recipes.md
  • docs/provider-live-readiness.md
  • docs/release-readiness.md
  • docs/release-candidate-scope.md
  • docs/claude-code-skill-adapter.md
  • docs/debate-skill-architecture.md
  • docs/agent-role-map.md
  • docs/reviewer-protocol.md
  • docs/red-flags.md
  • docs/room-to-debate-handoff.md
  • schemas/debate-session.schema.json
  • schemas/debate-result.schema.json
  • prompts/debate-roundtable.md
  • prompts/debate-reviewer.md
  • prompts/debate-followup.md

Historical archive only when needed for archaeology, not as active source of truth:

• docs/archive/AGENTS.full-20260411-142320.md

Default daily mode: route to 1-3 relevant skills only when their trigger conditions are met. Do not auto-run a room or roundtable.