Communitygithub.com

ASoudy/AGS

프론티어 AI가 작성한 상세 구현 계획을 OpenCode에서 비프론티어 코딩 모델로 실행할 때 사용합니다. 실제 저장소에 대해 계획을 검증하고, 안전한 단계로 나누며, 각 단계를 확인하고, diff를 검사하며, 파괴적인 변경을 방지합니다. Claude Opus/GPT-5 등으로부터 다단계 계획을 받거나, 사전 작성된 명세를 실행하거나, 상세한 PR 설명을 구현할 때, 또는 "이 계획을 단계별로 실행해"라는 지시를 받을 때 트리거됩니다.

AGS란 무엇인가요?

이 스킬은 프론티어 AI 모델(예: Claude Opus, GPT-5)이 생성한 상세한 구현 계획을 OpenCode 환경 내에서 덜 강력한 코딩 모델이 안전하게 실행할 수 있도록 설계된 구조화된 실행 프레임워크입니다. 핵심 원칙은 프론티어 계획을 강력한 가설로 취급하되, 실제 저장소를 기준으로 계획의 모든 단계를 검증하고, 각 단계를 개별적으로 구현-확인-차이점 검사하는 체계적인 워크플로를 제공합니다. 이 스킬은 저장소 기준선 설정(Preflight), 계획 현실 확인(Parse), 진행 추적(Track), 단계별 구현(Implement), 계층적 검증(Verify), 변경 사항 검사(Diff), 완료 확인(Confirm), 최종 보고(Final)의 8단계로 구성됩니다. 특히 반복 실패 처리(Repeated Failure Handling) 기능을 통해 동일한 오류에 대해 무분별한 패치를 반복하는 것을 방지하고, 명확한 차단 보고서를 생성합니다. OpenCode 환경의 todowrite 및 기타 도구를 활용하며, 자동 커밋 및 푸시를 기본 지원하여 작업 내역을 추적 가능하게 합니다. 주요 사용 사례로는 다단계 구현 계획 실행, 사전 작성된 명세 구현, 상세한 PR 설명 구현 등이 있으며, 단순한 단일 파일 변경이나 빠른 반복 작업에는 사용하지 않아야 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/frontier-plan-opencode-executor

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

프론티어 계획 OpenCode 실행기

핵심 원칙

프론티어 계획은 강력한 가설이지, 절대적 진리가 아닙니다.

계획의 의도를 단계별로 실행하되, 코드를 편집하기 전에 모든 지시 사항을 실제 저장소에 대해 검증하세요. 프론티어 AI 계획은 다음과 같은 경우에 자주 실패합니다: 존재하지 않는 파일 이름, 허구의 임포트, 사용 불가능한 라이브러리, 저장소와 일치하지 않는 패턴, 누락된 테스트, 이상적인 아키텍처, 내부 API 손상 등.

절대 대규모 변경을 일괄 처리하지 마세요. 절대 검증을 건너뛰지 마세요. 절대 불확실성을 숨기지 마세요. 명시적 승인 없이 파괴적인 작업을 수행하지 마세요.

사용 시기

  • 프론티어 AI가 작성한 상세한 다단계 구현 계획을 받았을 때
  • 계획에 특정 파일 경로와 코드 패턴이 포함된 3개 이상의 뚜렷한 단계가 있을 때
  • 실행 규율의 이점을 얻을 수 있는 비프론티어 코딩 모델을 사용 중일 때
  • 계획이 실제 코드베이스와 충돌할 위험이 있을 때

다음과 같은 경우에는 사용하지 마세요:

  • 단일 파일 변경 또는 사소한 수정
  • 1-2개의 간단한 단계만 있는 계획
  • 동일 세션에서 직접 작성한 계획
  • 안전보다 속도가 중요한 빠른 반복 작업

핵심 워크플로

0. 사전 점검: 저장소 기준선 설정

파일을 건드리기 전에, 저장소 상태를 파악하고 기존 실패 여부를 감지하세요.

1. git status --short          # 저장소가 깨끗한가?
2. package.json 검사           # 사용 가능한 스크립트, 의존성
3. AGENTS.md, README.md 검사   # 프로젝트 규칙, 명령어
4. package.json 스크립트에서 사용 가능한 검증 명령어 감지
5. 가능한 경우 가장 저렴한 기준선 검증 실행 (lint 또는 typecheck)

기준선이 이미 실패한 경우:

  • 실패를 명시적으로 기록: 정확한 명령어, 종료 상태, 간단한 오류 요약
  • 광범위한 정리나 관련 없는 문제 수정을 시도하지 마세요
  • 계획된 변경이 기존 실패와 분리될 수 있는 경우에만 계속 진행
  • 기존 실패를 구현 탓으로 돌리지 마세요

위험 상태 감지:

  • git status에 계획과 관련 없는 커밋되지 않은 변경 사항이 있으면 사용자에게 경고
  • 잠금 파일이 수정된 경우 사용자에게 경고
  • 저장소가 충돌/리베이스 상태이면 중지하고 질문

체크포인트 권장:

  • 시작 전 저장소가 깨끗하면, 구현 전 체크포인트 커밋 생성을 권장
  • 사용자가 명시적으로 요청하지 않는 한 커밋을 생성하지 마세요

자동 커밋 및 자동 푸시

사용자가 명시적으로 비활성화하지 않는 한 자동 커밋 및 자동 푸시가 기본적으로 활성화됩니다.

에이전트는 검증된 각 논리적 작업 단위를 커밋하고 활성 원격 작업 브랜치에 푸시하여 사용자가 나중에 내역을 검토할 수 있도록 해야 합니다.

구현 전:

  • 현재 브랜치 식별
  • main, master, production, release 또는 기타 보호/메인라인 브랜치에 있는 경우, 계획에서 유추한 새 작업 브랜치 생성
  • 이미 작업 브랜치에 있으면 계속 진행
  • 절대 보호/메인라인 브랜치에 직접 푸시하지 마세요

기존 커밋되지 않은 변경 사항이 있는 경우:

  • 에이전트 커밋에 자동으로 포함하지 마세요
  • 현재 논리적 단위와 관련된 파일만 스테이징
  • 사용자 변경과 에이전트 변경을 안전하게 분리할 수 없으면 중지하고 충돌 보고

다음 조건이 모두 충족된 후에만 커밋:

  • 논리적 단위가 완료됨
  • 검증 통과
  • diff 검사 완료
  • 커밋에 하나의 일관된 목적이 있음

컨벤셔널 커밋 사용:

type(scope): 간결한 명령형 요약

예시:

feat(auth): 세션 검증 헬퍼 추가
fix(api): 빈 웹훅 페이로드 처리
refactor(billing): 인보이스 매퍼 추출
test(auth): 만료된 세션 흐름 커버

1. 파싱: 계획 추출 및 현실 확인

전체 계획을 읽으세요. 순서가 있는 단계를 추출하세요. 각 단계에 대해 현실 확인을 실행하세요:

확인질문
파일참조된 파일이 저장소에 존재합니까?
라이브러리참조된 라이브러리가 package.json에 있습니까?
패턴저장소에 이미 동등한 유틸리티/컴포넌트가 있습니까?
명령어계획의 검증 명령어를 사용할 수 있습니까?
의존성이 단계가 이전 단계에 의존합니까?
위험낮음 / 중간 / 높음 — 기존 동작을 손상시킬 가능성은?

단계에서 누락된 파일, 존재하지 않는 라이브러리, 오래된 패턴 또는 사용할 수 없는 명령어를 참조하는 경우: 계획의 의도를 유지하면서 구현 전에 단계를 조정하세요.

2. 추적: 진행 추적기 생성

가능하면 todowrite (OpenCode의 작업 목록 도구)를 사용하세요.

todowrite를 사용할 수 없는 경우 (예: 하위 에이전트에서 기본적으로 비활성화된 경우):

  • 응답에 보이는 마크다운 체크리스트를 생성
  • 각 단계 후 수동으로 업데이트
  • 진행 상황의 진실 공급원으로 사용
  • 도구를 사용하지 않았는데 사용한 척 하지 마세요

각 항목에는 다음이 포함되어야 합니다: 구현 작업, 검증 방법, 예상되는 수정 파일.

3. 구현: 한 번에 한 단계씩

현재 단계를 in_progress로 표시하세요. 오직 그 단계만 구현하세요.

  • 편집하기 전에 대상 파일 읽기
  • 기존 코드베이스 규칙 따르기 (임포트, 네이밍, 패턴, 아키텍처)
  • 계획을 기존 인프라에 맞게 조정 (예: 계획이 "토스트 컴포넌트 생성"을 요구하지만 프로젝트가 Sonner를 사용하는 경우, 처음부터 구축하는 대신 Sonner를 래핑)
  • 가장 작은 일관된 변경 수행
  • 미래 단계를 구현하지 말고, 설계 결정 시 다운스트림 의존성을 염두에 두세요
  • 관련 없는 정리, 리팩터링 또는 포맷팅을 수행하지 마세요
  • 명시적 승인 없이 의존성을 설치하지 마세요

4. 검증: 계층적 검증

각 단계 후, 가장 좁은 의미 있는 검증을 실행하세요. 매번 "모든 것 lint"를 실행하지 마세요.

변경 유형최소 검증강력한 검증
새 파일/컴포넌트lint 또는 typecheck영향을 받는 typecheck
타입/인터페이스 변경typecheck영향을 받는 테스트
로직/함수 변경대상 단위 테스트전체 테스트 스위트
API/서버 변경대상 통합 테스트빌드 + 엔드포인트 확인
UI 변경typecheck + 빌드시각적/수동 스모크 테스트
설정/빌드 변경빌드필요한 경우 클린 설치/빌드
데이터베이스/스키마 변경dry-run/확인 명령어사용자 승인 필요

단계에 대한 자동화된 검증이 없는 경우: 수동 검토를 수행하고 확인한 내용을 정확히 명시하세요.

검증이 실패한 경우:

첫 번째 실패 — 수정 후 재검증:

  • 현재 단계로 인한 오류만 수정
  • 기존 또는 관련 없는 오류는 수정하지 마세요
  • 즉시 재검증

반복 실패 — 맹목적으로 패치를 계속하지 마세요. 아래 "반복 실패 처리"를 참조하세요.

중요: 검증 통과를 위해 assertions 약화, 테스트 삭제, 동작 제거, 공개 API 변경, 오류 억제 또는 실패 숨기기를 절대 하지 마세요 — 계획에서 명시적으로 요구하고 사용자가 승인하지 않는 한. 경보를 멈추는 것은 문제를 해결하는 것과 같지 않습니다.

5. Diff: 변경 사항 검사

검증 통과 후, 실제로 무엇이 변경되었는지 검사하세요:

git diff --stat          # 어떤 파일이 변경되었는가?
git diff                 # diff가 충분히 작아 검토 가능한 경우

확인:

  • 예상된 파일만 변경됨
  • 관련 없는 포맷팅 없음
  • 명시적으로 의도되지 않은 한 잠금 파일 변경 없음
  • 생성된 파일이 실수로 편집되지 않음
  • 비밀, 로컬 경로 또는 디버그 로그 도입되지 않음
  • 코드가 실수로 삭제되지 않음

diff가 예상 범위를 초과하는 경우, 계속 진행하기 전에 중지하고 수정하세요.

6. 확인: 완료 표시

구현, 검증 및 diff 검사가 모두 깨끗할 때만:

  • 단계를 completed로 표시
  • 변경된 내용을 한 문장으로 요약
  • 다음 단계를 in_progress로 표시

7. 최종: 전체 검증 + 보고

모든 단계 후:

  • 가장 강력한 합리적 검증 실행: lint + typecheck + 빌드 + 테스트 (프로젝트 명령어 사용)
  • 보고: 완료된 단계, 변경된 파일, 검증 결과, 수행된 조정, 기존 실패 (있는 경우), 사용자 검토가 필요한 사항

반복 실패 처리

검증이 동일한 근본 원인으로 반복적으로 실패하는 경우, 계속해서 작은 맹목적 수정을 적용하지 마세요. 목표는 시도 사이에 새로운 것을 배우고 있는지 아니면 무작위로 헤매고 있는지 감지하는 것입니다.

단계가 여러 번 실패하는 경우:

  1. 패치를 중단하세요. 작은 조정을 하고 다시 실행하는 것을 중단하세요.
  2. 오류 출력을 주의 깊게 다시 읽으세요. 첫 번째 줄뿐만 아니라 전체 스택 추적.
  3. diff와 주변 코드를 검사하세요. git diff, 관련 타입, 인터페이스, 함수 읽기.
  4. 원래 가정을 재평가하세요. 현재 구현 전략이 올바른가?
  5. 실패를 분류하세요:
    • 코드베이스에 대한 잘못된 가정?
    • 저장소 불일치 (계획 vs 현실)?
    • 잘못된 추상화 선택?
    • 인터페이스 또는 타입 비호환성?
    • 누락된 의존성?
    • 오래된 생성된 아티팩트?
    • 변경 사항과 관련 없는 기존 문제?
    • 검증 명령어 자체가 잘못 구성됨?
  6. 진정으로 새로운 가설을 세우세요. 새로운 가설이 있을 때만 재시도하세요.
  7. 범위 축소를 고려하세요. 단계를 더 작은 조각으로 나누어 실패를 분리할 수 있습니까?

중요 규칙: 다음에서 새 정보가 발견되지 않는 한 동일한 수정 전략을 반복하지 마세요:

  • 로그
  • 스택 추적
  • Diff
  • 테스트
  • 저장소 검사
  • 문서

여러 번 시도 후에도 새 전략이 나타나지 않으면 중지하고 차단기를 명확하게 보고하세요:

차단기:
- 검증 명령어: `npm run build`
- 실패 파일: `src/app/page.tsx`
- 근본 원인 가설: React Server Component가 클라이언트 전용 훅을 임포트함
- 시도한 전략:
  1. 클라이언트 컴포넌트로 임포트 이동
  2. 훅을 별도 파일로 분리
  3. 저장소의 기존 패턴 확인
- 중단 이유:
  저장소에 경계를 안전하게 해결할 일관된 패턴 없음
- 예상되는 다음 조치:
  사용자 검토 또는 아키텍처 명확화

명확한 차단기 보고는 추측하면서 "여전히 실패 중"을 반복하는 것보다 항상 낫습니다.

기존 코드에 계획 적응

프론티어 AI 계획은 실제 코드베이스와 자주 충돌합니다. 그럴 때:

  1. 충돌 식별 — "계획에 import { X } from 'uninstalled-lib'이라고 되어 있지만 package.json에 없음"
  2. 무시하지 말고 적응 — 계획의 의도와 일치하도록 기존 인프라 사용
  3. 적응 설명 — 변경한 내용과 이유를 한 문장으로 설명
  4. 계획의 인터페이스 유지 — 계획이 useToast()를 내보내는 경우, 내부가 다르더라도 적응에서도 여전히 useToast()를 내보내야 함

중요 규칙:

  • 저장소에 이미 동등한 프리미티브가 있는 경우 새 추상화를 생성하지 마세요
  • 계획에서 명시적으로 요구하고 사용자가 승인하지 않는 한 새 의존성을 설치하지 마세요
  • 정당성 없이 아키텍처나 패턴을 변경하지 마세요

명시적 사용자 승인 없이 금지

다음 명령어를 실행하려면 사용자가 "예"라고 말해야 합니다:

파괴적:

  • rm -rf
  • git reset --hard
  • git clean -fd
  • git push --force

설치 (잠금 파일 변경):

  • npm install
  • pnpm install
  • yarn install
  • bun install
  • npm audit fix

데이터베이스 / 인프라:

  • prisma migrate
  • prisma db push
  • supabase db push
  • docker compose down -v

설정:

  • .env 파일 변경
  • 글로벌 도구 설정 수정
  • 배포/게시 취소 명령어 실행

대규모 변경:

  • 전체 저장소에 대한 광범위한 포맷팅 (prettier/eslint --fix)
  • 검토 없이 여러 파일에 걸친 찾기 및 바꾸기

명령어가 안전한지 확실하지 않은 경우 실행 전에 물어보세요.

일반적인 실수

실수현실
"프론티어 AI가 말했으니 맞을 거야"프론티어 계획은 가설입니다. 실제 저장소에 대해 검증하세요.
"마지막에 모든 것을 검증할게"오류는 누적됩니다. 적절한 세분성으로 각 단계를 검증하세요.
"이미 계획을 읽었으니 한 번에 모두 구현할 수 있어"일괄 구현 = 일괄 오류 + 더 어려운 디버깅.
"있는 김에 기존 lint 오류도 고칠게"관련 없는 정리는 변경 사항이 실제로 무엇을 했는지 모호하게 만듭니다. 하지 마세요.
"이 단계는 간단하니 git diff를 확인할 필요 없어"간단한 편집도 실수로 코드를 삭제하거나 의도하지 않은 파일을 포맷할 수 있습니다.
"계획이 참조하는 누락된 라이브러리를 설치할게"먼저 물어보세요. 라이브러리가 의도적으로 없거나 승인되지 않았을 수 있습니다.
"npm run build만이 유일한 중요한 검증이다"빌드는 느리고 광범위합니다. 중간 단계에는 lint/typecheck를 사용하세요.
"실패하면 그냥 조정하고 통과할 때까지 다시 실행하면 돼"새로운 정보 없이 맹목적 패치는 헛수고입니다. 오류를 다시 읽고 새로운 가설을 먼저 세우세요.
"또 같은 오류, 다른 작은 변경을 시도해보자"같은 오류 + 같은 전략 = 같은 결과. 전략을 바꾸고 패치를 바꾸지 마세요.

위험 신호 — 중단 및 재평가

  • "다음 단계 후에도 검증할게" — 지금 검증하세요.
  • "프론티어 계획이 저장소보다 더 잘 알아" — 저장소가 진실의 공급원입니다.
  • "이 라이브러리가 설치되지 않았지만 계획이 필요해" — 사용자에게 물어보세요. 조용히 설치하지 마세요.
  • "diff가 예상보다 크지만 괜찮을 거야" — 계속 진행하기 전에 검사하고 설명하세요.
  • "2단계와 3단계가 관련 있으니 일괄 처리할게" — 한 단계 = 한 번의 검증 + diff 주기.
  • "기존 lint 오류, 먼저 수정하자" — 당신의 일이 아닙니다. 기록하고 집중하세요.
  • "편집하는 동안 이 파일을 포맷할게" — 별도의 변경 = 별도의 단계. 섞지 마세요.
  • "여전히 실패 중, 다른 빠른 수정을 시도해보자" — 패치를 중단하세요. 오류를 다시 읽고 새로운 가설을 먼저 세우세요.
  • "같은 오류 3번, 한 번 더 조정하면 될 거야" — 같은 오류 + 같은 전략 = 헛수고. 전략을 바꾸거나 차단기를 보고하세요.
  • "그냥 전체를 다시 작성하고 해결되는지 보자" — 왜 실패했는지 이해하지 않고 작업을 버리는 것은 아무것도 가르쳐주지 않습니다. 먼저 진단하세요.
  • "사용자가 급해하니 diff 검사를 건너뛸게" — 5초의 git diff --stat가 시간 낭비를 방지합니다.

빠른 참조

단계작업도구
사전 점검git status, 명령어 감지, 기준선 확인Bash
파싱 + 현실 확인계획 읽기, 저장소에 대해 각 단계 검증Read + Glob
추적todowrite 생성todowrite
구현한 단계 구현 + 변경 사항 확인Edit
검증계층적 검증 실행Bash
Diffgit diff로 변경 사항 검사Bash
완료단계 완료 표시, 다음 단계로 이동(수동)
최종전체 검증 + 최종 보고서Bash + (수동)

지침

7단계 워크플로를 따르고, 계획의 의도를 존중하며, 변경 사항을 검증하고, 저장소를 깨끗하게 유지하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬