AI 이슈 퍼블리셔(AI Issue Publisher)

Overview

AI 이슈 퍼블리셔(AI Issue Publisher 줄여서 ai-issue)는 아이디어, 토론, 작업 요청을 실행 가능한 GitHub Issue로 변환하기 위한 도구다.

REPL Works 워크플로에서 Discussion AI와 Execution AI 사이를 연결하는 역할을 수행한다.

Why REPL Works

많은 AI 프로젝트는 구현보다 작업 정의에서 더 많은 시간을 소비한다.

무엇을 만들어야 하는지 명확하지 않으면 AI는 범위를 추측하고, 불필요한 기능을 추가하며, 의도와 다른 결과를 만들 수 있다.

ai-issue는 이러한 문제를 줄이기 위해 만들어졌다.

Website / Repository

Website

No exist

Repository

https://github.com/replworks/ai-issue

Workflow

Discussion
↓
Issue
↓
Execution AI
↓
PR
↓
Review
↓
Merge

ai-issue는 Discussion과 Issue 사이를 담당한다.

Documents Used

ai-issue는 일반적으로 다음 문서를 기반으로 작업한다.

IDEAS.md

PITCHING_SCRIPT.md

PRODUCT_SPEC.md

ARCHITECTURE.md

FRAMEWORK.md

TASKS.md

AGENTS.md

Issue는 프로젝트 문서와 일관성을 유지해야 한다.

Lessons Learned

Good Execution Starts With Good Tasks

좋은 구현은 좋은 작업 정의에서 시작된다.

작업 범위가 명확할수록 AI의 결과도 안정적이다.

Issues Become Reusable Prompts

잘 작성된 Issue는 단순한 작업 요청이 아니다.

Execution AI가 바로 사용할 수 있는 프롬프트 역할을 수행한다.

Discussion And Execution Should Be Separate

계획과 구현을 분리하면 품질이 향상된다.

Discussion AI는 무엇을 해야 하는지 정의하고,

Execution AI는 정의된 작업을 수행한다.

Structure Reduces Hallucination

명확한 Problem, Goal, Scope, Acceptance Criteria는 AI가 추측해야 할 영역을 줄여준다.

결과적으로 구현 품질이 향상되고 리뷰 비용도 감소한다.

Current Status

운영 중.

REPL Works 프로젝트에서 실제 이슈 생성과 작업 계획에 사용되고 있다.

What This Project Proves

ai-issue는 REPL Works가 단순한 문서 체계가 아니라,

아이디어를 실행 가능한 작업으로 변환하는 실용적인 워크플로임을 보여준다.

Key Insight

Idea
↓
Issue
↓
Execution AI

좋은 Issue는 작업을 설명하지 않는다.

좋은 Issue는 작업을 실행 가능하게 만든다.