feat: add Factory Droid support

[enoreyes]

Summary

Add full plugin support for Factory Droid, enabling Superpowers to work as a native plugin with the same installation experience as Claude Code.

Changes

New Files

• .factory/plugin.json - Plugin manifest (mirrors .claude-plugin/plugin.json)
• .factory/marketplace.json - Marketplace manifest for plugin discovery
• .factory/INSTALL.md - Agent-readable installation instructions
• docs/README.droid.md - Complete installation guide

Updated Files

• README.md - Added Droid to Installation section with plugin commands

Installation

Same pattern as Claude Code:

/plugin marketplace add obra/superpowers
/plugin install superpowers@superpowers

After installation, users get:

• /superpowers:brainstorm - Interactive design refinement
• /superpowers:write-plan - Create implementation plan
• /superpowers:execute-plan - Execute plan in batches
• All skills auto-invoked based on task context

Why

Factory Droid is fully compatible with Claude Code's plugin system. Since Superpowers already has .claude-plugin/ configuration, adding .factory/ with the same structure provides native plugin support for Droid users.

Related

• Factory Droid: https://factory.ai
• Factory Docs: https://docs.factory.ai

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds Factory Droid documentation and two Factory metadata manifests. New docs describe installation (marketplace and manual), verification, components (skills, commands, agents), update steps, and troubleshooting. New JSON files provide plugin and marketplace metadata for Factory Droid.

Changes

Cohort / File(s)	Summary
Factory Droid documentation .factory/INSTALL.md, docs/README.droid.md, README.md	New documentation covering Quick Install via Plugin Marketplace, manual/development install steps, verification commands, installed components (Skills, Commands, Agents), update/restart guidance, and troubleshooting links.
Factory metadata manifests .factory/marketplace.json, .factory/plugin.json	New static JSON descriptors: .factory/marketplace.json defines a development marketplace entry and plugin listing; .factory/plugin.json provides plugin metadata (name, version, author, repo, license, keywords). Review for accuracy of metadata and links.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 I hopped through docs and left a trail,
Of plugins, installs, and a tiny tale.
Marketplaces hum, manifests sing,
The droid prepares to do its thing —
A rabbit's cheer for every build and trail!

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat: add Factory Droid support' directly and clearly summarizes the main change: adding support for Factory Droid through documentation and configuration files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 3

🤖 Fix all issues with AI agents

In @.factory/INSTALL.md:
- Around line 72-75: Replace the bare URLs under the "More Information" section
with proper Markdown links: change the plain text "Full documentation:
https://github.com/obra/superpowers/blob/main/docs/README.droid.md" to a
Markdown link (e.g., "Full documentation:
[README.droid.md](https://github.com/obra/superpowers/blob/main/docs/README.droid.md)")
and similarly convert "Factory Droid: https://factory.ai" to "Factory Droid:
[factory.ai](https://factory.ai)"; update the lines in the "More Information"
block so both entries use the bracketed link syntax rather than raw URLs.

In `@docs/README.droid.md`:
- Around line 223-227: The "Getting Help" section uses bare URLs; update the
list under the "## Getting Help" heading to use Markdown links instead (e.g.,
replace "https://github.com/obra/superpowers/issues" with a link like [Report
issues](https://github.com/obra/superpowers/issues),
"https://github.com/obra/superpowers" with [Main
documentation](https://github.com/obra/superpowers), and
"https://docs.factory.ai" with [Factory docs](https://docs.factory.ai)) so the
URLs become descriptive Markdown links.
- Around line 7-11: The fenced code block in README.droid.md lacks a language
tag; update the block that currently wraps the URL "Fetch and follow
instructions from
https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.factory/INSTALL.md"
to include a language identifier (e.g., use ```text) so the snippet renders
correctly and is treated as plain text.

[obra]

Hi @enoreyes — PR #139 already adds Factory Droid support and has an active conversation with the maintainer. Could you explain why you opened a new PR rather than reviewing or building on the existing one? Was there something about #139's approach that didn't work for you?

— Claude Opus 4.6, Claude Code 2.1.87

[obra]

Closing as a duplicate. Per the maintainer comment on 2026-03-29, this duplicates #139 (which had an active conversation with the maintainer). The author hasn't responded in ~30 days. Separately, the maintainer found in #1137 that Factory works natively with the existing Claude Code plugin without additional integration files, so the broader need is also unclear.

— Claude Opus 4.7, Claude Code 2.1.112