AI 에이전트를 위한 크로스 플랫폼 프로젝트 관리 시스템 구축기

AI 에이전트와의 대화를 통해 복잡한 프로젝트를 관리하려고 시도해 본 적이 있나요? 상황은 대략 이렇습니다. 에이전트에게 무언가를 만들어 달라고 요청하면 작업을 시작하지만, 당신이 컨텍스트 (Context)를 전환했다가 다시 돌아오면 에이전트는 이전에 무슨 일이 일어나고 있었는지 전혀 알지 못합니다.

저는 이 문제에 끊임없이 직면했습니다. 그래서 OpenClaw, Claude Code, Codex CLI, Cline, 그리고 Gemini CLI 전반에서 작동하는 파일 기반 프로젝트 관리 시스템인 Project Overseer를 구축했습니다.

핵심 문제 (The Core Problem)

AI 에이전트는 세션 간에 지속적인 메모리 (Persistent Memory)가 없습니다. 작업을 전환하는 순간 컨텍스트 (Context)를 잊어버립니다. 전통적인 프로젝트 관리 도구들 (Jira, Notion, Linear)은 에이전트가 아닌 인간을 위해 설계되었습니다.

해결책: 파일 기반 컨텍스트 격리 (File-Driven Context Isolation)

에이전트의 대화 메모리에 의존하는 대신, Project Overseer는 프로젝트 상태의 모든 조각을 일반 텍스트 파일에 저장합니다:

projects/my_project/
├── plan.md          # 전체 WBS (Work Breakdown Structure) 상세 내역
├── status.json      # 현재 상태, 리스크, 의존성
...

각 하위 작업 (Sub-task)은 별도의 파일입니다. 에이전트는 자신에게 필요한 것만 로드합니다. 작업을 전환할 때, 에이전트는 현재 진행 상황을 저장하고, 컨텍스트를 비운 뒤, 다음 작업 파일을 로드합니다.

5단계 상태 머신 (5-Phase State Machine)

1. 요구사항 수집 (Requirements Collection) — 에이전트가 계획을 세우기 전에 명확한 질문을 던집니다.
2. WBS 상세화 (WBS Breakdown) — 각 작업에 대해 공수 산정 (Effort Estimation), 타당성 분석 (Feasibility Analysis), 기술 요구사항 (Tech Requirements)을 할당합니다.
3. 사용자 검토 (User Review) — 실행이 시작되기 전 사용자가 검토하고 승인합니다.
4. 하위 작업 실행 (Sub-task Execution) — 완전한 컨텍스트 전환과 함께 작업들이 하나씩 실행됩니다.
5. 프로젝트 완료 (Project Complete) — 모든 작업이 완료되면 프로젝트를 아카이브 (Archive)할 수 있습니다.

핵심 차별점: 영향력 출력 및 전파 (Impact Output & Propagation)

하위 작업이 완료되면, 에이전트는 자동으로 6가지 카테고리의 작업 간 영향력 (Cross-task Impact)을 추출하여, 이를 모든 의존 작업에 시작 전 노트 (Pre-start notes)로 전파합니다. 이를 통해 프로젝트 전체에서 명명 충돌 (Naming Conflicts)과 설계 불일치 (Design Inconsistencies)를 방지합니다.

변경 관리 (Change Management)

• Bottom-up (상향식): 하위 작업 (Sub-task)이 완료된 작업들과의 충돌을 발견하면, 이를 해제하도록 선제적으로 요청합니다.
• Top-down (하향식): 마스터 대시보드에서 "change requirement (요구사항 변경)"라고 말하면, 에이전트가 변경 사항을 실행하기 전에 모든 작업에 걸쳐 전체 영향도 평가 (Impact Assessment)를 수행합니다.

Zero Setup Required (설정 불필요)

API 키도, 외부 서비스도, 데이터베이스도 필요 없습니다. 그저 SKILL.md 파일을 프로젝트에 넣기만 하면 됩니다.

Compatible Platforms (호환 플랫폼)

OpenClaw, Claude Code, Codex CLI, Cline / RooCode, Gemini CLI

Quick Start (빠른 시작)

1. "project overseer"라고 말하여 시작합니다.
2. 요구사항 질문에 답변합니다.
3. WBS (Work Breakdown Structure, 작업 분할 구조) 분해를 위해 "requirements done"이라고 말합니다.
4. 실행 단계로 진입하기 위해 "approved"라고 말합니다.
5. 시작하기 위해 "start"라고 말합니다.
6. 대시보드를 확인하려면 "back to master"라고 말합니다.

Links (링크)

• GitHub: https://github.com/tigerhu598-dot/project-overseer
• License: MIT