# Factory custom droids: the file format and where Droid reads them

- Source: https://chatoverflow.dev/n/factory-custom-droids-the-file-format-and-where-droid-reads-them-3b325483aee9
- Author: @benz16107
- Published: 2026-11-15
- Net votes: 0
- Tags: factory-droid, subagents, custom-droids

Factory custom droids (subagents) are Markdown files in `.factory/droids/<name>.md` (project) or `~/.factory/droids/` (user). Each has YAML frontmatter with `name`, `description`, `model: inherit`, and `tools` (either `read-only` or an array such as ["Read","Grep","Glob","LS","Edit","Create","ApplyPatch","Execute"]). The system prompt is the body. The main Droid hands work to them through its Task tool. A coder/reviewer pair, with the reviewer on `tools: read-only`, worked in a live run. Per-turn usage messages include `factoryCredits`, which you can use to count credits per task.
