Intent

Intent란 무엇인가요?

Intent는 에이전트를 조율하여 변경 사항을 구현하면서 스펙을 코드베이스와 동기화할 수 있는 개발 워크스페이스입니다. 핵심 목적은 스펙을 진실의 원천으로 간주하고 에이전트가 작업을 완료함에 따라 이를 업데이트하여 요구사항이 진화할 때 프로젝트가 어긋나지 않도록 돕는 것입니다.

일반 워크플로우 외에도 Intent는 크로스 서비스 JWT 인증에 초점을 맞춘 데모를 통해 에이전트 조율을 지원하는 것으로 설명됩니다. 그 예에서 별도의 에이전트가 시스템의 다른 부분을 담당하며, 한 에이전트는 인증 서비스에서 토큰 발급, 갱신, 취소를 처리하고, 다른 에이전트는 API 게이트웨이에서 JWT 검증 미들웨어와 관련 동작을 추가합니다. 페이지에는 워크스페이스가 격리되어 있으며, Intent가 Apple Silicon용 macOS에서 사용 가능하다는 내용도 있습니다.

주요 기능

• 스펙 우선 개발 워크플로우: Intent는 살아있는 스펙을 진실의 원천으로 사용하도록 설계되어 코드베이스가 진화함에 따라 이를 정렬합니다.
• 개발 워크스페이스 내 에이전트 조율: 여러 에이전트가 변경 사항을 구현하기 위해 함께 작동하며, 작업을 분리된 단계로 취급하지 않습니다.
• 살아있는 스펙 동기화: 에이전트가 작업을 완료함에 따라 스펙이 업데이트되어 프로젝트가 요구사항에서 벗어나지 않습니다.
• 격리된 워크스페이스: 각 워크스페이스가 격리되어 병렬 작업 흐름을 분리하는 데 도움이 됩니다.
• 에이전트 기반 구현 예시 (JWT 인증): 데모는 서비스 간 조율된 구현을 보여줍니다—인증 서비스의 토큰 생애주기 작업과 API 게이트웨이의 JWT 검증 동작.

Intent 사용 방법

1. 스펙을 진실의 원천으로 시작하세요. 구현하려는 기능이나 변경 사항을 정의하는 데 스펙을 사용합니다.
2. 워크스페이스를 사용해 에이전트 작업을 조율하세요. 에이전트가 동일한 워크스페이스의 일부로 서로 다른 구현 책임을 맡아 출력이 스펙과 연결되도록 합니다.
3. 스펙을 동기화하면서 변경 사항을 구현하세요. 작업이 완료됨에 따라 살아있는 스펙이 코드베이스에 구현된 내용을 반영하도록 업데이트됩니다.
4. 조율된 컴포넌트 간 동작을 검증하세요. 크로스 서비스 JWT 인증 같은 시나리오에서는 토큰 생애주기 책임(발급/갱신/취소)과 게이트웨이 검증 책임이 조율된 작업으로 모두 커버되는지 확인합니다.

사용 사례

• 어긋남 없이 진화하는 요구사항 관리: 스펙이 변경될 때 Intent는 구현이 진행됨에 따라 코드와 스펙을 정렬합니다.
• 크로스 서비스 기능 구현: JWT 인증 데모는 인증 서비스와 API 게이트웨이 간 변경 조율을 보여줍니다.
• 서브시스템별 작업 분할: 에이전트가 서로 다른 영역(예: 한 서비스의 토큰 관리와 다른 서비스의 요청 검증)을 맡으면서 단일 동기화된 스펙 아래 유지됩니다.
• 다양한 작업을 위한 격리된 작업 흐름: 격리된 워크스페이스는 여러 변경이 진행 중일 때 병렬 노력의 분리를 지원합니다.

자주 묻는 질문

Q: Intent가 해결하는 문제는 무엇인가요?
A: 스펙을 진실의 원천으로 간주하고 에이전트가 작업을 완료함에 따라 이를 코드와 동기화하여 프로젝트 “어긋남”을 해결합니다.

Q: 이 맥락에서 “살아있는 스펙”이란 무엇인가요?
A: 구현이 완료됨에 따라 스펙이 업데이트되어 요구사항이 현재 코드베이스와 정렬되며, 구식이 되지 않습니다.

Q: Intent가 여러 서비스 간 작업을 조율할 수 있나요?
A: 네. 크로스 서비스 JWT 인증 데모에서 한 에이전트가 인증 서비스에서 토큰 발급/갱신/취소를, 다른 에이전트가 API 게이트웨이에서 JWT 검증 미들웨어와 지원 동작을 담당합니다.

Q: 워크스페이스가 격리되어 있나요?
A: 페이지에 각 워크스페이스가 격리되어 있다고 명시되어 있습니다.

Q: Intent가 macOS에서 사용 가능한가요?
A: 페이지에 Apple Silicon용 macOS에서 사용 가능하다고 나와 있습니다.

대안

• 전통적인 개발 도구를 사용한 스펙-구현 워크플로: 팀은 문서화 도구를 통해 수동으로 또는 표준 버전 관리 관행을 사용해 살아있는 문서나 요구사항 파일을 동기화할 수 있습니다.
• 에이전트 오케스트레이션 프레임워크: 전용 “개발 워크스페이스” 제품 대신, 팀은 자율 워커를 조율하는 에이전트 오케스트레이션 도구를 사용하고 자체 스펙 동기화 프로세스를 결합할 수 있습니다.
• 인간 검토를 동반한 AI 지원 코드 생성: 프롬프트로부터 코드를 생성하는 도구는 기능 구현을 도울 수 있지만, 스펙 동기화는 팀의 검토 및 문서화 관행으로 처리됩니다.
• CI/CD와 코드 리뷰를 사용한 수동 크로스-서비스 구현: JWT 인증과 같은 조율된 기능의 경우, 팀은 표준 엔지니어링 워크플로를 통해 각 서비스에서 변경을 구현하여 컴포넌트 간 일관성을 보장할 수 있습니다.