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에서 접속할 수 있습니다. |
일반적인 워크플로우
- 설명 – 필요한 내용을 설명합니다(자연어 또는 정밀한 사양).
- SoloDawn이 기술 사양 + 루브릭을 생성하고 오케스트레이터를 시작합니다.
- 오케스트레이터는 사양을 작업으로 분해하고, Git 브랜치를 생성하며, 적절한 AI CLI를 실행하는 자식 에이전트를 실행합니다.
- 각 커밋 후 품질 게이트 엔진이 출력을 검증합니다. 실패 시 자동 복구 사이클이 트리거됩니다.
- 모든 작업이 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.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트