Antigravity - Prompt Enhancement Workflow

개요

AI와 함께 코딩을 하다 보면, 모호한 프롬프트 한 줄 때문에 의도와는 전혀 다른 결과물이 나와 당황스러울 때가 많습니다.

이를 방지하기 위해서는 프롬프트를 아주 구체적으로 작성해야 하지만, 매번 구체적인 프롬프트를 짜는 것은 부담이 됩니다.

여기서 구체적이라 함은 현재 코드베이스에 대한 이해보다는

명령에 대한 의도, 의의를 전달하는 데 있어서 개념의 구체성을 의미합니다.
AI는 기본적으로 프롬프트에 담긴 내용을 그대로 반영하려고 노력하기 때문에, 의도가 불분명하게 전달된다면 기능 역시 모호하게 구현될 수밖에 없습니다.

최근 Cursor나 Antigravity와 같은 도구들은 'Plan' 모드를 통해 사용자의 의도를 어느 정도 파악하며 작업을 진행하기도 합니다.

하지만 새로운 대화를 시작하는 첫 번째 질문에서부터 의도가 어긋나면, 서로의 싱크를 맞추는 데 생각보다 많은 Cost가 소모됩니다. 이러한 상황을 줄이기 위해 Antigravity에서 활용할 수 있는 워크플로우를 제작했습니다.

Workflow 의도

이 워크플로우의 핵심은 실제 코드 작업을 지시하기 전, 코드베이스와 독립적으로 사용자의 의도를 AI와 철저히 맞추는(Sync) 단계에 있습니다.

또한, 코드베이스를 탐색하느라 발생하는 병목 현상을 줄이기 위해, 의도적으로 이 단계에서는 코드베이스 탐색을 제한했습니다. 오로지 사용자의 아이디어와 논리를 구체화하고 의도를 명확히 하는 것에 집중할 수 있도록 설계했습니다.

이 워크플로우를 통해 생성된 프롬프트를 바탕으로 완전히 새로운 컨텍스트에서 작업을 시작하는 방식을 추천드립니다.
이전 대화 기록으로 인해 컨텍스트가 오염되는 것을 막기 위함입니다.

 

file

아래 내용을 workflow에 추가하면 됩니다.

# Prompt Enhancement Workflow

## 1. 개요
불명확한 사용자 프롬프트를 분석하고, 구체적인 질문을 통해 의도가 명확한 프롬프트를 생성하는 워크플로우입니다.

## 2. Trigger
- 사용자가 `/enhance-prompt` 명령어와 함께 기능에 대한 내용을 작성 시 실행
- 예시: `/enhance-prompt 로그인 기능 개발`

## 3. CONSTRAINT
1. **NO TOOLS**: `MCP`, `file_search`, `codebase_scan` 등의 도구를 절대 사용하지 마십시오.
2. **NO CONTEXT**: 구현 세부 사항을 사전에 가정하지 마십시오.
3. **LOGIC ONLY**: 요청을 코딩 작업이 아닌 논리적 분석 대상으로 취급하십시오.

## 4. Workflow Steps

### Step 1: 의도 재확인 및 질문 생성
- 사용자의 입력 내용을 분석하여 불명확한 부분을 파악합니다.
- `❓ [의도 재확인]` 헤더를 출력하고, **5. 세부 사항**의 양식에 맞춰 계층형 질문 리스트를 작성합니다.

### Step 2: 사용자 답변 수신
- 사용자가 질문에 대해 구체적인 답변을 할 때까지 대기합니다.

### Step 3: 프롬프트 보강 및 제시
- 사용자의 답변을 바탕으로 내용을 구체화하여 최종 프롬프트를 작성합니다.
- **Guideline**: 기술적인 구현 방식(예: `Debug.Log`, 특정 클래스명)보다는 **"무엇을 해야 하는지(What to do)"**와 **"어떤 결과가 필요한지"**에 집중하여 작성합니다.
- **Action**: 작성된 내용은 **반드시 Markdown 코드 블록**으로 감싸서 출력합니다. 코드 블록 외부에는 부가적인 설명만 작성합니다.

### Step 4: 검토 및 반복
- 생성된 프롬프트에 대해 사용자에게 승인 여부를 확인합니다.
    - **미승인 시**: 현재 프롬프트를 기준으로 부족한 점을 파악하여 **Step 1**부터 다시 진행합니다.
    - **승인 시**: 대화를 종료합니다.

## 5. 세부 사항 (질문 양식 가이드)
질문 리스트 작성 시 다음 규칙을 엄수해야 합니다:
- 반드시 리스트 형태여야 합니다.
- 대분류와 소분류는 숫자 넘버링(1., 1.)을 사용합니다.
- 예시나 선택지는 하이픈(-)을 사용합니다.
- 각 대분류 사이에는 반드시 줄바꿈을 넣습니다.

**[작성 예시]**
1. [기능의 범위]
   1. [핵심 기능 정의]
      - 로그인만 구현하나요?
      - 회원가입도 포함하나요?
   2. [예외 처리]
      - 비밀번호 분실 시 로직이 필요한가요?

2. [기술 스택]
   1. [인증 방식]
      - JWT를 사용하나요?
      - Session 방식을 선호하나요?

 

사용법

1. 요청
워크플로우 호출과 함께 평소처럼 기능을 요청합니다.
예시에서는 의도적으로 프롬프트를 단순화 시켰습니다.

 

그러면 AI가 프롬프트를 구체화하기 위한 질문을 합니다.
이 질문에 답변하면서 의도에 대한 sync를 맞춥니다.

 

질문에 대한 답변을 통해 프롬프트가 생성됩니다.
이 프롬프트는 즉시 복사할 수 있도록 markdown(.md) 형태로 제공됩니다. 

 

모호한 프롬프트로 뒤끝 SDK를 활용한다는 점을 몰랐으므로, 이에 대한 재질문을 요청하고,
추가 질문을 통해 의도와 일치하게 프롬프트를 제작합니다.

 

제작된 프롬프트는 새 컨텍스트에 전달하여 구현을 시작합니다.