Factory Droid — Components
Named Primitives
1. AGENTS.md
Project-level instruction file at the repo root. Teaches agents "everything they need to know about your project with a single Markdown file." Scoped to project; read at session start.
2. Custom Droids (Subagents)
Files: .factory/droids/<name>.md (project-scoped) or ~/.factory/droids/<name>.md (personal).
Format: YAML frontmatter + Markdown body.
Frontmatter fields: name, description, model (inherit or specific), tools (read-only or full).
Invoked by the parent droid; bidirectional context sharing.
3. Skills
Files: .factory/skills/<name>/SKILL.md (project) or ~/.factory/skills/<name>/SKILL.md (personal).
Reusable capabilities Droid can invoke on demand. Compatible with Agent Skills open standard (agentskills.io).
Shareable via Plugins.
4. Hooks (9 events)
| Event |
Phase |
| PreToolUse |
Before any tool call |
| PostToolUse |
After any tool call |
| UserPromptSubmit |
On user prompt submission |
| Notification |
On notification |
| Stop |
On agent stop |
| SubagentStop |
On subagent stop |
| PreCompact |
Before context compaction |
| SessionStart |
On session start |
| SessionEnd |
On session end |
Stored in ~/.factory/hooks/ (global) or project-local hooks directory.
Philosophy: "turn suggestions into app-level code that executes every time it is expected to run."
5. Factory Missions
Accessed via /missions command.
Phases: collaborative planning → feature list + milestone ordering → Mission Control orchestration view → feature workers + validation workers.
Key insight from docs: "The biggest value we have found in Missions is in the planning phase. Getting the upfront plan right — the features, the ordering, the milestones, the skills involved — is what determines whether the execution succeeds."
6. Mixed Models (Specification Mode)
/model command → configure separate model for Specification planning vs. default coding model.
Allows high-capability model for spec generation, efficient model for implementation.
7. Custom Slash Commands
Project-defined or personal commands extending the default / command set. Stored in .factory/ directory structure.
8. Plugins
Shareable packages bundling skills, commands, and tools. Install via plugin registry.
9. Droid Computers
Persistent cloud or local machines for long-running tasks. Persistent state across sessions; Droid can "spin up" a computer for extended work.
10. AutoWiki
Automatic repository documentation generation. Integrates with GitHub/GitLab/Bitbucket. Keeps wiki in sync with codebase changes.
11. Droid Control
Browser and terminal automation for QA workflows. Enables agents to control web browsers and terminal sessions for end-to-end testing.
12. Droid Shield
Automatic secret detection — scans outputs/commits for leaked credentials and API keys before exposure.
Droid Shield Plus: Enhanced tier with Palo Alto Networks Prisma AIRS integration for enterprise security posture.
13. Agent Readiness
Command: /readiness-report
Measures repository maturity and tracks autonomy progress. Scores how well a repo is prepared for autonomous agent work. Implies a progression model: teams improve their repos over time to enable more autonomous execution.
14. MCP Integration
Any external MCP server can be connected. MCP Manager (introduced in v1.8) provides UI for managing MCP server connections.
15. BYOK (Bring Your Own Key)
Supported providers: Anthropic, OpenAI, Ollama, Groq, DeepInfra, Fireworks, Baseten, Hugging Face, OpenRouter.
16. IDE Integrations
- JetBrains IDEs
- Zed
- (VS Code implicit via CLI)
17. GitHub/GitLab/Bitbucket Integrations
Automated PR reviews, AutoWiki sync.
18. Slack Integration
Workspace context ingestion, notifications.
19. Linear Integration
Planning and issue tracking synchronization.
Component Hierarchy
Factory Platform
├── Droid CLI (droid)
│ ├── AGENTS.md (project instructions)
│ ├── Custom Droids (.factory/droids/)
│ ├── Skills (.factory/skills/)
│ ├── Hooks (~/.factory/hooks/)
│ ├── Commands (custom slash)
│ └── Plugins
├── Factory App (desktop)
├── Droid Exec (headless/CI)
├── Factory App (web/cloud)
│ ├── Droid Computers
│ ├── Mission Control
│ ├── AutoWiki
│ └── Agent Readiness
└── Security Layer
├── Droid Shield
└── Droid Shield Plus