Antigravity 워크플로란 무엇인가
Antigravity 워크플로는 개발 목표에서 확인된 결과까지 반복해서 이동하는 방법입니다. 편집기, 터미널, 브라우저 제어, Skill, MCP 서버 중 하나를 사용하거나 여러 화면을 연결할 수 있습니다. 단순한 프롬프트가 아닙니다. 시작 상태, 허용된 작업, 멈출 지점, 완료를 증명하는 자료가 모두 포함됩니다.
좋은 Antigravity 워크플로는 테스트할 수 있을 만큼 좁습니다. ‘이 프로젝트를 개선해’라는 말에는 종료 조건이 없습니다. ‘실패한 테스트를 읽고 파서만 수정한 뒤 집중 테스트를 실행하고 diff를 보여 준 다음 commit 전에 멈춰’라고 하면 출력과 안전한 중단점이 생깁니다. 각 화면의 세부 명령은 CLI, Skills, MCP 가이드에서 확인하세요.
워크플로 실행 전에 작업 공간 준비하기
올바른 저장소를 열고 브랜치를 확인하며 변경될 가능성이 있는 파일을 살펴보세요. 필요한 터미널 명령은 먼저 한 번 수동으로 실행해 이름, 종료 코드, 환경을 파악합니다. 브라우저나 MCP를 사용한다면 쓰기를 허용하기 전에 읽기 전용 요청을 시험하세요.
입력과 출력을 쉬운 말로 적습니다. 대상 파일 또는 도메인, 허용된 도구, 제한, 사람이 판단할 지점을 포함하세요. 비밀번호, 토큰, 결제 정보, 개인 기록은 워크플로 문장과 로그에 넣지 않습니다. 첫 실행은 테스트 브랜치나 버릴 수 있는 폴더에서 진행합니다.
| 작업 화면 | 첫 사용 방법 | 확장 전 확인 |
|---|---|---|
| 편집기 | 읽기 -> 계획 -> 편집 -> diff 확인 | 대상 파일을 확인하고 첫 패치를 작게 유지합니다. |
| 터미널 | 알려진 명령 하나 실행하고 결과 저장 | PATH, 셸 정책, 종료 코드, 쓰기 범위를 확인합니다. |
| 브라우저 / MCP | 공개 자료를 읽거나 엔드포인트 테스트 | 도메인, 계정, 시간 제한, 수동 중단을 확인합니다. |
- 1. 시작 상태 고정저장소, 브랜치, 버전, 접근 가능한 파일과 계정을 기록합니다.
- 2. 출력 하나 정하기실패가 보이도록 산출물, 테스트 결과, 페이지 상태 또는 보고서 하나를 고릅니다.
- 3. 읽기 전용으로 리허설파일 편집, 데이터 전송, 계정 변경 전에 과정을 조사하고 설명합니다.
- 4. 검토 지점 추가의존성 설치, 네트워크 쓰기, 게시, 삭제, 배포 전에 멈춥니다.
이 글은 고정된 워크플로 파일 형식이나 영구적인 플래그를 약속하지 않습니다. 새 통합을 자동화하기 전에 공식 문서를 확인하세요.
Antigravity 워크플로에 유용한 프롬프트와 명령
워크플로 프롬프트에는 역할, 시작 상황, 허용된 작업, 기대하는 증거를 적어야 합니다. 예를 들어 ‘이 저장소에서 X를 조사하고 가장 작은 변경을 계획한 뒤 Y만 편집하고 Z를 실행하여 결과를 보여 주고 W 전에 멈춰’라고 쓸 수 있습니다. 에이전트가 실제로 사용한 명령이나 도구의 이름을 반환하게 하세요.
대화형 명령과 셸 명령을 분리하세요. CLI 도움말, 세션 명령, 터미널 테스트, MCP 호출은 범위와 실패 방식이 다릅니다. 다른 사람이 재현할 수 있도록 워크플로 안에서 작업 화면을 이름으로 표시합니다.
조사 -> 계획 -> 확인세 단계 사용
편집 전에 조사와 짧은 계획을 요구하고 파일 목록을 확인합니다.
집중 검사 하나 실행좁게 검증
변경을 반박할 수 있는 가장 작은 테스트, 린터, 미리보기 또는 URL 검사를 실행합니다.
diff와 상태 표시변경을 보이게 하기
수정된 파일, diff 요약, 종료 코드, 생성된 결과를 반환합니다.
승인에서 멈추기사람의 확인점 만들기
게시, 배포, 삭제, 설치, 계정 변경 전에 멈춥니다.
증거와 함께 한 번 재시도재시도 제한
시간 초과를 저장하고 바뀐 가정이 있을 때만 한 번 다시 실행합니다.
산출물 경로 반환결과 가리키기
보고서, 화면 캡처, 테스트 로그, 빌드 페이지의 경로가 검증을 재현하게 합니다.
워크플로 범위, 권한, 설정
워크플로의 안전성은 토글 하나보다 범위에서 나옵니다. 프로젝트 명령은 저장소 가까이에 두고 개인 설정은 분리하며 도구 권한을 구체적으로 적습니다. 파일 읽기는 쓰기와 다르고, 테스트는 설치와 다르며, 공개 페이지 확인은 인증된 계정 변경과 다릅니다.
검증된 절차를 Skill로 묶을 때는 전제 조건, 입력, 예상 출력, 실패 처리, 검증 방법을 포함하세요. 넓은 셸 명령이나 네트워크 쓰기를 친근한 이름 뒤에 숨기지 않습니다.
workflow:
goal: "파서 하나를 수정하고 집중 테스트 성공 증명"
allowed: [read_files, edit_target, run_focused_test]
review_before: [install_package, network_write, delete, publish]
output: [diff_summary, test_result, remaining_risks]- 프로젝트 범위 — 저장소 내부 지침을 사용해 명령과 파일 경계를 팀에서 재현할 수 있게 합니다.
- 사용자 범위 — 개인 모델, 터미널, 화면 설정을 공유 동작과 분리합니다.
- 도구 범위 — 와일드카드 대신 정확한 MCP 서버, 브라우저 도메인, 셸 명령을 지정합니다.
- 검토 범위 — 앞 단계가 자동이어도 항상 사람이 확인해야 하는 작업을 목록으로 만듭니다.
다섯 번의 과정으로 만드는 반복 가능한 Antigravity 워크플로
첫 번째는 발견입니다. 관련 파일, 페이지, 이슈, 테스트 출력을 읽고 목표를 다시 말합니다. 두 번째는 계획입니다. 가장 작은 변경을 제안하고 사용할 도구를 적습니다. 계획이 요청을 잘못 이해했다면 멈추세요.
세 번째는 실행입니다. 네 번째는 집중 검사를 수행하고 결과를 승인 규칙과 비교합니다. 다섯 번째는 변경된 경로, 증거, 남은 위험, 다음 사람이 결정할 일을 보고합니다. 이 분리는 콘텐츠 빌드, CLI 작업, 브라우저 점검, MCP 조사 모두에 적용됩니다.
발견
상황을 읽고 목표, 제약, 모르는 점을 명시합니다.
계획하고 실행
작은 작업 목록을 승인하고 이름이 지정된 도구와 파일만 사용합니다.
검증하고 전달
출력과 증거, 위험을 확인한 후 영향이 큰 다음 결정 전에 멈춥니다.
Antigravity가 바뀔 때 워크플로를 최신 상태로 유지
에이전트 제품은 계속 변합니다. 업데이트 후에는 명령, 권한, 모델, 통합 결과가 달라질 수 있습니다. Antigravity, 모델, 셸, MCP 서버가 바뀌면 워크플로를 다시 검토하세요. 지난달 성공했다는 사실만으로 오늘 안전하다고 할 수 없습니다.
확인 날짜와 빌드 또는 문서 페이지, 검증한 단계를 기록합니다. 현재 동작을 확인할 수 없다면 불확실성이 해결될 때까지 읽기 전용 또는 수동 절차로 유지하세요.
Antigravity 워크플로 보안 규칙
워크플로를 권한 문서로 취급하세요. 공유하거나 설치하기 전에 읽을 수 있는 파일, 실행할 수 있는 명령, 접근할 외부 도메인, 발생 가능한 부작용을 확인합니다.
명령 인수, 작업 디렉터리, 네트워크, 패키지 스크립트, 환경 변수, 삭제 및 게시 경로를 점검하세요. 비밀은 프롬프트와 로그에서 제외하고 테스트 계정을 사용하며 완료 후 권한을 회수합니다.
- 비밀번호, API 키, 복구 코드, 고객 데이터를 워크플로 텍스트와 증거에 넣지 않습니다.
- 패키지 설치, 업로드, 웹훅, 외부 메시지를 수동으로 검토합니다.
- 인증 흐름에는 전용 브라우저 프로필이나 테스트 계정을 사용합니다.
- 파괴적인 파일 및 Git 작업을 자동 경로 밖에 둡니다.
- 실행자에게 전제 조건과 되돌리기 계획을 전달합니다.
실패한 워크플로 문제 해결
여전히 실패하는 가장 작은 과정으로 문제를 줄입니다. 권한을 바꾸기 전에 시작 상태, 정확한 도구 호출, 보이는 결과, 승인 규칙을 비교하세요.
에이전트가 다른 계획을 세움
대상 파일, 출력, 중단 조건을 다시 말합니다. 먼저 계획만 요청하고 경계를 고친 뒤 편집하세요.
명령을 찾을 수 없음
일반 터미널에서 실행하고 PATH와 셸 정책을 확인한 뒤 설치된 버전을 기록합니다.
도구가 일부 데이터만 반환
응답을 저장하고 누락된 필드를 표시한 후 멈춥니다. 일시적 오류가 분명할 때만 재시도하세요.
그럴듯하지만 틀린 결과
최종 URL, 파일 경로, 테스트 출력, 상태를 승인 규칙과 비교합니다. 오래된 결과나 부분 결과는 실패로 처리합니다.
권한 요청이 계속 나타남
명령, 경로, 계정, 도구 중 무엇이 바뀌었는지 확인하고 와일드카드 대신 규칙을 좁힙니다.
Antigravity 워크플로 자주 묻는 질문
Antigravity 워크플로란 무엇인가요?
범위가 정해진 개발 목표를 확인된 결과와 연결하는 반복 가능한 절차입니다. 시작 상황, 허용된 도구, 검토 지점, 출력, 중단 또는 되돌리기 규칙을 정의합니다.
안전한 Antigravity 워크플로는 어떻게 만드나요?
하나의 저장소와 결과에서 시작합니다. 목표, 대상, 허용 작업, 수동 검토, 승인 테스트를 쓰고 읽기 전용으로 연습한 다음 가장 작은 편집을 허용하고 결과를 확인합니다.
Skill, CLI, MCP 중 무엇을 사용해야 하나요?
재사용할 지침과 검사에는 Skill, 터미널 진입점에는 CLI, 이름이 정해진 외부 도구나 데이터가 필요할 때는 MCP를 사용합니다. 각 화면의 목적과 범위를 분명히 하세요.
Antigravity 워크플로가 명령을 자동 실행할 수 있나요?
현재 제품 설정과 권한이 허용하면 가능합니다. 알려진 저위험 명령으로 제한하고 인수, 네트워크, 설치, 삭제, 게시, 계정 변경은 수동으로 검토하세요.
공유하기 전에 워크플로를 어떻게 테스트하나요?
버릴 수 있는 폴더나 깨끗한 테스트 브랜치에서 실행합니다. 전제 조건, 명령, 도구 호출, 예상 출력을 확인하고 되돌리기 계획을 공유하기 전에 실패 사례 하나를 시험하세요.
업데이트 후 워크플로가 멈춘 이유는 무엇인가요?
업데이트가 명령 이름, 권한, 모델 접근, UI 위치, 통합 결과를 바꿀 수 있습니다. 공식 문서, 설치된 빌드, 가장 작은 읽기 전용 단계를 다시 확인합니다.
워크플로가 반환해야 할 증거는 무엇인가요?
변경된 경로나 최종 URL, 명령 또는 도구 상태, 집중 테스트 결과, 남은 위험을 반환합니다. 비밀번호, 토큰, 개인 데이터, 편집하지 않은 세션 기록은 반환하지 않습니다.
공식 및 관련 Antigravity 자료
- Google Antigravity 2.0 제품 페이지 — 공식 제품 배경과 용어.
- Google Antigravity CLI 제품 페이지 — CLI 작업 화면에 대한 공식 참고 자료.
- Antigravity Skills 가이드 — 검증된 절차를 재사용 가능한 Skill로 묶기.
- Antigravity Auto Accept 보안 가이드 — 명령과 권한 경계를 검토하기.