mirror of https://github.com/LerianStudio/ring synced 2026-04-21 21:47:49 +00:00

feat(installer): introduce python-based multi-platform installer

refactor(installer): introduce adapter and transformer architecture
fix(security): harden installer against path traversal and symlinks
docs: add comprehensive guides for multi-platform support and migration
fix(beads): improve stop hook logic to check for open issues

2025-11-27 18:20:53 -03:00

3.3 KiB

Raw Blame History

Ring for Factory AI

Factory AI uses droids instead of agents. Ring transforms agent definitions to droid format during installation.

Installation

# Interactive installer
./installer/install-ring.sh

# Direct install
./installer/install-ring.sh install --platforms factory

# Multiple platforms
./installer/install-ring.sh install --platforms claude,factory

Installation Path

Ring installs to: ~/.factory/

~/.factory/
├── droids/                      # Transformed from agents/
│   ├── code-reviewer.md
│   ├── business-logic-reviewer.md
│   ├── security-reviewer.md
│   ├── backend-engineer-golang.md
│   └── ... (20 droids)
├── commands/                    # Slash commands
├── skills/                      # Skills (unchanged)
└── .ring-manifest.json          # Installation tracking

Transformations

Agents → Droids

Ring automatically transforms:

Claude Code	Factory AI
`agents/`	`droids/`
`subagent_type`	`droid_type`
"agent" references	"droid" references

Example transformation:

Claude Code (original):

---
name: code-reviewer
description: Foundation review agent
---
Use this agent for code quality review...

Factory AI (transformed):

---
name: code-reviewer
description: Foundation review droid
---
Use this droid for code quality review...

Skills (Unchanged)

Skills transfer directly without transformation. The workflow logic, triggers, and content remain identical.

Commands (Minor adjustments)

Commands receive terminology updates:

"dispatch agent" → "dispatch droid"
"subagent" → "subdroid"

Usage in Factory AI

Invoking Droids

Task tool with droid_type="ring-default:code-reviewer"
Task tool with droid_type="ring-dev-team:backend-engineer-golang"

Using Skills

Skill tool: "ring:test-driven-development"
Skill tool: "ring:systematic-debugging"

Running Commands

Commands work the same as Claude Code:

/ring-default:codereview
/ring-default:brainstorm

Feature Parity

Feature	Claude Code	Factory AI
Skills	46	46
Agents/Droids	20	20
Commands	14	14
Hooks	Full	Limited
Auto-discovery	Yes	Yes

Note: Factory AI hook support may vary. Check Factory AI documentation for hook compatibility.

Updating

# Check for updates
./installer/install-ring.sh check

# Update Factory AI installation
./installer/install-ring.sh update --platforms factory

Uninstalling

./installer/install-ring.sh uninstall --platforms factory

Troubleshooting

Droid not found

Verify installation: ./installer/install-ring.sh list
Check droids directory: ls ~/.factory/droids/
Use fully qualified name: ring-dev-team:backend-engineer-golang

Terminology mismatch

If you see "agent" where "droid" is expected, re-run the installer:

./installer/install-ring.sh install --platforms factory --force

Dual Installation

You can install Ring to both Claude Code and Factory AI:

./installer/install-ring.sh install --platforms claude,factory

Each platform maintains its own manifest and installation. Updates are platform-independent.

3.3 KiB Raw Blame History