boston-harness-group/remote-factory

Документация · Начало работы · Конфигурация

** Опишите, что вы хотите — перепроектируйте и создайте завод.** Мозговой штурм идеи с нуля, доработка плана существующего проекта или создание совершенно новых заводских режимов.

Все штаты являются локальными — каждый проект в .factory/ (добавить к .gitignore), глобальным в ~/.factory/. Архитектура для полного глубокого погружения.

Быстрый старт

Предпосылки: Python 3.11+, uv и Claude Code (установленный и аутентифицированный).

Полное руководство по настройке для аутентификации, переменные среды и обоснование того, почему мы устанавливаем глобально.

Дизайн-режим

Дизайн — мозговой штурм перед строительством

Режим проектирования является основным способом использования re:factory. Он исследует пространство, разрабатывает структурированный план через Стратег и позволяет вам повторять его перед написанием кода.

** Из сырой идеи ** — опишите, что вы хотите, и уточните его в конструктивную спецификацию:

** Из специального файла ** — для более длинных, более подробных описаний напишите свою идею в файл .md и пройдите путь:

** Совет: ** Для подробных идей с несколькими абзацами, требованиями или исследовательскими заметками используйте специальный файл вместо цитируемой строки. Нет ограничений по длине содержимого файла.

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