AGENTS.md generator

Turns one .code-workspace file plus a small scan of its folders — nothing else — into the workspace-root AGENTS.md and its CLAUDE.md redirect shim.

Inputs

• The target root must contain a *.code-workspace file (multi- or single-folder). If none exists, stop and do not generate files — the Project Matrix is built from its folders list; tell the user to rerun from a folder holding one.
• Never read or copy the agent's own global or user instruction files (~/.claude/CLAUDE.md, ~/.codex/, global AGENTS.md, personal memory/rules) — no personal rule (co-author, memory, context, issue-routing) may appear in the generated files.

Rules

• AGENTS.md is the single source of truth for Codex CLI, Claude CLI, Antigravity CLI, Cursor CLI, Opencode CLI, and GitHub Copilot CLI; all operating instructions — context, memory policy, issue routing, skill use — live there.
• CLAUDE.md is only a redirect shim for Claude CLI: emit assets/claude-md-template.md byte-for-byte, nothing more, and never read other context from it.
• Generate exactly one of each, at the workspace root — never per-project or per-repo AGENTS.md. The generated AGENTS.md is spartan and direct.

Workspace scan

Small-scan every workspace folder before generating: note any VISION.md/vision.md at the workspace or a project root (feeds North star) and detect each stack. Multiple stacks → the intro slot says so and warns against mixing conventions or code across projects.