아이디어, 대화, 작업 요청을 실행 가능한 GitHub Issue로 변환한다.
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가 작업할 수 있게 만드는 것이다.