agents-md

Installation
SKILL.md

AGENTS.md generator

Produces workspace-root instructions and on-demand rules, optionally synchronizing existing project runtime blocks from local Compose evidence.

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. If several exist, ask which one to use before scanning.
  • Never read or copy the agent's own global or user instruction files (~/.claude/CLAUDE.md, ~/.codex/, global AGENTS.md, personal memory/rules). Generate rules from the shipped templates and workspace evidence. Zero attribution: omit co-author, AI, and tool attribution from generated files and all output.

Rules

  • Workspace-root AGENTS.md is the single source of truth for Codex CLI, Claude CLI, Antigravity CLI, Cursor CLI, Opencode CLI, and GitHub Copilot CLI; shared operating instructions — context, memory policy, issue routing, skill use — live there.
  • Never create or edit CLAUDE.md or GEMINI.md, or take rules from them; report an existing one as a competing instruction file.
  • Create exactly one root AGENTS.md and the rules/ files in the file map. Project synchronization edits existing AGENTS.md files only; never create project instruction files.

Modes

Default: generate or refresh the root file and its on-demand files. When .devcontainer/compose.yml exists, read Project runtime synchronization and synchronize existing project runtime blocks; otherwise report synchronization skipped without loading that reference.

Installs
129
GitHub Stars
2
First Seen
May 1, 2026