에이전트 만들기

소개

시도하고자 했던 것과 그 이유를 알려주세요.

(내용 입력)

진행 방법## 시도하고자 했던 것과 그 이유

이번 프로젝트는 TODO를 입력하면 OMX/Codex가 자동으로 작업을 실행하고, 결과를 지식저장소 파일로 저장하는 로컬 대시보드를 만드는 것이었습니다.

처음에는 기능이 많았지만, 실제로는 사용자가 “뭘 눌러야 하는지”, “결과가 어디에 저장되는지”가 잘 보이지 않았습니다.

그래서 목표를 하나로 줄였습니다.

TODO 입력

→ OMX 실행

→ 결과 출력

→ 지식저장소에 파일 저장

이렇게 단순하게 만든 이유는, AI 에이전트를 많이 붙이는 것보다 결과가 눈에 보이고 파일로 남는 것이 더 중요하다고 판단했기 때문입니다.

———

# 진행 방법

## 어떤 도구를 사용했고, 어떻게 활용했나요?

사용한 도구는 다음과 같습니다.

- Codex

- 코드 분석, 수정, 검증에 사용

- OMX / oh-my-codex

- 에이전트 실행 흐름과 상태 관리에 사용

- Ralplan

- 구현 전에 계획/검토/합의 과정에 사용

- Ralph

- 계획을 실제 구현하고 끝까지 검증하는 데 사용

- Superpowers

- 최종 검증 기준으로 사용

- Graphify

- 코드 변경 후 프로젝트 구조 그래프 갱신에 사용

## 사용한 핵심 프롬프트

TODO에 입력하면 OMX가 프롬프트를 뿌려서 완성되면 지식저장소에 파일로 있는 것, 이거만 하자. 다른 건 안 바란다.

이 프롬프트를 기준으로 기능을 줄였습니다.

최종 흐름은 다음과 같습니다.

PRIMARY TODO 입력

→ 실행하고 지식저장소에 저장 버튼 클릭

→ /api/omx/plan 호출

→ /api/omx/run 호출

→ 결과 파일 저장

→ knowledge-store에 반영

## 캡처 화면

남겨두면 좋은 화면:

- PRIMARY TODO 입력 화면

- 실행하고 지식저장소에 저장 버튼

- 실행 후 done / partial / failed 상태 표시

- knowledge-store/.../SYNTHESIS.md 저장 경로

- 오른쪽 지식저장소 목록

———

# 결과와 배운 점

## 결과

최종적으로 다음 기능이 동작하게 만들었습니다.

TODO 입력

→ 버튼 한 번 클릭

→ OMX/Codex 실행

→ 결과 출력

→ 지식저장소 파일 저장

→ 지식저장소 목록 갱신

검증 결과도 확인했습니다.

- 대시보드 접속 성공

- Codex 로그인 상태 확인

- OMX 실행 성공

- 결과 파일 저장 성공

- /api/knowledge에 저장 결과 반영 확인

## 배운 점

가장 크게 배운 점은 기능이 많은 것보다 흐름이 명확한 것이 중요하다는 것입니다.

처음에는 에이전트, 프로젝트, 부서, 대시보드, 로그, KPI 등 많은 기능을 넣으려 했습니다.

하지만 실제 사용자는 결국 하나를 원했습니다.

입력하면 결과가 나오고, 파일로 저장되는 것

## 시행착오

겪은 시행착오는 다음과 같습니다.

- 기능을 너무 많이 넣어서 핵심 흐름이 흐려짐

- 결과가 화면에 보이지 않아 “된 건지 안 된 건지” 알기 어려웠음

- 저장 위치가 명확하지 않았음

- 계획 없이 바로 구현하려다 방향이 자주 바뀜

- “숨기기”와 “삭제”를 구분해야 했음

그래서 기존 기능은 삭제하지 않고, 고급 기능 안으로 숨겼습니다.

## 나만의 꿀팁

AI 도구를 쓸 때는 처음부터 큰 시스템을 만들기보다 이렇게 줄이는 게 좋았습니다.

입력 1개

버튼 1개

결과 1개

저장 위치 1개

그리고 반드시 결과물을 파일로 남겨야 합니다.

그래야 나중에 다시 찾고, 검증하고, 이어서 작업할 수 있습니다.

## 앞으로의 계획

앞으로는 다음을 개선하면 좋을 것 같습니다.

- 실행 결과 화면 캡처 자동 저장

- 실패 원인 더 자세히 표시

- 지식저장소 검색 개선

- 저장된 결과를 다시 TODO로 이어서 실행하는 기능

- ClawPort UI처럼 상태/진단 화면 강화

———

# 도움 받은 글 / 참고 사례

참고한 외부 사례:

https://github.com/JohnRiceML/clawport-ui

ClawPort UI를 보면서 배운 점은, AI 에이전트 도구도 결국 사용자가 보기에는 하나의 명확한 제품 흐름이어야 한다는 점이었습니다.

어떤 도구를 사용했고, 어떻게 활용하셨나요?

Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.

Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.

Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)

(내용 입력)

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

과정 중에 어떤 시행착오를 겪었나요?

도움이 필요한 부분이 있나요?

앞으로의 계획이 있다면 들려주세요.

(내용 입력)

도움 받은 글 (옵션)

참고한 지피터스 글이나 외부 사례를 알려주세요.

(내용 입력)

뉴스레터 무료 구독