https://github.com/gitmaxd/flowfactory
Scaffold FlowFactory workflow system into your project
https://github.com/gitmaxd/flowfactory
Last synced: 5 months ago
JSON representation
Scaffold FlowFactory workflow system into your project
- Host: GitHub
- URL: https://github.com/gitmaxd/flowfactory
- Owner: Gitmaxd
- License: mit
- Created: 2025-12-31T23:21:37.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-31T23:52:35.000Z (6 months ago)
- Last Synced: 2026-01-05T12:33:56.600Z (5 months ago)
- Language: Shell
- Size: 60.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FlowFactory
Scaffold the FlowFactory workflow system into any project.
[](https://www.npmjs.com/package/flowfactory)
[](https://opensource.org/licenses/MIT)
## Installation
```bash
npx flowfactory init
```
Or install globally:
```bash
npm install -g flowfactory
flowfactory init
```
## What Gets Installed
FlowFactory adds a `.factory/` directory with:
- **Commands**: `/flow:plan`, `/flow:work`, `/flow:impl-review`, `/flow:resume`, `/flow:check`, `/flow:status`
- **Droids**: Research agents (repo-scout, practice-scout, docs-scout, context-scout, flow-gap-analyst, quality-auditor)
- **Skills**: Workflow logic for planning, execution, and review
## Safety
FlowFactory **never overwrites existing files**. If `.factory/` already exists, only new files will be added. Existing files are always preserved.
## Usage
After installation:
```bash
# Plan a feature
/flow:plan Add user authentication
# Execute a plan
/flow:work plans/add-user-auth.md
# Review your implementation
/flow:impl-review
```
## Documentation
- [FlowFactory.dev](https://flowfactory.dev)
- [Full Documentation](.factory/README.md) (after init)
## Options
```bash
flowfactory init [options]
Options:
--path Target directory (default: current directory)
--force Skip confirmation prompts
--help Show help
--version Show version
```
## Requirements
- Node.js >= 18
- Works with Factory.ai Droid, Claude, and other AI coding assistants
## License
MIT
## Credits
FlowFactory is built upon the excellent foundation of [Flow](https://github.com/gmickel/gmickel-claude-marketplace) by [Gordon Mickel](https://github.com/gmickel), originally created as a Claude Code plugin.
This project adapts and extends that work for the Factory.ai Droid ecosystem, bringing the same disciplined workflow approach to a broader range of AI coding assistants.
We gratefully acknowledge Gordon's forward work in creating structured workflows for AI agents.
## Author
[GitMaxd](https://github.com/Gitmaxd) · [@gitmaxd](https://x.com/gitmaxd)
---