본문으로 건너뛰기
SpecifyDocs

설계·캔버스와 AI

문서 작성과 편집

문서와 캔버스를 편집하고 에이전트 편집 잠금, 변경 기록과 되돌리기로 결과를 관리합니다.

Specify에서는 문서와 캔버스를 같은 워크스페이스에서 다룹니다. 문서로 기능과 근거를 설명하고, 캔버스로 구성 요소와 데이터 흐름을 검토하세요. AI가 만든 결과도 직접 편집하고 팀과 함께 다듬을 수 있습니다.

문서 만들고 편집하기

탐색기의 새 파일로 문서를 만들거나 채팅에서 문서 작성을 요청합니다. 제목을 바꾸고 본문에 입력하면 변경 사항이 자동 저장됩니다. 마크다운 입력으로 제목과 목록을 만들 수 있으며, 빈 줄에서 /를 입력하면 블록 메뉴가 열립니다.

제목, 목록, 인용, 코드 블록, 표, 이미지, 콜아웃, 토글 등 내용에 맞는 블록을 선택합니다. API 이름이나 코드 예시는 코드 블록으로 구분하면 읽기 쉽습니다.

맘마의 실제 코드를 바탕으로 만든 프로젝트 개요 문서
코드 근거와 주요 구성요소를 문서에서 확인합니다.

저장 상태 확인하기

자동 저장 상태를 확인하고 저장되지 않음이 표시되면 저장 다시 시도를 누릅니다. 저장되지 않은 내용은 현재 기기에만 남아 있을 수 있습니다. 탭을 닫거나 다시 불러오기 전에 필요한 내용을 복사하세요.

권한이 변경되거나 다른 사람이 문서를 복원하면 다시 불러오기가 필요할 수 있습니다. 먼저 로컬 변경을 보관한 뒤 화면의 안내에 따릅니다.

맘마의 구성요소와 데이터 흐름을 보여주는 아키텍처 캔버스
설계도에서 의존 관계와 데이터 흐름을 리뷰합니다.

캔버스로 아키텍처 검토하기

채팅에서 저장소를 근거로 아키텍처 설계도를 요청하고 생성된 캔버스를 엽니다. 구성 요소와 연결선을 확인하고, 배치와 설명을 직접 편집할 수 있습니다. 에이전트에게 기존 캔버스의 특정 부분을 고쳐 달라고 요청할 때는 보존할 요소와 변경할 범위를 함께 적으세요.

문서의 설명과 캔버스의 연결 방향을 대조하며 의존성과 시스템 경계를 함께 검토하세요. 캔버스 저장에 실패하면 저장 재시도를 사용하고, 필요하면 초안을 내려받아 보관합니다.

하단 입력창에서 캔버스 개선하기

캔버스를 연 뒤 하단에 **캔버스에 명령하기…**가 표시됩니다. 도형·연결선을 선택하고 “이 부분만 라벨과 배치를 정리하고 나머지 연결은 유지해 줘”처럼 요청하세요. 에이전트와 대화하며 구조를 그려 나가는 방법은 캔버스 가이드를 참고하세요.

캔버스 하단에서 맘마 구조의 개선을 요청하는 화면
그림을 보면서 변경 대상과 유지할 조건을 함께 전달합니다.

AI 변경 이력과 편집 잠금

AI가 변경한 문서는 변경 이력에서 수정 내용을 확인하고 되돌릴 수 있습니다. 검토하거나 사람이 정리하는 동안 에이전트 편집을 잠글 수 있으며, 사람의 편집은 계속할 수 있습니다.

공동 작업자가 같은 대상을 수정한 경우에는 다른 사람의 변경을 보존하기 위해 되돌리기가 제한될 수 있습니다. 최신 내용을 확인한 뒤 필요한 부분만 다시 수정하세요.

저장소와 연결하기

문서와 캔버스 각각의 연결에서 저장소와 브랜치를 확인합니다. 소유자는 연결 관리 → 이벤트 연결로 자동 갱신을 설정합니다. 다음 push에서 관련된 변경을 직접 반영하므로, 결과는 인박스와 변경 이력에서 확인하세요.

문서와 설계도 만들기와 연결 관리를 참고하세요.