716 / 717

2 분 소요

hits

AI 코딩 에이전트의 발전 속도가 빠르다. 특히 GPT-6 아스트라 같은 최신 고성능 모델의 등장으로 기존의 에이전트 개발 방식을 다시 볼 필요가 있다는 지적이 나온다. 과거 모델에 맞춰 쌓아 온 지침이 GPT-6 아스트라에서는 오히려 비효율적이거나 방해가 될 수 있다는 것이다. OpenAI 개발자 블로그는 스킬, AGENTS.md, 작업 프롬프트 세 가지를 중심으로 새 지침을 제시한다.

GPT-6 아스트라, AI 에이전트 개발 지침 변화

더 나은 스킬 설계

스킬은 마크다운 파일로 저장된 프롬프트로, 특정 워크플로나 앱 사용에 대한 지침을 담는다. 리소스나 스크립트를 함께 묶을 수도 있다. 문제는 많은 개발자가 스킬을 과도하게 많이 넣고, 설명을 너무 길게 쓴다는 데 있다. 스킬마다 이름과 설명이 모델 컨텍스트에 올라가 언제 쓸지를 알려 주는데, 스킬이 많아지면 Codex가 설명을 줄여서 넣기 때문에 모델이 각 설명을 온전히 보지 못한다.

블로그는 세 가지 원칙을 제시한다.

원칙 문제 개선 방향
짧은 설명 설명이 길면 잘려서 언제 쓸지 판단이 흐려진다 언제 적용되는지 분명히 하되 최대한 짧게 쓴다
점진적 공개 스킬을 읽는 것 자체가 컨텍스트를 소모한다 루트 문서는 최소한의 라우터로 두고 세부는 보조 문서·스크립트로 연결한다
과한 상세 지침 모델의 이해력이 좋아져 지나친 지침이 오히려 방해가 된다 세세한 여정형 지침을 덜어낸다

예를 들어 Postgres 마이그레이션 스킬의 설명은 이렇게 좁힌다.

구분 나쁜 예 좋은 예
스킬 설명 Postgres 스키마 마이그레이션을 생성·검증한다. 데이터베이스, 쿼리, 모델, 영속성과 관련된 작업이면 사용한다. Postgres 스키마 마이그레이션을 생성·검증한다. 마이그레이션을 추가·변경하거나 그 배포를 검토할 때 사용한다.

나쁜 예는 데이터베이스와 조금이라도 닿는 작업이면 언제나 이 스킬을 부르게 만든다. 좋은 예는 마이그레이션이라는 특정 상황으로 사용 범위를 좁힌다. 저장소에 남긴 스킬은 다른 기여자의 에이전트도 참고하며, 그 에이전트는 다른 모델일 수 있다. Sol이나 Luna에 맞는 지침이 GPT-6 아스트라에는 과한 제약이 될 수 있으므로, 어떤 모델이 그 지침을 쓸지 함께 고려해야 한다.

AGENTS.md 정리

AGENTS.md는 에이전트가 저장소에서 작업할 때마다 적용되는 지침이다. 따라서 각 항목이 여전히 필요한지 자주 되물어야 한다. 오타 하나 고치는 데 문서 여러 개나 저장소 전체 지도를 먼저 읽으라고 요구하는 것은 과하다. GPT-6 아스트라는 무엇을 읽어야 할지 스스로 판단한다.

나쁜 예 좋은 예
모든 편집 전에 architecture.md, database.md, deployment.md를 읽는다 서비스 경계는 architecture.md, 스키마 변경은 database.md, 배포 준비는 deployment.md를 참고한다

이전 모델은 테스트 실행이나 확인을 독려해야 했지만, GPT-6 아스트라는 스스로 한다. 그래서 같은 지침이 불필요한 테스트를 부를 수 있다. 반대로 아스트라가 어디까지 진행할지 주저할 때는 안전한 워크플로에 명시적 허가를 주면 도움이 된다. 예를 들어 “로컬 테스트는 일회용 픽스처를 쓰며 프로덕션 접근 권한이 없다. 요청한 변경으로 생긴 실패를 고치고, 매 단계 승인을 받지 말고 관련 테스트를 다시 실행하라”는 지침이다.

의사결정 경계와 지속성

경계를 어떻게 서술하는지가 중요하다. 예전 모델이 허락 없이 일을 벌일까 봐 강한 제약을 걸어 두었다면, GPT-6 아스트라로 옮길 때는 그 표현을 완화할 필요가 있다. 아스트라는 안전하다고 판단하지 않으면 작업을 수행하지 않는데, 강한 제약을 그대로 두면 계속해도 좋을 지점에서 멈춰 버릴 수 있다.

지속성도 달라진다. GPT-5.6 Sol이 한 번 요청받으면 길게 이어 가던 것에 익숙하다면, GPT-6 아스트라는 첫 구현에서 멈추고 검토를 요청하는 쪽에 가깝다. 그래서 시작 전에 ‘완료’가 무엇인지 정의해 두는 편이 낫다.

나쁜 예 좋은 예
첫 구현 후 검토를 요청한다 구현, 결과 확인, 실패 수정까지 포함해 작업을 끝낸다

첫 구현에서 더 나아가 탐색을 이어 가길 원한다면, 무엇을 탐색하고 어디서 멈출지를 구체적으로 적어야 한다. 새 모델은 기존 지침을 점검하고 정리할 좋은 기회다. 이 글에서 논의한 기준으로 GPT-6 아스트라에게 직접 지침을 감사시키는 방법도 있다.

지침을 줄이는 것의 의미

이 지침 변화는 결국 모델이 처리해야 할 정보의 양을 줄이는 일이다. 지나치게 긴 스킬 설명이나 불필요하게 많은 AGENTS.md 항목은, 모델이 정작 풀어야 할 문제보다 컨텍스트를 채우고 걸러 내는 부수적인 일에 자원을 쓰게 만든다. 더 유능한 모델일수록 세세한 안내보다 짧고 핵심적인 지침이 더 나은 결과로 이어진다는 것이 이 글의 요지다.

출처

공유