meta-theory

meta-theory is a command for Claude Code from KimYx0207/Meta_Kim. It costs 10 tokens per session (1,449 once invoked), scanned A, original, Apache-2.0.

A command that sends requests through the MetaKim governance dispatcher, which is the project’s controlled process for classifying and handling work. It also reopens the latest generated report.

In plain words
What is it for?
Use it for explicit MetaKim requests, repository or architecture analysis, strategy work, governance reviews, runtime changes, and release tasks.
Why use it?
It ensures non-trivial requests follow the project’s required routing and evidence process instead of being handled as an informal prose instruction.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: reads .claude/ paths; names the AskUserQuestion tool; mentions Claude Code.

Good fit Use it for explicit MetaKim requests, repository or architecture analysis, strategy work, governance reviews, runtime changes, and release tasks.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/kimyx0207/meta_kim/meta-theory
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/KimYx0207/Meta_Kim

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for meta-theory

README.md
[![agentmods](https://agentmods.dev/badge/commands/kimyx0207/meta_kim/meta-theory/github.svg)](https://agentmods.dev/commands/kimyx0207/meta_kim/meta-theory)
Your own site
<a href="https://agentmods.dev/commands/kimyx0207/meta_kim/meta-theory"><img src="https://agentmods.dev/badge/commands/kimyx0207/meta_kim/meta-theory/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for meta-theory

Your own site · 80×15
<a href="https://agentmods.dev/commands/kimyx0207/meta_kim/meta-theory"><img src="https://agentmods.dev/badge/commands/kimyx0207/meta_kim/meta-theory.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 10 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,449 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00010 $0.01449
Opus 5 $0.00005 $0.00724
Sonnet 5 $0.00002 $0.00290
Haiku 4.5 $0.00001 $0.00145

Measured 10d ago against content hash ed7bf99949cb, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

meta-theory scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

canonical/runtime-assets/claude/commands/meta-theory.md · 134 lines

How it starts

The opening of the file, as written. The whole thing — 134 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Use the machine-governed Meta_Kim entry for this request:

$ARGUMENTS

Default product runtime path:

When this command is installed globally, run the installed Meta_Kim package root directly:

node "__META_KIM_PACKAGE_ROOT__/scripts/run-meta-theory-governed-execution.mjs" --runtime claude_code --emit-conversation-notice "$ARGUMENTS"

If this command file has not been rendered by global sync and the placeholder is still present, fall back only when the current project is the Meta_Kim source checkout or provides the package script:

npm run meta:theory:run:notice -- --runtime claude_code "$ARGUMENTS"

Then reopen the report with:

node "__META_KIM_PACKAGE_ROOT__/scripts/run-meta-theory-governed-execution.mjs" --read latest

This command is not a prose-only reminder. For explicit /meta-theory requests, project/repo understanding, architecture analysis, commercialization strategy, market or competitor reasoning, governance review, release work, runtime work, or any non-trivial durable task, run the machine entry above or state the exact blocking reason.

Minimum route:

  1. Classify the request with the Meta_Kim entry rules.
  2. Run Fetch before Thinking. Project understanding must inspect local project evidence such as README, AGENTS, package scripts, canonical/config contracts, capability index, MCP/runtime configs, and Graphify navigation when present.
  3. If the answer depends on current market, competitor, platform, provider, pricing, dependency, version, or official documentation facts, prove an available retrieval path or return blocked to Fetch.
  4. Use the run artifact and report as the evidence surface. Do not replace the machine route with a short manual summary.

Two host-native phases are mandatory:

  • Phase 1 — route and handoff: run the governed Node command only to produce route compatibility and a handoff state. ready_for_host_handoff means Claude Code must perform the next native action; awaiting_native_choice means it must call AskUserQuestion; blocked means it must stop. The runner never authorizes task execution.
  • Phase 2 — current-host action: after any required AskUserQuestion answer, use the active Claude Code host's real Agent / Task, tools, and permission surface. Persistent acceptance records are advisory compatibility evidence only. No callback, environment value, or JSON can complete the native choice or authorize this task.

Claude Code execution rule:

HOST-NATIVE FAN-OUT PREFERRED. The main thread is the dispatcher, never the execution worker. The governed runner produces route evidence, workerTaskPackets, and hostInvocationRequestPacket; it does not by itself prove live Claude Code Agent / Task execution. Use Claude Code's native Agent/Task tool directly to fan out independent worker lanes — the runner only records evidence, discovers capabilities, and suggests lanes; it does not enforce dispatch.

  • This /meta-theory invocation is explicit user authorization to use Claude Code Agent/Task delegation and parallel worker lanes when Thinking proves the lanes are independent and safe.
  • Use the authoritative stage DAG plus native Agent/Task as the sufficient fan-out route. agent-teams-playbook is optional: select it only when it improves orchestration, record not_required for fewer than two ready lanes, and record optional_adapter_not_selected when native fan-out is sufficient. Resolve it from the first available skill root (~/.claude/skills/agent-teams-playbook/SKILL.md, .claude/skills/agent-teams-playbook/SKILL.md, .agents/skills/agent-teams-playbook/SKILL.md, or a configured dependency root). Treat it as a selected fan-out adapter unless a live Skill/Agent Team/Task call is attached.
  • Then call the active Claude Code host's real Agent / Task surface for each selected execution worker lane. Every Agent/Task prompt must cite the corresponding workerTaskPackets[].taskPacketId, selected owner/role, output schema, write scope, collision boundary, verification owner, and expected evidence shape.
  • Record the returned Agent/Task tool-call id, completion status, and worker-task-to-agent mapping as trusted host invocation evidence. If no callable Agent/Task surface is available, record the checked tool/capability names and blocked reason; do not silently continue as main-thread execution.

Read the full file on GitHub · 134 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 134 lines · 10 tokens per session scan A ed7bf99949cb

Subscribe to this mod's changes

meta-theory is a command published in the GitHub repository KimYx0207/Meta_Kim (273 stars, last pushed today), licensed Apache-2.0. It adds 10 tokens to every session and 1,449 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.