boston-harness-group/remote-factory

문서 · 시작 · 구성

당신이 원하는 것을 삭제 — 재:공장 설계 및 구축. Brainstorm은 스크래치의 아이디어, 기존 프로젝트를 위한 계획을 정제하거나 완전히 새로운 공장 모드를 만듭니다.

모든 국가는 현지 — .factory/]의 프로젝트입니다 ([T1]]), ~/.factory/]의 글로벌. 전체적인 딥 다이빙을 위한 건축물을 보십시오.

---

빠른 시작

** 필수품:** Python 3.11+, uv 및 Claude Code (설치 및 인증).

인증, 환경변수를 위한 전체 설정 가이드, 그리고 전 세계를 설치하는 이유에 대한 정당화.

---

디자인 모드

디자인 - 건물 앞에 뇌 폭풍

디자인 모드는 re:factory를 사용하는 1 차적인 방법입니다. 그것은 공간을 연구하고, Strategist를 통해 구조화 된 계획을 초안하고, 모든 코드가 작성되기 전에 그것을 결정합니다.

** 익지않는 아이디어 ** — 당신이 원하는 것을 설명하고 건축 가능한 spec로 정제:

** spec 파일에서 ** — 더 이상, 자세한 설명, .md] 파일에 아이디어를 작성하고 경로를 통과:

팁: 여러 단락, 요구 사항, 또는 연구 노트를 가진 상세한 아이디어는 인용 된 문자열 대신 spec 파일을 사용합니다. 파일 내용에 길이 제한이 없습니다.

Documentation · Getting Started · Configuration

Describe what you want — re:factory designs and builds it. Brainstorm an idea from scratch, refine a plan for an existing project, or create entirely new factory modes.

# Design — brainstorm an idea, refine it, then build
factory ceo "distributed eval runner" --mode design

# Iterate on an existing repo
factory ceo ~/my-project --mode design --focus "add WebSocket support"

# Create — build new factory modes and pipelines
factory ceo /path/to/factory --mode create --focus "PR validation pipeline"

# Outer Loop — evolve workflow topologies via MAP-Elites
factory outer-loop calibrate ~/my-factory \
  --benchmark featurebench \
  --population-size 3 \
  --project-dir /path/to/benchmark-instance \
  --test-command "pytest tests/ -v"

All state is local — per-project in .factory/ (add to .gitignore), global in ~/.factory/. See Architecture for the full deep-dive.

---

Quick Start

Prerequisites: Python 3.11+, uv, and Claude Code (installed and authenticated).

uv tool install git+https://github.com/akashgit/remote-factory.git

# Design — brainstorm an idea, refine it, then build
factory ceo "my idea" --mode design

# Improve an existing project — use design mode with a focus area
factory ceo /path/to/project --mode design --focus "issue # or area to improve"

See the full setup guide for authentication, environment variables, and justification for why we install globally.

---

Design Mode

Design — brainstorm before building

Design mode is the primary way to use re:factory. It researches the space, drafts a structured plan via the Strategist, and lets you iterate on it before any code is written.

From a raw idea — describe what you want and refine it into a buildable spec:

factory ceo "distributed eval runner" --mode design
factory ceo "Build a REST API for bookmark management" --mode design