Skip to content

feat: add Factory Droid CLI integration (#822)#3587

Open
NurfitraPujo wants to merge 1 commit into
github:mainfrom
NurfitraPujo:feat/add-factory-droid-cli-support
Open

feat: add Factory Droid CLI integration (#822)#3587
NurfitraPujo wants to merge 1 commit into
github:mainfrom
NurfitraPujo:feat/add-factory-droid-cli-support

Conversation

@NurfitraPujo

Copy link
Copy Markdown

Adds a skills-based integration for the Factory Droid CLI alongside the existing Claude/Codex skills agents. The integration scaffolds .factory/skills/speckit-* directories, injects canonical --model/--output-format flags ahead of any operator-supplied extra args, and documents the install step in the devcontainer post-create script (mirroring the Kiro install layout, with a chained EXIT trap so both installer tmpfiles are released on script exit).

Includes:

  • src/specify_cli/integrations/droid/__init__.py (subpackage)
  • tests/integrations/test_integration_droid.py (46 tests, including regression coverage for the no-trailing-newline frontmatter fusion bug, idempotent skill injection, and env-var path resolution)
  • integrations/catalog.json entry + updated_at bump
  • Alphabetical registration in src/specify_cli/integrations/__init__.py and tests/integrations/test_registry.py
  • Devcontainer Droid install block with EXIT trap that re-invokes the Kiro cleanup handler

Closes #822

Assisted-by: Droid (oracle-reviewer)

Description

This PR add support for factory droid cli integration (https://factory.ai/product/cli)

Testing

since this is a new isolated module for adding new integration, I already added new tests cases to make sure the integration running correctly.

  • Tested locally with uv run specify --help
  • Ran existing tests with uv sync && uv run pytest
  • Tested with a sample project (if applicable)

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (describe below)

I use AI for research, planning, implementing, testing and reviewing the changes. I did review the research and plan results, but I don't do much on reviewing the implementation, it's majorly reviewed by AI.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Factory Droid CLI as a skills-based integration with workflow execution support.

Changes:

  • Registers Droid and scaffolds .factory/skills/.
  • Adds execution/frontmatter tests and catalog metadata.
  • Adds Droid installation to the devcontainer.
Show a summary per file
File Description
src/specify_cli/integrations/droid/__init__.py Implements Droid integration.
src/specify_cli/integrations/__init__.py Registers Droid.
tests/integrations/test_integration_droid.py Tests Droid behavior.
tests/integrations/test_registry.py Adds Droid to registry expectations.
integrations/catalog.json Adds Droid catalog metadata.
.devcontainer/post-create.sh Installs Droid CLI.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 6/6 changed files
  • Comments generated: 4
  • Review effort level: Medium

Comment thread .devcontainer/post-create.sh Outdated
Comment thread src/specify_cli/integrations/__init__.py
Comment thread src/specify_cli/integrations/droid/__init__.py Outdated
Comment thread src/specify_cli/integrations/droid/__init__.py Outdated

@mnriem mnriem left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please address Copilot feedback. If not applicable, please explain why. And fix test & lint errors

Adds a skills-based integration for the Factory Droid CLI alongside the
existing Claude/Codex skills agents. The integration scaffolds
`.factory/skills/speckit-*` directories and documents the install step
in the devcontainer post-create script via the official npm
distribution (`npm install -g droid`), which matches the layout of every
other CLI install block above and avoids executing an unverified remote
shell installer. The integration is also added to the user-facing
supported-agent table in `docs/reference/integrations.md` so the new key
is discoverable from the published documentation, as required by the
"Updating this documentation" guideline in AGENTS.md.

Operator-supplied extra args via `SPECKIT_INTEGRATION_DROID_EXTRA_ARGS`
are appended after the canonical Spec Kit flags so the canonical flags
are always present in argv. The Factory Droid CLI parser uses
last-wins duplicate-flag semantics (verified empirically against
droid 0.175.0), so a later operator-supplied value may override the
canonical one — this is a deliberate inversion of the cursor-agent /
opencode / codex ordering.

Includes:
- `src/specify_cli/integrations/droid/__init__.py` (subpackage)
- `tests/integrations/test_integration_droid.py` (46 tests, including
  regression coverage for the no-trailing-newline frontmatter fusion
  bug, idempotent skill injection, and env-var path resolution)
- `integrations/catalog.json` entry + `updated_at` bump
- Alphabetical registration in `src/specify_cli/integrations/__init__.py`
  and `tests/integrations/test_registry.py`
- Devcontainer Droid install block via the npm distribution
  (`npm install -g droid`), replacing the earlier curl-based installer
- User-facing supported-agent table row in
  `docs/reference/integrations.md` (key `droid`, `.factory/skills/`
  layout, `/speckit-<command>` invocation)
- `AGENT_CONFIG` entry and matching alphabetical entries in
  `tests/test_agent_config_consistency.py` (`ISSUE_TEMPLATE_AGENT_KEYS`)
  and the three issue-template dropdowns (`agent_request.yml`,
  `bug_report.yml`, `feature_request.yml`) so
  `test_issue_template_agent_lists_match_runtime_integrations` keeps
  the runtime/template surfaces synchronized

Closes github#822

Assisted-by: Droid (oracle-reviewer)
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Assisted-by: Droid (model: MiniMax M3, autonomous)
@NurfitraPujo
NurfitraPujo force-pushed the feat/add-factory-droid-cli-support branch from e0ed205 to dc31c57 Compare July 17, 2026 23:19
@NurfitraPujo
NurfitraPujo requested a review from mnriem July 17, 2026 23:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

add support for droid CLI

3 participants