validate

validate is a command for Claude Code from OneDro1d/dark-factory. It costs 19 tokens per session (5,358 once invoked), scanned C, original, Apache-2.0.

An end-to-end validator for a newly installed Dark Factory kit. It runs the kit's validation tasks and records each result as passed, failed, or unknown.

In plain words
What is it for?
Use it to inspect the kit, verify its setup and hooks, run preflight checks, and quote command output in the validation record.
Why use it?
It provides a structured check of the installation without changing anything until the checks are complete.

Command for Claude Code

Written for Claude Code: SessionStart hook event. Also seen: reads .claude/ paths; mentions subagents; names the AskUserQuestion tool.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is rm -rf ../workers/dev/*probe* 2>/dev/null || true.

Part of the df-governed plugin — 1 command, 1 agent shipped together

Good fit Use it to inspect the kit, verify its setup and hooks, run preflight checks, and quote command output in the validation record.

Compare 6 commands from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/OneDro1d/dark-factory
agentmods
npx agentmods add commands/onedro1d/dark-factory/validate

Made for: Claude Code.

Or install df-governed, the plugin that ships this one along with the rest of its 1 command, 1 agent.

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 validate

README.md
[![agentmods](https://agentmods.dev/badge/commands/onedro1d/dark-factory/validate/github.svg)](https://agentmods.dev/commands/onedro1d/dark-factory/validate)
Your own site
<a href="https://agentmods.dev/commands/onedro1d/dark-factory/validate"><img src="https://agentmods.dev/badge/commands/onedro1d/dark-factory/validate/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 validate

Your own site · 80×15
<a href="https://agentmods.dev/commands/onedro1d/dark-factory/validate"><img src="https://agentmods.dev/badge/commands/onedro1d/dark-factory/validate.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 5,358 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. 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.00019 $0.05358
Opus 5.5 $0.00008 $0.02143
Sonnet 5.5 $0.00004 $0.01072
Haiku 4.5 $0.00002 $0.00536

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

Security

Grade C, and why

validate scanned grade C with 1 finding 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 21d 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.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf ../workers/dev/*probe* 2>/dev/null || true
plugins/df-governed/commands/validate.md · 316 lines

How it starts

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

You are validating a freshly installed Dark Factory kit. This session's cwd is a throwaway notepad that validate-arm.sh armed for exactly this run — do not go looking for "the working notepad" the way VALIDATE-INSTALL.md Part 1's Task 0 does; you are already in it, and M-VALIDATE is already RUNNING in .df/missions/M-VALIDATE/state. The kit root is the parent of your cwd (..). The record is the one that RESOLVES for THIS machine, not "the file at the kit root": if LOOM_LOCK is set in your environment, that is it; otherwise run bash <kit-root>/vendor/dark-factory/boot-kit/scripts/identify.sh --match <kit-root>/instances (fall back to <kit-root>/boot-kit/scripts/identify.sh, if this kit ships one) and use the record it names, else the single <kit-root>/*.lock.json. A non-zero exit from --match now means no record matches this machine, not an error. On every Coder in a shared instance repo the kit-root file describes a DIFFERENT machine (the laptop) and identify.sh exits 3 against it — a run that validated that file would be the exact failure Task 1 exists to catch. Quote which record you used and how it was chosen.

Work the tasks below in order. Record each as PASS, FAIL, or UNKNOWN — UNKNOWN means you could not probe it, not that it passed. Quote commands and output verbatim; never paraphrase a denial or an error. Fix nothing until the end.

⛔ NEVER PRINT A SECRET — and a whole-environment dump IS printing one. This session's transcript is written to disk and kept. On a Coder workspace the pod env carries live hub PATs and the agent token, and ~/.mcp.json can hold literal bearers. MEASURED on the homelab box (2026-09-11 and twice on 2026-09-18): three validate runs each opened with a bare env, and one ran claude mcp get onedroid. Every one of those runs copied a live token into its transcript. So:

  • Do not run env, printenv with no argument, set, export -p, declare -x, claude mcp get …, or cat/jq on ~/.mcp.json, ~/.claude.json or any rendered MCP config.
  • Read one named, non-secret variable at a time, e.g. printenv LOOM_LOCK or printenv CLAUDE_CODE_ENTRYPOINT. To learn whether a secret is SET, test it without echoing it: [ -n "${SYNAPSE_ONEDROID_PAT:-}" ] && echo set.
  • For MCP, claude mcp list (names and status) is enough. To show a config's shape, print its keys and URLs, never a header value. If you print a secret by mistake, say so in the report's Notes for the operator: name the variable and the transcript path, and never the value.

Part 1 — the parts of VALIDATE-INSTALL.md that still apply from inside this notepad

Tasks 0–4 of that document (orient, identity, ground truth, hooks, preflight) are about the KIT and do not depend on being in a notepad — if you need them, they are unchanged and live at <kit-root>/vendor/dark-factory/starter-kit/instance/VALIDATE-INSTALL.md on a kit (the vendorDir the lockfile names; starter-kit/instance/… only in a Tier-1 checkout). What changes in a notepad session is continuity, dispatch, and subagents, so those three are reproduced here adapted to it.

Read the full file on GitHub · 316 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. 21d ago Changed 174d78bd0bad
  2. 1mo ago Changed · +16 lines a4b44bf6be15
  3. 2mo ago Changed · +34 lines 29f55d06801c
  4. 2mo ago Changed · +22 lines 5eac948ca5dc
  5. 2mo ago First seen · 244 lines · 19 tokens per session scan C 6cdfe8c0bdc0

Subscribe to this mod's changes

validate is a command published in the GitHub repository OneDro1d/dark-factory (3 stars, last pushed 4d ago), licensed Apache-2.0. It adds 19 tokens to every session and 5,358 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-09.

Related

validate compared with commands from other repositories

validate next to 6 commands from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
validateOneDro1d/dark-factoryCommand34d agoApache-2.0C19Claude Code
checklistgithub/spec-kitCommand150ktodayMITA13Claude Code
clarifygithub/spec-kitCommand150ktodayMITA27Claude Code
specifygithub/spec-kitCommand150ktodayMITA13Claude Code
convergegithub/spec-kitCommand150ktodayMITA35Claude Code
implementgithub/spec-kitCommand150ktodayMITA14Claude Code
speckit.bug.fixgithub/spec-kitCommand150ktodayMITA12Claude Code