This repository provides a set of reusable Factory.ai custom droids that you can drop into your project to delegate specialized tasks. Each droid is defined in the .factory/droids directory as a Markdown file with YAML front‑matter.
- Enable custom droids – In the Factory CLI, run
/settingsand toggle Custom Droids under the experimental section. Restart the CLI afterward. - Install the droids – Copy the
.factory/droidsdirectory from this repository into the root of your project (e.g.<repo>/.factory/droids/). Alternatively, place the files in your personal directory~/.factory/droids/if you want them available globally. - Reload – Run
/droidsin the CLI to see the list of available droids and verify that they loaded correctly.
A mystical systems advisor that foresees the consequences of complex engineering decisions. Call on it for architecture reviews, deep debugging, and strategic guidance where you need trade-offs, hidden risks, and follow-on work illuminated. It works read-only, asks for any missing artifacts before proceeding, and hands off tasks that are better served by simpler droids.
Invocation example:
Run the subagent `seer` to scry the auth stack and surface hidden coupling risks before we refactor.
Performs in‑depth reviews of diffs. Summarizes the intent of the change, flags correctness risks, missing tests, and migration fallout, and calls out follow‑up actions.
Invocation example:
Use the subagent `code-reviewer` on the staged diff.
Scans recently edited files for insecure patterns and suggests mitigations. It identifies injections, insecure transport, privilege escalation and secrets exposure, and links to relevant CWE entries when possible.
Invocation example:
Run `security-sweeper` to audit the changed files in this patch for security issues.
Helps you design new features or refactorings. When given a goal, it proposes a high‑level architecture (modules, APIs, data flows), identifies risks and dependencies, and outlines implementation steps.
Invocation example:
Ask the subagent `architecture-planner` to propose a high-level design for adding real-time collaboration to our app.
To define your own droid, create a new Markdown file in .factory/droids/ with YAML front‑matter specifying at least name, and optionally description, model and tools. After the front‑matter, write a clear system prompt describing how the subagent should behave. See the files in this repository for reference.