소프트웨어 개발 프로세스를 시작하는 intent.md는 여러 경로를 통해 유입될 수 있습니다. 어떤 사람이 아이디어를 떠올리거나, 티켓이 등록되거나, 알림을 통해 인시던트가 드러나는 경우입니다 (Stage 6: Maintain 참조).
어떤 사람이 아이디어를 떠올리면, 그 사람은 Claude와 브레인스토밍을 하여 Markdown 형식의 프로토 스펙을 만들어냅니다. 전통적인 SDLC에서는 같은 사람이 제품팀 구성원을 설득해 함께 또는 자신을 대신해 아이디어를 문서화하도록 해야 합니다.
Claude가 생성한 프로토 스펙은 사람이 읽을 수 있고, 버전 관리가 되며, 다음 단계에서 바로 사용할 수 있습니다. 이 프로토 스펙은 intent.md로 저장됩니다.
의도가 이벤트 트리거에서 비롯되었든 사람에게서 비롯되었든, 동일한 단계가 적용됩니다. 즉, 제품 책임자가 에이전트가 작성한 intent.md를 검토하고 수정한 후 커밋합니다.
달라지는 점
| 전통적 방식 | AI 네이티브 방식 |
|---|---|
| 아이디어는 백로그 항목, 사용자 스토리, 스토리 포인트, 정제 회의를 거친 후에야 누군가가 그것에 대해 행동할 수 있습니다. 각 인계 단계마다 소유권이 이전되므로, 엔지니어링에 도달하는 내용은 원래 의도한 바와 여러 단계만큼 멀어져 있습니다. | 발안자는 Claude와 브레인스토밍을 하고 그 결과를 발안자 자신의 언어로 된 프로토 스펙인 intent.md로 작성합니다. 이 아티팩트에는 무엇을 원하는지, 왜 원하는지, 어떤 제약 조건 하에서인지가 담겨 있습니다. 반복되는 프로세스는 스킬을 통해 인코딩됩니다. |
시작하기
- 전제 조건: 없음.
- 인프라: 엔지니어가 아닌 사람들을 위한 Claude 접근 권한(claude.ai 또는 Cowork); 합의된
intent.md템플릿; 제품 책임자가 주시하는, 공유되고 버전 관리되는 의도의 저장 위치. 단일 제품의 경우 가장 간단한 저장 위치는 제품 저장소 내의intent/폴더입니다. 이 설정은 아티팩트 체인을 그로부터 파생된 코드 바로 옆에 유지합니다. 전용 의도 저장소는 의도가 여러 저장소에 걸쳐 있을 때만 그 오버헤드를 감수할 가치가 있으며, 모노레포에서는 단순히 하나의 디렉터리입니다. Stage 3: Build의 레거시 시스템 섹션에서는 이 저장 위치가 이미 기록을 보유하고 있는 Jira나 요구사항 도구와 어떻게 연관되는지 다룹니다.
이를 설정하는 것은 플랫폼 또는 엔지니어링 팀이 한 번만 수행하면 되는 작업입니다. 많은 기여자가 조직 전반에서 참여하게 되므로, 기술 팀 구성원이 의도 저장 위치를 구축하고 누가 그곳에 쓸 수 있는지 결정해야 합니다.
저장소가 만들어지면, Git 경험이 없는 기여자도 Git을 직접 사용할 필요가 없습니다. 대신 버전 관리 시스템(예: GitHub)에 대한 커넥터를 통해 Claude가 claude.ai나 Cowork에서 그들을 대신해 Markdown 파일을 커밋할 수 있습니다.
실행 방법
- 발안자는 자신의 언어로 Claude에게 문제를 설명합니다. 발안자는 오늘 할 수 없는 것, 이 아이디어로 영향을 받는 사람, 더 나은 상태가 어떤 모습인지, 또는 범위에서 제외되는 것을 설명할 수 있습니다. 형식을 갖춘 언어는 필요하지 않습니다.
- 아이디어가 구체화될 때까지 브레인스토밍합니다. Claude는 분석가가 물을 법한 질문들, 즉 범위, 사용자, 제약 조건, 성공의 모습 등을 묻습니다.
- Claude에게 조직의 템플릿을 사용해 결과를
intent.md로 작성하도록 요청합니다. 이 템플릿은 기술 팀 구성원이 구축하고 리드가 승인한 스킬 세트로 인코딩될 수 있습니다. 여기에는 문제, 제안된 결과, 영향을 받는 사용자 및 시스템, 제약 조건, 미해결 질문이 포함될 수 있습니다. - 발안자는 Claude가 잘못 이해한 부분을 수정합니다.
intent.md를 공유 저장 위치에 커밋합니다. 작성자와 타임스탬프가 기록에 함께 남으며, 제품 책임자가 그 지점부터 아이디어를 이어받습니다.
실제 모습
intent.md:
# Intent: claims status self-service
Author: J. Ortiz (claims operations). Status: draft.
## Problem
Customers phone the contact center to ask where their claim is.
Handlers spend roughly a third of call time on status-only queries.
## Proposed outcome
Customers see claim status, next step and expected date in the portal.
## Affected users and systems
Claims handlers, portal team, claims-core API.
## Constraints
No new PII in the portal session. Existing authentication only.
## Open questions
Do third-party loss adjusters need access too?거버넌스 고려사항
증거는 커밋된 intent.md이며, 여기에는 작성자, 타임스탬프, 전체 수정 이력이 기록됩니다. 이는 의도 저장 위치의 Git 이력에 기록됩니다. 제품 책임자가 승인하며, 의도를 Stage 2: Design으로 보내는 수락 또는 거부 결정은 병합 또는 종료 리뷰로 기록됩니다.
측정 방법
- 선행 지표: 첫 대화부터
intent.md커밋까지 걸린 시간으로, 작성자와 타임스탬프를 기록하는 의도 저장 위치의 Git 이력에서 읽어옵니다. 이는 수 주에 걸친 요구사항 수집 및 정제 주기에서 몇 시간 단위로 줄어들 것으로 기대됩니다. - 후행 지표: 생존율, 즉 제품 책임자가 종료하지 않고 Stage 2: Design으로 수락하는
intent.md파일의 비율입니다. 수락 또는 거부 결정은 아티팩트의 병합 또는 종료된 리뷰로 기록됩니다. 추가로, 동일한 변경 건에 대해 첫spec.md커밋 이후intent.md에 가해진 변경 횟수를 집계합니다.