Document

AI Issue Publisher

AI Issue Publisher는 REPL Works용 Issue 생성 도구다.

아이디어, 대화, 작업 요청을 실행 가능한 GitHub Issue로 변환한다.

Github 바로가기


Purpose

다음 문제를 해결한다.

생각은 있다.

하지만 실행 가능한 작업은 없다.

ai-issue는 이를 다음 형태로 변환한다.

Idea

Issue

Execution AI

Why It Exists

대부분의 AI 프로젝트는 다음 문제를 겪는다.

작업 지시가 모호하다.

범위가 불명확하다.

완료 기준이 없다.

이 경우 Execution AI는

  • 범위를 추측한다.
  • 기능을 추가한다.
  • 의도를 오해한다.

ai-issue는 이러한 문제를 줄인다.


Workflow

일반적인 흐름

Discussion

Issue

Branch

PR

Review

Merge

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


Output

생성되는 Issue는 일반적으로 다음을 포함한다.

  • Problem
  • Goal
  • Scope
  • Constraints
  • Acceptance Criteria
  • Expected Outcome

Execution AI는 Issue만 읽고 작업을 시작할 수 있어야 한다.


Usage

다음 상황에서 사용한다.

새로운 기능

버그 수정

문서 작업

리팩토링

운영 작업

작업을 명확하게 정의해야 할 때 사용한다.


Relationship

Workflow

Issue

Execution

ai-issue는 REPL Works Workflow를 지원하는 도구다.


프레임워크를 대체하지 않는다.


Repository

ai-issue는 REPL Works Compatible 프로젝트에 적용할 수 있다.


프로젝트별로 독립적으로 사용할 수 있다.


GitHub 기반 워크플로와 함께 사용하는 것을 권장한다.


Key Principle

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

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


Future Direction

ai-issue는 REPL Works 생태계의 첫 번째 도구다.


향후 Prompt, Document, Workflow 자동화를 위한 추가 도구가 만들어질 수 있다.


ai-issue의 목표는 더 많은 이슈를 만드는 것이 아니다.


더 적은 설명으로,

더 정확하게,

AI가 작업할 수 있게 만드는 것이다.