이정마 로고이정마 로고 텍스트
모바일
금융
IT
라이프
로그인 중...
AI Architecture / Dev 가이드·약 10분 내외

OpenCode와 Ouroboros 완벽 가이드: TUI 슬래시 커맨드, MCP 연동, 그리고 턴키 자동화 파이프라인의 실무 원리

OpenCode에서 /ooo가 안 뜰 때의 원인부터 Ouroboros의 4단계(인터뷰·Seed·QA·실행) 파이프라인, TUI 모니터 관람법, 그리고 터미널 셸과 대화형 에이전트의 실무 의사결정 트리를 건축 시공 비유로 완벽 정리합니다.

아키텍처 구조도

다이어그램 렌더링 중...

1. 전원주택 건축에 빗대어 보는 Ouroboros 핵심 원리

💡 생활 비유: 턴키(Turn-key) 전원주택 건축 프로젝트

Ouroboros의 4단계 자동화 파이프라인은 집을 짓는 과정과 완벽히 일치합니다.

•1. 사전 인터뷰 (interview): 건축주(개발자)와 설계사(AI)의 심층 미팅입니다. "방 몇 개인가요? 지하 주차장이 필요한가요?"처럼 애매한 부분을 집요하게 질문해 모호성을 없앱니다.

•2. 설계 청사진 (seed.yaml): 확정된 요구사항을 바탕으로 작성된 정밀 설계도면입니다. 각 방의 크기와 마감재, 수용 조건(AC)이 YAML로 명시됩니다.

•3. 감리 도면 심사 (qa): 구청과 감리원의 엄격한 안전/품질 심사입니다. 도면에 누락이나 모순이 없는지 채점(기본 80점/0.8 이상)하고 미달 시 도면을 수리(Repair)합니다.

•4. 시공 및 착공 (run): 도면이 통과되면 시공사(OpenCode 코딩 에이전트)가 투입되어 실제 벽돌을 쌓고 배관을 연결하듯 소스코드를 작성하고 테스트를 완수합니다.

•턴키 패키지 (auto): 상담부터 도면, 감리, 완공까지 원스톱으로 끝내는 올인원 서비스입니다.

•현장 CCTV 룸 (tui monitor): 공사 현장을 관람할 수 있는 실시간 모니터링 화면입니다.

많은 사용자가 "seed 명령어를 직접 쳐야 파일이 생기는가?"라고 오해하지만, auto 명령어를 쓰면 인터뷰부터 Seed 생성, QA 통과, 실제 코드 실행까지 멈추지 않고 한 번에 수행됩니다.

2. TUI 슬래시 커맨드 vs 스킬 vs 셸 명령어 차이

OpenCode와 Ouroboros를 함께 쓸 때 혼동하기 쉬운 인터페이스 개념을 명확히 정리합니다.

OpenCode TUI (/ooo, 자연어)

  • •TUI는 터미널 안에서 실행된 대화형 채팅 화면을 의미함
  • •/ooo는 셸 명령어가 아닌 프롬프트 템플릿(상용구 단축키)
  • •사용자가 지시하면 에이전트가 내부 MCP 도구를 호출
  • •대화하면서 점진적으로 요구사항을 다듬을 때 최적

터미널 셸 직접 타건 (CLI)

추천
  • ✓OpenCode 밖의 일반 bash 셸 프롬프트에서 직접 실행
  • ✓ouroboros auto "목표" 형태로 원스톱 백그라운드 구동
  • ✓인터뷰 질의응답을 터미널 인풋으로 바로 입력
  • ✓대규모 기능을 턴키 방식으로 통째로 맡길 때 최적

📌 /o만 쳤을 때 /ooo가 자동완성에 안 뜨는 이유

•~/.config/opencode/commands/ooo.md 파일이 정상 존재하더라도, OpenCode 실행 세션의 TUI 인덱싱 타이밍 이슈로 인해 자동완성 팝업에 즉시 나타나지 않을 수 있습니다.

•이 경우 OpenCode TUI를 완전히 종료 후 재시작하거나, Ctrl+P 커맨드 팔레트에서 명령어를 검색하여 확인할 수 있습니다.

•또한 /ooo 커맨드를 치지 않고 지금 채팅창처럼 "ooo로 인증 기능 만들어줘"라고 자연어로 말해도 Skill(SKILL.md)이 자동 로드되어 동일하게 동작합니다.

3. 4단계 실행 방식 의사결정 트리 (Decision Tree)

프로젝트 규모와 작업 성격에 따라 Ouroboros를 구동하는 최적의 방식을 결정하는 4단계 트리아지입니다.

4단계 분기형 의사결정 트리 (Ouroboros Workflow Decision Tree)

다이어그램 렌더링 중...
01

턴키 자동화 (Full Auto Pipeline)

목표가 명확하고 큰 기능 단위라면 ouroboros auto를 터미널에서 실행해 원스톱으로 코드를 생성합니다.

02

점진적 대화 (TUI & MCP Interaction)

요구사항을 개발자와 AI가 티키타카로 조율하고 싶다면 OpenCode TUI 채팅창에서 /ooo로 진행합니다.

03

도면 사전 검토 (Seed Inspection)

인수 조건(AC)을 개발자가 직접 통제해야 한다면 --skip-run으로 seed.yaml만 먼저 뽑아 수정한 뒤 run으로 시공합니다.

04

실시간 관람 (Live Monitoring)

작업이 백그라운드에서 진행될 때 별도 분할 창에서 ouroboros tui monitor로 실시간 이벤트를 관람합니다.

4. 실무 필수 명령어 및 상태 점검 레시피

Ouroboros 환경이 정상인지 진단하고, 실무에서 바로 쓸 수 있는 핵심 명령어 모음입니다.

시스템 헬스체크
# Ouroboros 환경 및 DB 정상 여부 진단
ouroboros status health
올인원 턴키 실행
# 인터뷰 -> Seed 생성 -> QA 검증 -> 코드 작성/테스트까지 원스톱 실행
ouroboros auto "JWT 기반 사용자 인증 및 토큰 갱신 API 구현" --runtime opencode
도면만 먼저 생성
# 1. 인터뷰 후 seed.yaml만 뽑고 멈추기
ouroboros auto "사용자 인증 API" --skip-run

# 2. 사람이 직접 seed.yaml 검토 및 수정 후 실행
ouroboros run seed.yaml
실시간 TUI 대시보드
# 별도 터미널 창에서 세션 진행 로그 실시간 관람
ouroboros tui monitor

5. 작업 도중 및 완료 후 추가 요청 팁

💡 작업 도중이나 완료 후에 추가 요구사항이 생기면?

•진행 도중 (인터뷰 단계): 터미널 프롬프트에 추가 제약조건이나 예외 처리 요구를 자유롭게 텍스트로 입력하면 반영됩니다.

•세션 재개: 이전에 중단되었거나 추가 작업이 필요하면 ouroboros auto --resume <세션ID>로 맥락을 이어갑니다.

•OpenCode TUI 연계: Ouroboros가 작성한 결과 코드를 바탕으로 지금 이 채팅창에서 "방금 만든 인증 코드에 Redis 블랙리스트 기능도 추가해줘"라고 자연어로 요청하면 에이전트가 즉시 코드를 이어받아 수정합니다.

✕흔히 하는 실수

  • ✕auto 실행 후 인터뷰 질문에 무응답하여 타임아웃 발생
  • ✕/ooo가 셸 명령어인 줄 알고 터미널 bash에 그대로 타이핑
  • ✕seed 명령어를 인터뷰 없이 단독으로 실행하려다 에러 마주침

✓권장 실무 패턴

  • ✓큰 기능은 ouroboros auto로 뼈대와 테스트를 턴키 구축
  • ✓세부 튜닝은 OpenCode TUI 채팅창에서 대화형으로 점진적 개선
  • ✓ouroboros status health로 DB와 런타임 연결 상태 수시 점검

이정마 에디터

AI System Architect

AI에게 복잡한 요구사항을 맡길 때, 인터뷰를 통한 모호성 제거와 품질 감리(QA)를 거쳐 자동 시공(Run)까지 이어지는 파이프라인을 이해하면 개발 생산성이 비약적으로 향상됩니다.