이 레포, 나한테 필요한가?
사람 검수 전
- 무엇인가
- Sol Advisor는 AI 코딩 도구(Codex) 안에서 작동하는 지능형 작업 관리자예요.
- 마치 요리사가 여러 조리 도구를 상황에 맞게 선택하듯, Sol이 작업의 위험도를 평가하고 가장 적합한 AI 모델(Luna, Terra)에게 일을 분배해요.
- 개발자는 목표와 제약 조건만 알려주면, Sol이 계획 수립부터 구현, 검증, 승인까지 자동으로 처리해줍니다.
[README-001]- 할 수 있는 일
- AI 기반 소프트웨어 개발 워크플로우 [AI 해석]
- 진입 조건
- 고급자용 · Shell [분석]
- 먼저 확인
- Sol Advisor는 Codex CLI 환경에서만 작동하므로, 다른 AI 도구와의 호환성이 제한적입니다. [README-003]
이걸로 실제로 할 수 있는 일
기능명보다 사용자가 완성할 수 있는 작업과 결과를 우선해 정리했습니다.
AI 기반 소프트웨어 개발 워크플로우
Codex 환경에서 위험도 기반 라우팅을 통해 자동화된 개발 파이프라인 구축
멀티 에이전트 협업 시스템
Sol, Luna, Terra 등 여러 AI 에이전트가 역할을 나눠 복잡한 작업을 수행하는 시스템
자동 검증 및 승인 파이프라인
AI가 생성한 코드를 자동으로 검증하고 승인하는 CI/CD 파이프라인
기능보다 중요한 건
내 상황과의 적합성.
공식 기능과 시작 조건을 바탕으로 한 AI 판단입니다. 도입 전 원문과 실제 환경에서 다시 확인하세요.
- Codex CLI를 주 개발 도구로 사용하는 경우
- AI 에이전트 간 작업 분배와 자동화가 필요한 고급 사용자
- 위험도 기반 라우팅으로 개발 효율을 높이고 싶은 경우
- Codex 외의 AI 도구를 사용하는 경우
- 간단한 작업에 AI 오케스트레이션이 필요하지 않은 경우
- 팀 전체가 AI 에이전트 워크플로우에 익숙하지 않은 경우
기술과 도입 조건
자동 감지된 기술 스택, 문서 상태와 유지보수 메모를 한곳에 모았습니다.
Codex CLI · GPT-5.6 · jq · Shell Script
README에 설치 및 사용법이 설명되어 있지만, 예제 코드나 API 문서는 없습니다.
최근 24시간 내 push 기록이 있습니다. 유지보수 품질과 응답 속도는 별도 확인이 필요합니다.
코드 위험 신호를 확인하고 있습니다.
저장소를 실행하지 않고 공개 텍스트 파일과 설치 경로를 읽고 있습니다.
저장소 전체 정적 검사
커밋을 고정하고 저장소의 소스 파일 전체를 파일 단위로 확인합니다. 설치·빌드·실행은 하지 않습니다.
가장 짧은 시작 경로
- 01설치
Codex 플러그인 마켓에서 sol-advisor를 추가하고 설치 스크립트를 실행하세요.
- 02실행
새 Codex 작업에서 '$sol-advisor:orchestration' 프롬프트를 사용하여 Sol을 시작하세요.
GitExplain 자동 분석은 설치 명령을 직접 실행해 검증한 결과가 아닙니다.
아래 내용을 Codex 같은 코딩 에이전트에 붙여 넣으면 공식 문서를 다시 확인한 뒤 내 환경에 맞는 설치를 안내합니다.
너는 내 로컬 개발 환경에서 오픈소스 저장소를 안전하게 설명하고 설치하는 시니어 엔지니어야.
저장소: https://github.com/dannymac180/sol-advisor
GitExplain 요약: Sol Advisor는 AI 코딩 도구(Codex) 안에서 작동하는 지능형 작업 관리자예요. 마치 요리사가 여러 조리 도구를 상황에 맞게 선택하듯, Sol이 작업의 위험도를 평가하고 가장 적합한 AI 모델(Luna, Terra)에게 일을 분배해요. 개발자는 목표와 제약 조건만 알려주면, Sol이 계획 수립부터 구현, 검증, 승인까지 자동으로 처리해줍니다.
주요 언어: Shell
난이도 메모: 고급자용
해야 할 일:
1. 먼저 저장소의 최신 README, 설치 문서, manifest를 읽고 현재 기본 브랜치 기준으로 설명해줘.
2. 이 저장소가 무엇이고 내가 무엇을 만들 수 있는지 비개발자도 이해할 수 있게 짧게 설명해줘.
3. 내 운영체제와 기존 개발 환경을 먼저 질문한 다음, 가장 안전한 설치 방법을 단계별로 제시해줘.
4. 명령을 실행하기 전 각 명령이 바꾸는 것과 예상 결과를 알려줘. 파괴적인 명령은 자동 실행하지 마.
5. 필요한 API 키나 비밀 값은 채팅이나 코드에 직접 적게 하지 말고 환경 변수와 .env 예시로 안내해줘.
6. 설치 후 최소 예제를 실행해 성공 여부를 확인하고, 실패하면 오류 원인과 되돌리는 방법을 알려줘.
7. GitExplain 요약과 공식 문서가 다르면 공식 문서를 우선하고 차이를 명시해줘.
GitExplain이 정리한 시작 메모:
1. 설치: Codex 플러그인 마켓에서 sol-advisor를 추가하고 설치 스크립트를 실행하세요.
2. 실행: 새 Codex 작업에서 '$sol-advisor:orchestration' 프롬프트를 사용하여 Sol을 시작하세요.도입 전에 놓치기 쉬운 점
Sol Advisor는 Codex CLI 환경에서만 작동하므로, 다른 AI 도구와의 호환성이 제한적입니다.
[HIGH · README-003]GPT-5.6, jq 등 특정 도구와 높은 수준의 AI 모델 접근 권한이 필요합니다.
[MEDIUM · README-003]근거 원장
이 표는 원문이 어떤 분석 항목에 연결됐는지를 보여주며, 사실 정확도를 보증하는 점수는 아닙니다.
이 해설로 저장소를 이해하셨나요?
입력 내용 없이 선택 결과만 기록합니다.