Figma Specs 마크다운 PRD 가져오기: 디자인과 요구사항 함께 검토하기

필요한 곳부터 보기: 플랜·배포 조건 · PRD 가져오기 · 수정 전후 검토 예제 · 권한·MCP 확인

Specs 메뉴가 없다면 플랜과 계정별 배포부터 확인하세요

Figma는 2026년 10월 15일 Specs를 발표하며 공개 베타의 점진 배포를 시작했습니다. 전체 계정의 제공 완료 날짜는 확인되지 않았습니다. 같은 팀 안에서도 기능을 받는 시점이 다를 수 있으므로 동료에게 메뉴가 있다고 내 계정에도 표시된다고 가정할 수는 없습니다. Figma Specs 발표

공식 사용 가이드의 지원 목록은 Professional·Education·Organization·Enterprise이며 파일 편집 권한이 필요합니다. Starter도 포함된 Figma의 다른 기능이나 MCP의 지원 목록과 구분하세요. 문서를 가져오고 수정할 담당자는 대상 파일의 편집 권한부터 확인합니다. Specs 지원 플랜·편집 조건

기능이 제공된 계정에는 파일 브라우저의 Spec 생성 항목과 Figma Design·FigJam 툴바의 Spec 아이콘이 표시됩니다. 메뉴가 없다면 현재 계정이 속한 플랜 → 파일 권한 → 점진 배포 여부 순서로 확인하세요. 파일 내용을 고치거나 같은 PRD를 반복 업로드하기 전에 확인할 조건입니다.

직접 편집과 에이전트 작업의 크레딧을 구분하세요

작업 방식	공식 안내의 AI 크레딧 조건	확인할 항목
Spec 본문을 직접 작성·편집	에이전트를 사용하지 않으며 AI 크레딧 미차감	직접 편집과 에이전트 요청을 구분
독립 Spec·Figma Design에서 에이전트로 생성·편집	AI 크레딧 소비. 작업·처리 문맥에 따라 달라짐	실행 뒤 요청별 소비 내역
FigJam 안에서 에이전트와 Specs 사용	FigJam 에이전트의 베타·크레딧 적용 각주 확인 필요	해당 계정의 제공 여부와 사용 시점 정책

10월 19일 확인한 크레딧 문서는 FigJam 에이전트가 닫힌 베타 동안 크레딧을 소비하지 않는다고 안내합니다. Specs 가이드에는 FigJam 에이전트가 크레딧을 소비하기 시작하면 그 안의 Specs 에이전트 작업에도 적용된다는 각주가 있습니다. 이를 “모든 계정의 FigJam Specs 에이전트가 계속 무료”라고 해석하면 안 됩니다. AI 크레딧과 FigJam·Specs 각주

에이전트 작업은 요청 복잡도와 읽는 문맥에 따라 소비량이 달라집니다. 작업 후 영수증·AI 크레딧 표시에서 실제 사용량을 확인하세요. 본문을 직접 고친 사실과 에이전트에 수정 요청을 보낸 사실을 함께 기록하면 비용을 구분하기 쉽습니다.

마크다운 PRD 하나를 가져와 본문부터 대조하기

공식 발표는 .md 파일을 캔버스에 끌어 놓아 Spec으로 가져오는 방식을 안내합니다. 처음에는 원본의 복사본 하나로 확인하고, 가져온 문서를 팀의 검토 기준으로 삼을지 정하세요.

1. 편집 가능한 Figma Design 파일이나 FigJam 보드를 엽니다.
2. 로컬의 .md PRD를 캔버스에 끌어 놓습니다.
3. 가져온 제목·문단·목록을 원본과 대조하고, 요구사항과 예외 조건이 빠지지 않았는지 확인합니다.
4. 검토할 Spec의 위치를 정한 뒤 관련 디자인 참조를 추가합니다.

가져오기용 PRD 원본 예제와 원본·수정안·비교 diff·검토 기록표 ZIP을 준비했습니다. 비밀정보 없는 가상 뉴스레터 구독 폼 문서이며 제목·문단·목록으로 구성했습니다. 실제 Figma 파일에서 가져오기·렌더링을 확인한 결과물은 아닙니다.

예제에는 REQ-01부터 REQ-04까지 네 가지 요구사항과 F-01부터 F-05까지 연결할 화면 이름이 있습니다. 가져온 뒤에는 요구사항 네 개의 본문이 모두 남았는지 확인하세요. 프레임 이름을 글로 적은 것과 실제 디자인 참조를 연결한 것은 다릅니다.

요구사항마다 확인할 프레임과 화면 상태 연결하기

Specs는 캔버스의 프레임·노드나 FigJam 다이어그램을 문서 안에 참조할 수 있습니다. 같은 캔버스의 관련 내용을 Spec으로 끌어 넣으면 문장 옆에서 디자인을 함께 검토하는 구성을 만들 수 있습니다. 디자인·다이어그램과 Specs의 연결 방식

아래는 예제 PRD의 요구사항과 연결할 화면을 정리한 표입니다. 실제 프레임 URL이나 완성된 디자인이 포함된 자료는 아니므로, 자신의 디자인에서 해당 상태를 찾거나 만든 뒤 참조를 추가합니다.

요구사항	연결할 화면	함께 검토할 내용
REQ-01 입력 검증	F-01 기본 입력 · F-02 입력 오류	오류 위치와 요청을 보내지 않는 조건
REQ-02 요청 진행	F-03 전송 중	진행 표시·버튼 비활성화·중복 요청 방지
REQ-03 완료	F-04 완료	완료 안내와 이메일 마스킹
REQ-04 실패 후 재시도	F-05 요청 실패 · F-03 전송 중	입력값 유지와 재시도 중 상태 전환

한 요구사항이 한 화면으로 끝나지 않을 수도 있습니다. 실패 뒤 재시도는 오류 화면뿐 아니라 다시 전송 중인 화면도 확인해야 합니다. 참조가 열리면 파일 이름만 보지 말고 의도한 프레임·상태가 맞는지 확인하세요.

댓글은 모호한 요구사항과 바뀔 화면을 함께 가리키게 쓰기

예제 원본의 REQ-04는 “요청에 실패하면 오류 안내와 재시도 버튼을 보여 줍니다”로 끝납니다. 이 문장만으로는 입력값을 유지할지, 재시도 중 버튼을 어떻게 처리할지 알기 어렵습니다. 검토 의견을 다음처럼 구체화할 수 있습니다.

REQ-04에서 실패 후 이메일 유지 여부를 정해주세요. F-05에는 유지된 입력을, 재시도 중 F-03에는 진행 표시와 비활성화된 버튼을 확인할 수 있어야 합니다.

수정안 PRD는 입력값 유지·재시도 버튼 활성화·재시도 중 REQ-02 적용을 추가합니다. 로컬 문서의 실제 수정 전후 diff에서 차이를 볼 수 있습니다. 이 비교는 작성한 예제 파일 사이의 차이이며 Figma 댓글이나 팀 승인 기록이 아닙니다.

검토할 때는 해당 요구사항 문장과 관련 프레임에 의견을 연결하고, 수정 후 같은 위치를 다시 확인합니다. 댓글을 해결 처리한 것과 요구사항·디자인에 의견이 반영된 것은 각각 확인해야 합니다. 문서를 복제하거나 수정안을 따로 가져왔다면 어느 Spec이 최신 기준인지도 명확히 정하세요.

Figma의 일반 댓글 가이드는 Design·FigJam 파일에서 최소 열람 권한으로 댓글을 사용할 수 있다고 안내합니다. Spec 생성·편집 권한과 구분해 검토자를 구성하세요. 댓글 사용·검토 안내

반복 보고서를 생성하는 템플릿·입력·배포 흐름이 필요하다면 AI 문서 자동화 안내를 참고할 수 있습니다. 이번 예제는 PRD의 요구사항과 디자인 상태를 함께 검토하는 데 집중합니다.

문서와 참조의 접근 권한은 검토자 계정으로 확인하세요

작성자가 보는 화면을 동료도 볼 수 있다고 가정하지 마세요. Share에서 대상과 열람·편집 권한을 확인한 뒤, 실제 검토자 계정에서 Spec과 참조 원본을 각각 열어 봅니다. 문서가 열려도 필요한 디자인이 보이지 않으면 공동 검토가 끝난 상태가 아닙니다. 파일 공유·접근 수준 설정

• 편집자: 본문 수정, 연결한 프레임 열기와 기존 댓글 위치를 확인합니다.
• 열람자: 문서·참조를 볼 수 있는지, 해당 환경에서 댓글을 남길 수 있는지 확인합니다.
• MCP 인증 계정: 본문과 참조 중 실제로 읽은 범위와 접근하지 못한 대상을 확인합니다.

외부 에이전트는 Figma MCP의 figma-spec 스킬로 독립 Spec과 Design·FigJam 안의 Spec을 읽고 생성·수정할 수 있습니다. 공식 MCP 가이드는 Spec 쓰기에 remote 서버와 파일 편집 권한이 필요하다고 안내합니다. 링크 전달은 계정의 파일 권한을 대신하지 않습니다. Specs의 MCP 사용 조건 · MCP 파일 접근 오류 확인

Figma 화면 안의 에이전트 댓글 기능과 외부 MCP 스킬의 댓글 워크플로는 구분해야 합니다. 발표는 화면 내 에이전트의 댓글 읽기·답변을 소개하지만, 10월 19일 확인한 figma-spec 도움말은 댓글 워크플로 지원을 향후 제공으로 표시합니다. 외부 에이전트가 문서를 읽었다고 댓글까지 모두 읽고 처리했다고 판단하지 마세요. figma-spec의 현재 범위

예제에 에이전트를 연결한다면 “REQ-04와 F-03·F-05에서 확인한 조건, 읽지 못한 참조를 각각 알려주세요”처럼 요청할 수 있습니다. 답변은 원문·프레임과 사람이 대조해야 하며, 문맥 전달 성공이 구현 결과의 요구사항 준수를 보장하지는 않습니다.

누락과 접근 실패를 구분하는 확인 순서

보이는 현상	먼저 확인할 항목
Specs 생성 메뉴가 없음	현재 계정의 지원 플랜·편집 권한·점진 배포 여부
본문은 보이지만 화면 참조가 없음	텍스트로 적은 이름·일반 링크인지 실제 디자인 참조인지
작성자만 참조 원본을 열 수 있음	검토자가 사용하는 계정과 원본 파일의 공유 범위
문서 수정 후 댓글의 의미가 달라짐	댓글이 가리키는 문장·프레임과 현재 문서 버전
외부 에이전트가 일부 문맥을 놓침	인증 계정·읽은 참조·스킬의 현재 지원 범위

가져오기·프레임·댓글·계정별 접근 기록표에 관찰 결과를 남길 수 있습니다. 가져오기 완료, 참조 확인, 동료 검토, 구현 검증은 서로 다른 결과로 기록합니다. 이 양식의 실제 계정별 결과는 비워 두었습니다.

자주 묻는 질문

Specs 메뉴가 없으면 플랜 문제인가요, 점진 배포인가요?

지원 플랜·파일 편집 권한을 먼저 확인하고 계정별 점진 배포도 확인해야 합니다. 같은 팀의 다른 사람에게 메뉴가 보여도 내 계정의 제공 시점은 다를 수 있습니다. 전체 계정의 배포 완료일은 확인되지 않았습니다.

직접 편집과 에이전트 편집의 크레딧 차이는 무엇인가요?

Spec 본문을 직접 쓰고 고치면 AI 크레딧이 들지 않습니다. 에이전트를 쓰는 작업은 소비 조건을 확인해야 합니다. FigJam 경로는 에이전트의 베타 상태와 크레딧 적용 각주를 함께 확인하세요.

문서 링크만 전달하면 에이전트가 모든 참조에 접근할 수 있나요?

링크만으로 파일 권한이 생기지는 않습니다. 인증 계정이 Spec과 참조를 실제로 읽었는지 확인해야 하며, 본문·디자인 참조·댓글의 지원 범위도 구분해야 합니다. 읽은 내용이 구현에 반영됐는지는 별도 검증 대상입니다.

확인 범위와 업데이트 기록

공식 발표일은 2026년 10월 15일, 사용 조건·크레딧·MCP 문서 확인일은 10월 19일입니다. 이 글은 공식 조건 분석과 공동 검토 설계이며 실제 Figma 가져오기·댓글 보존·역할별 접근·크레딧 소비를 재현한 후기가 아닙니다. 예제는 로컬에서 작성한 두 PRD와 그 비교 자료입니다. 베타·플랜·크레딧·MCP 댓글 지원이 바뀌면 해당 항목을 갱신합니다.