@agent — AI 에이전트를 위한 코드 주석

초안 @agent 주석 규격은 AI 코딩 도구가 코드의 관계와 의도를 이해하도록 돕는 인라인 주석을 제안한다.

이 주석은 동기화된 enum, 기준이 되는 검증 로직, 그리고 파일·언어를 넘는 제약 조건을 표시할 수 있다.

불변식을 기계가 읽을 수 있게 만들어, 에이전트가 수행하는 코드 변경에서 리팩터링 실수와 보안 버그를 줄이려는 목적이다.

아직 초기 단계의 제안이지만, 대규모 코드베이스에서 AI 에이전트가 놓치기 쉬운 맥락을 보완할 수 있다.