Summary

Refreshed the repo's agent guidance to match the current monorepo and settled the long-standing CLAUDE.md vs AGENTS.md duality on a single source of truth. Shipped as draft PR #30 on branch claude/claude-md-docs-QQFTe. CI green; scope verified as AGENTS.md-only.

What changed

• **AGENTS.md refreshed** to reflect the monorepo: documented command-center/ (Next.js), services/ (FastAPI marketing-api + command-center-api), dashboard-app/ (Flask), litify-health-check/ (Node), sail-routines/ (Node + launchd scheduler), marketing_center_charts/, and team-page-redesign/; added the deploy configs (render.yaml, vercel.json) and the wiki-debug.yml workflow.
• Added an Apps & services table with per-app local-run and deploy commands, plus conventions: graceful degradation / snapshot fallback, no fabricated data, provenance labeling, secrets-stay-in-env.
• Noted that .claude/commands/* (slash commands) and sail-routines/ (scheduler) are two surfaces for the same operational routines and must be kept in sync.

Decision: one source of truth for agent guidance

• **AGENTS.md is canonical; CLAUDE.md is a thin shim.** A comprehensive standalone CLAUDE.md was briefly trialed, then reverted per this decision.
• Rationale: two comprehensive docs drift. Modern Claude Code reads AGENTS.md natively; the other tools (Codex, Cursor, Copilot, Gemini, Manus) read AGENTS.md or their own shim — not CLAUDE.md — so deprecating AGENTS.md would blind them.
• Rule going forward: when guidance changes, edit AGENTS.md only. The shims (CLAUDE.md, .cursor/rules/agents.mdc, .github/copilot-instructions.md, GEMINI.md) are static redirects and never need updating.

QA / Verification

• PR scope verified: 3 commits, AGENTS.md-only (110 insertions / 8 deletions). CLAUDE.md nets identical to main after the revert.
• cross-repo-invariants block confirmed byte-for-byte identical to origin/main.
• Every path documented in AGENTS.md confirmed to exist in the working tree.
• CI green on PR #30 (the only check, Vercel Preview Comments, passed).

Open items / next steps

• PR #30 is a draft awaiting human review and merge to main.
• Optional follow-up: add a CI check that fails if the cross-repo-invariants block drifts across sail-skills, sail-templates, and projects — makes the "identical block" guarantee automatic instead of manual.
• Optional: squash the 3 docs commits (refresh → comprehensive → revert arc) into one before merge.

Reason for ending session