TL;DR

  • TanStack Intent v0.5는 라이브러리 패키지에 포함된 에이전트 스킬을 유지 관리하는 워크플로를 추가해, 소스가 계속 바뀌는 상황에서 스킬의 주의가 필요한 부분을 파악하도록 지원함.
  • intent validate는 SKILL.md의 펜스 코드 블록에 있는 JavaScript·TypeScript·JSX·TSX 예제를 실행하지 않고 타입 검사하며, 오류와 폐기 예정 임포트를 보고함.
  • intent maintainer review는 소스 변경에 영향을 받는 가이던스와 연결된 가이던스가 없는 변경을 식별하고, 스킬을 수정했는지 또는 기존 내용이 여전히 맞는지 기록함.
  • 재사용 가능한 GitHub CI 검사는 예제 검증, 생성 파일 드리프트, 미결 소스 검토를 확인하며, intent repair는 명확한 프런트매터 수정 패치 생성을 지원함.
  • 런타임 라이브러리를 패키지에 번들링하고 에이전트 훅이 로컬 CLI를 사용하도록 해 CLI 시작 및 검색 작업을 줄임.

스킬은 개발 프로세스에 속함

  • Intent는 라이브러리 유지 관리자가 에이전트 스킬을 npm 패키지에 포함해 배포하는 도구임. 패키지를 설치하면 해당 라이브러리 버전에 맞는 가이던스도 함께 설치됨.
  • 스킬은 라이브러리 사용법과 따라야 할 패턴, 피해야 할 패턴을 설명하며, 문서화하는 코드 가까이에서 유지되어 관련성과 최신성을 지키고 에이전트가 오래되거나 잘못된 지침을 따를 가능성을 줄임.
  • 여기저기 흩어져 있거나 잊히는 지침을 각자 여러 출처에서 모으는 대신, 유지 관리자의 확인을 거친 스킬을 코드와 함께 패키징하고 관리할 수 있음.
  • 이 방식은 가이던스 배포 문제를 해결하지만, 유지 관리 문제까지 저절로 해결하지는 않음.
  • v0.5의 새 intent maintainer 워크플로는 작성, 검증, 소스 검토를 저장소 안에서 처리함. 전체 작업을 한 번에 진행하거나 중요한 작업부터 점진적으로 확장할 수 있음.
  • 저장소에서 다음 명령을 실행하면 기존 스킬을 등록하고 유지 관리용 스킬을 추가하며 CI 워크플로를 설정함.
  • npx @tanstack/intent@0.5.0 maintainer setup
  • 기존 스킬이 있다면 내용은 수정하지 않고 등록함. 이후 코딩 에이전트가 스킬 작성을 지원하고 Intent가 스킬과 패키지 및 소스의 관계를 추적함.
  • 이 도구는 주의가 필요한 항목을 추적하는 데 드는 노력을 줄여 유지 관리를 실용적으로 만듦.

사용 전에 예제 오류를 확인할 수 있음

  • 스킬의 예제도 코드이므로 코드처럼 검사할 수 있음.
  • v0.5의 intent validate는 SKILL.md에 펜스 코드 블록으로 작성된 JavaScript·TypeScript·JSX·TSX 예제를 검사함. 소스에서 타입을 추론하거나 JSDoc으로 선언한 타입을 이용해 JavaScript 라이브러리도 검사함.
  • npx @tanstack/intent@0.5.0 validate
  • Intent는 예제를 실행하지 않고 TypeScript 컴파일러로 검사함. 누락된 내보내기, 잘못된 옵션, 타입 불일치, 구문 오류를 스킬 파일명과 줄 번호와 함께 보고하며, 폐기 예정 임포트는 경고함.
  • 짧은 예제를 완전한 애플리케이션으로 바꿀 필요는 없음. 일부 코드 조각은 주변 이름이나 설정을 생략할 수 있음.
  • 검사를 위해서는 TypeScript 5.0 이상이 필요함. TypeScript를 사용할 수 없거나 Intent가 해당 라이브러리의 진입점을 찾지 못하면 타입 검사를 건너뛰었다고 보고함.
  • 검증 통과가 런타임 동작의 정확성이나 예제의 최선의 접근 방식을 보장하지는 않음. 다만 다른 에이전트의 지침이 되기 전에 API 오류를 발견하는 수단을 제공함.

변경 사항을 확인하고 판단을 기록함

  • 소스 변경이 항상 스킬 수정을 뜻하지는 않음. 구현만 바뀌고 가이던스는 여전히 맞을 수 있으며, 작은 API 변경으로 예제 전체가 오해를 부를 수도 있음.
  • intent maintainer review는 소스 변경의 영향을 받는 가이던스를 식별하고, 연결된 가이던스가 없는 변경을 나열함. 변경 사항을 확인한 뒤 스킬을 수정했는지, 또는 기존 가이던스가 여전히 맞는 이유를 기록할 수 있음.
  • 검토 결과는 검토한 소스와 스킬 내용에 연결됨. 변경이 없는 검토에서는 같은 결정을 반복해서 요청하지 않으며, 과거의 결정은 새로 변경된 내용에 대한 승인으로 취급되지 않음.
  • 단순히 “이 파일이 오래됐는가?”를 묻는 대신 “누군가 변경 사항을 기준으로 이 가이던스를 확인했는가?”를 확인하는 방식임.

CI는 대신 판단하지 않고 검토를 지원함

  • 유지 관리 워크플로에는 검증, 생성 파일 드리프트, 미결 소스 검토를 확인하는 재사용 가능한 GitHub 검사가 포함됨. 문제가 있으면 Actions 요약에 표시되어 검토자가 주의가 필요한 항목을 확인할 수 있음.
  • 새 intent repair 명령은 반복적인 유지 관리 작업을 지원함. --write는 모호하지 않은 프런트매터 수정을 적용하고, --patch는 패치를 생성하며, 충돌하는 메타데이터는 그대로 둠.
  • 코드 예제의 변경 제안은 검토가 필요하며, 쓰기 모드에서도 적용되지 않음.
  • 검증에 실패하더라도 워크플로는 복구 패치를 준비할 수 있음. 다만 수정 사항을 게시하거나 소스 검토를 대신 완료 처리하지는 않음.
  • 목표는 기계적인 수정에 드는 시간을 줄이면서 유지 관리자의 판단이 필요한 부분을 감추지 않는 것임.

대기 시간도 줄어듦

  • 이번 릴리스는 CLI 시작 및 검색 작업도 줄임. 런타임 라이브러리를 번들링해 Intent를 별도 런타임 의존성 없이 단일 패키지로 설치함.
  • 에이전트 훅은 세션이 시작될 때마다 패키지를 레지스트리에서 찾는 대신, 설치된 로컬 CLI가 있으면 이를 사용함. 기존 훅을 사용 중이라면 업데이트된 실행기를 적용하기 위해 intent hooks install을 다시 실행해야 함.

기존 스킬로 시작할 수 있음

  • 전체 스킬 라이브러리가 없어도 이 릴리스를 사용할 수 있음. 기존 스킬로 설정을 실행하고 예제를 검증한 뒤, 다음 소스 변경 때 검토 워크플로로 주의가 필요한 부분을 확인하면 됨.
  • 이전 버전에서 전환하는 경우 intent scaffold는 유지 관리 워크플로로 대체됨. maintainer adopt는 제거됐으며, 기존 스킬 등록은 이제 maintainer setup이 처리함.
  • 유지 관리자는 라이브러리를 어떻게 사용해야 하는지에 관한 지식을 이미 많이 보유하고 있음. 스킬은 그 지식을 코딩 에이전트에 전달하며, Intent 0.5는 스킬을 계속 확인하고 유지 관리하는 작업을 더 실용적으로 만듦.
  • [Intent 0.5 전체 릴리스 노트]( )