AGENT PM 포트폴리오 · 통합 운영 현황판 (ops-dashboard)

흩어진 프로젝트 이슈와 주간보고서를 한 화면에 모은 내부 운영 현황판 PM 프로젝트

제가 동시에 운영하는 프로젝트들의 GitHub 이슈와 주간보고서를 한 화면에서 보는 1인용 내부 도구입니다. 기획과 범위 정의, 이슈 운영, 설계 변경 판단을 맡았고 개발은 Claude Code와 협업했습니다.

역할기획, PM, 운영(1인). 개발은 Claude Code와 협업
기간2026-08-25 착수, 최근 기능 추가 2026-09-18
도구Next.js, Tailwind CSS, Vercel, GitHub REST API(Issues, Contents), GitHub Issues, Claude Code

핵심 숫자

11 / 15기획·설계 산출물 완료 (마켓리서치 생략, DB 설계서 해당 없음 제외).progress.md
1일착수부터 Vercel 배포와 도메인 연결까지 (커밋 기록 기준)git 커밋 이력 2026-08-25
7건운영 이슈 등록, 7건 모두 종료GitHub Issues #1~#7
34건커밋 (한국어 형식, 이슈 번호 연결)git 커밋 이력
4개연동한 GitHub 저장소 (블로그 2곳은 저장소 1개)lib/projects.config.ts
0건자체 DB 테이블 (DB 없음)PRD.md, CLAUDE.md

문제 정의

저는 학급사이트, AI 성분 케어, 블로그, 스토어 관리 등 여러 프로젝트를 동시에 운영합니다. 프로젝트마다 GitHub 저장소, 이슈, 주간보고서가 따로 있어서 "이번 주에 뭘 했고 뭐가 아직 안 끝났는지"를 보려면 저장소를 하나씩 열어야 했습니다. 특히 완료보고서 이후에는 이슈를 잘 쓰지 않아서, 끝난 일은 커밋에 남아도 안 끝난 일은 구조적으로 알 수 없었습니다. 먼저 Claude Artifact로 정적 대시보드를 만들어 봤지만, 볼 때마다 다시 만들어 달라고 요청해야 했습니다. 그래서 같은 화면을 열 때마다 최신 상태로 보여 주는 사이트로 바꾸는 것이 이 프로젝트의 목표였습니다.

화면별 기획 의도

아래 화면의 데이터는 모두 예시용 가짜 값입니다. 실제 프로젝트와 일정 정보는 들어 있지 않습니다.

PM으로서 한 일

범위와 기술 방향 정의

PRD와 착수보고서에서 범위 안과 밖을 나눴습니다. 이슈 자동 생성, 슬랙 알림, 다중 사용자 로그인은 범위 밖으로 두었습니다.
1인 내부 도구라서 마켓리서치는 생략하고, 자체 DB를 두지 않기로 했습니다. 두 결정 모두 진행 관리표에 사유를 남겼습니다.

리스크 관리

착수보고서에 리스크 5개를 표로 정리했습니다. 이슈를 안 쓰는 프로젝트가 안 보이는 문제, API 한도, 저장소 하나의 조회 실패, 토큰 노출, 도구가 안 쓰이게 될 가능성입니다.
각 리스크에 대응을 정했고, 그대로 화면 기능(실사용 지표, 오류 카드 분리)과 서버 구조로 반영했습니다.

이슈 운영

완료보고서 이후 기능 추가와 버그 수정도 이슈로 등록하는 규칙을 이 프로젝트에도 적용했습니다. 이슈 7건을 모두 커밋에 연결해 종료했습니다.
이슈를 모아 보여 주는 도구가 자기 이슈를 안 쓰면 모순이라는 점을 운영 기준으로 삼았습니다.

변경과 결함 대응

승인받은 프로토타입과 구현 결과의 디자인이 달라서, 프로토타입 기준으로 다시 이식하도록 요청했습니다.
여러 탭에서 일정이 사라지는 버그와 저장 방식 전환 요구를 각각 이슈로 분리해 처리했습니다.

의사결정 사례

01

브라우저가 아니라 서버가 GitHub를 호출하게 한 이유

이전 프로젝트(학급사이트)에서 브라우저가 외부 API를 직접 호출하다가 특정 네트워크에서 실패한 사례가 있었습니다. 같은 구조를 피하려고 GitHub 호출은 모두 서버 라우트가 대신하게 했고, GitHub 접근 토큰은 서버 환경변수로만 보관합니다. 브라우저에는 토큰이 전달되지 않습니다.

02

완료 목록에 이슈와 주간보고서 항목을 함께 보여 준 변경

기획서에는 이슈와 주간보고서를 성격이 다른 데이터로 보고 섞지 않는다고 적었습니다. 그런데 이슈를 쓰지 않는 프로젝트는 일을 해도 완료 0건으로 보였습니다. 그래서 완료 목록은 닫힌 이슈와 주간보고서의 금주 실적 행을 날짜순으로 합쳐 보여 주도록 바꿨습니다(2026-08-26 커밋). 기획 원칙을 그대로 지키기보다 실제 사용에서 드러난 빈틈을 먼저 메웠습니다.

03

개인 스케줄 저장 위치를 브라우저에서 저장소 파일로 바꾼 결정

처음에는 DB가 없는 구조에 맞춰 일정을 브라우저에 저장했습니다(#3). 그런데 여러 탭을 열어 두면 오래된 탭이 목록을 덮어써서 일정이 사라지는 버그가 났고(#5), 기기가 바뀌면 일정이 보이지 않았습니다. 그래서 서버 라우트를 통해 이 저장소의 파일에 저장하도록 바꿨습니다(#6). 이 사이트는 로그인이 없는 공개 접근이므로 민감한 정보는 등록하지 않기로 사용자 확인을 받고 진행했습니다.

04

구현 결과가 승인받은 디자인과 다를 때 프로토타입을 기준으로 삼은 결정

디자인 가이드 문서를 따라 구현했더니 이미 승인받은 Artifact 프로토타입과 색, 배치, 움직임이 달랐습니다. 문서를 고치는 대신 프로토타입의 실제 HTML과 CSS 값을 읽어서 그대로 옮기게 했습니다(#2). 승인된 결과물을 기준으로 두면 판단 기준이 하나로 정리됩니다.

회고

잘한 점새로 입력할 데이터를 만들지 않고, 이미 GitHub에 있는 이슈와 주간보고서만 읽어 오는 구조로 정했습니다. 자체 DB가 없어서 운영과 관리 부담이 없습니다.
아쉬운 점진행 관리표 기준으로 중간보고서, 테스트 시나리오, 테스트 결과보고서, 완료보고서는 아직 착수하지 않았습니다. 구현을 먼저 끝내고 검수 문서가 뒤로 밀렸습니다.
배운 점개인 도구는 기획서의 원칙보다 실제로 써 보면서 드러나는 빈틈이 더 중요했습니다. 완료 목록 통합과 스케줄 저장 방식 변경이 그 예입니다. 변경할 때마다 이슈에 이유를 남기는 습관이 판단 근거를 추적하는 데 도움이 됐습니다.