grim-authoringlisted

# Grim Artifact Authoring Grim publishes five artifact kinds to OCI registries. Each has its own source shape, frontmatter schema, and validation gates. This root file holds the invariants that apply to every kind; per-kind depth lives in `references/`, loaded via the routing table below. ## The Five Kinds `grim build` and `grim release` infer the kind from the path — except agents (always `--kind agent`, or they silently pack as rules) and MCP servers (always `--kind mcp`, or the `.toml` is treated as a bundle). | Kind | Source shape | Inference | Installs as | |---|---|---|---| | Skill | Directory with a `SKILL.md` index | directory → skill | Directory tree under the client's `skills/` dir | | Rule | Single `.md` file | `.md` → rule | `rules/<name>.md`, per-client transform | | Rule + support dir | `<name>.md` + sibling `<name>/` dir | sibling dir auto-discovered | Index file + `rules/<name>/…` side by side | | Agent | Single `.md`, frontmatter required | **never — `--kind agent` mandatory** | One agent file per client, per-client render | | MCP server | `.toml` descriptor with a `[server]` table | **never — `--kind mcp` mandatory** | Entry in each client's MCP config file, per-client render | | Bundle | `.toml` member list | `.toml` → bundle | Never materializes — expands to its members | ## Which Clients Host Which Kind Grim installs into a growing set of clients, and not every client can host every kind — decide this **before** you author, because it changes what y