huanchong-99/SoloDawn

Catches and repairs AI hallucinations before delivery: three quality gates, 31 built-in rules, a self-healing loop and a 90-point acceptance review. Fully automated from requirement to merged code. A primary Agent dynamically spawns and orchestrates child Agents on the AI CLIs on your machine (Claude Code, Codex — 8 supported).

SoloDawn – 자동화된 AI 기반 소프트웨어 개발

개요 – SoloDawn은 제품에 대한 자연어 설명을 완전한 프로덕션 준비 상태의 코드베이스로 변환하는 오픈 소스 웹 애플리케이션(Rust 백엔드 + React 프론트엔드)입니다. 이 도구는 코드를 직접 생성하는 대신, 사용자가 이미 설치한 실제 AI 기반 명령줄 도구(Claude Code, Codex 등)를 오케스트레이션합니다.

작동 방식

  • 주요 "오케스트레이터" 에이전트가 Git 저장소를 모니터링합니다. 요구 사항을 제출하면, 이를 기술 사양 및 채점 루브릭으로 변환합니다.
  • 오케스트레이터는 필요에 따라 자식 에이전트를 생성합니다. 각 자식 에이전트는 네이티브 PTY(터미널)에서 AI CLI를 실행하며 코드 작성, 리뷰, 버그 수정, 병합 등 구체적인 작업을 수행합니다.
  • 작업은 병렬 Git 브랜치로 나뉩니다(작업당 하나씩). 모든 커밋 후 코드는 세 단계의 품질 게이트를 통과해야 합니다(터미널 → 브랜치 → 저장소).
  • 모든 작업이 루브릭 기준(≥ 90 점)을 충족하면 변경 사항이 메인 브랜치로 병합되고 제품이 인도됩니다.

주요 특징

Feature Why it matters
2계층 에이전트 아키텍처 주요 에이전트가 자식 에이전트의 생성 시점과 수를 결정하므로, 경직된 사전 정의 워크플로우를 제거합니다.
네이티브 CLI 통합 SoloDawn은 사용자가 이미 사용하는 실제 AI CLI를 실행하므로, 모든 플러그인, 기술 및 MCP 서버 설정을 재설정할 필요가 없습니다.
완전 자동화 또는 수동 모드 시스템을 엔드 투 엔드로 실행하거나, 사용자 정의 워크플로우 그래프를 통해 개입할 수 있습니다(터미널, 모델, 슬래시 명령어 등 선택 가능).
품질 시스템 31개의 내장 규칙, 3단계 게이트 체크포인트, 자가 치유 루프 및 90점 수락 루브릭을 통해 환각, 보안 취약점 및 병합 충돌을 제어합니다.
확장 가능한 병렬성 각 작업이 개별 워크트리에 격리된 최대 ~10개의 동시 작업 브랜치를 지원하여 대규모 프로젝트를 더 빠르게 구축할 수 있습니다.
Docker로 배포 가능 원클릭 설치 스크립트가 server-runner-Redis 스택을 설정합니다. UI는 http://localhost:23457에서 접속할 수 있습니다.

일반적인 워크플로우

  1. 설명 – 필요한 내용을 설명합니다(자연어 또는 정밀한 사양).
  2. SoloDawn이 기술 사양 + 루브릭을 생성하고 오케스트레이터를 시작합니다.
  3. 오케스트레이터는 사양을 작업으로 분해하고, Git 브랜치를 생성하며, 적절한 AI CLI를 실행하는 자식 에이전트를 실행합니다.
  4. 각 커밋 후 품질 게이트 엔진이 출력을 검증합니다. 실패 시 자동 복구 사이클이 트리거됩니다.
  5. 모든 작업이 90점 이상을 기록하면, SoloDawn이 변경 사항을 자동 병합하고 완성된 제품을 제시합니다.

실행을 위해 필요한 사항

  • Rust nightly (2025‑12‑04) 툴체인
  • Node ≥ 18 (pnpm 10.13.1 포함)
  • Git
  • 지원되는 모든 AI CLI(Claude Code, Codex, Amp, Cursor Agent, Qwen Code, GitHub Copilot, Droid, Opencode). 시스템은 단일 워크플로우에서 최대 8개의 CLI를 혼합하여 사용할 수 있습니다.

현재 상태

  • 버전 1.0은 신규 구축, 마이그레이션, 리팩토링 및 보안 강화 작업을 포함하는 48시간 완전 자율 테스트를 통과했습니다. 7/7개 작업을 수행했으며 평균 점수는 88.85/A였습니다.
  • 문서는 코딩 AI에 붙여넣어 SoloDawn을 설치하고 시작할 수 있는 "Run It For Me" 프롬프트를 포함합니다.

대상 사용자

  • "가상 개발 팀"을 원하는 1인 개발자 또는 1인 스타트업.
  • 이미 AI 지원 CLI를 사용 중이며, 도구 재설정 없이 엔드 투 엔드 워크플로우를 자동화하고 싶은 팀.

빠른 시작 스니펫 (AI 어시스턴트에 복사-붙여넣기)

Help me install and RUN SoloDawn locally. I want to USE it, not modify its source.

Repository: https://github.com/huanchong-99/SoloDawn
Clone: git clone https://github.com/huanchong-99/SoloDawn.git

Detect my OS (Windows / Linux / macOS) and do whatever is needed to get the web UI open at http://localhost:23457:
1. Install Rust nightly-2025-12-04, Node ≥ 18, pnpm 10.13.1, Git.
2. Run `./install.sh` (or the Docker installer) and start the server.
3. Open the browser at the URL above.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트