문서
Maro Portal과 Maro Writer의 단계별 사용 안내입니다. Mac의 실제 화면과 함께 설명합니다.
Maro Portal 안내
시작하기
- Mac에서 Maro Portal을 엽니다. 첫 화면은 데스크입니다.
- 쓰고 싶은 AI 제공자를 연결합니다. Anthropic Claude, OpenAI Codex, 온디바이스 모델 중에서 고릅니다.
- 중앙 대화에서 Maro와 이야기하고 일을 맡깁니다.
- 작업이 여섯 단계를 거치는 과정을 봅니다. 마감 전에 별도 검토자가 확인합니다.
- 나중에 개인 위키, 지식 지도, 연대기에서 다시 찾아봅니다.
화면 둘러보기
첫 화면은 데스크입니다. 왼쪽 메뉴에 데스크, 개인 위키, 작업, 도서관 등이 있습니다. 맡긴 일, 내린 결정, 배운 것은 모두 이 중 한곳에 남습니다.
작업 한 건의 흐름
모든 작업은 같은 여섯 단계를 거칩니다. 작업이 지금 어느 단계인지 언제든 볼 수 있고, 별도 검토자가 확인하기 전에는 완료로 치지 않습니다.
- 1
생성
대화에서 작업이 열리고, 요청은 원래 표현 그대로 남습니다.
- 2
점검
실행 전에 작업을 점검해, 추측이 아니라 분명한 요청에서 시작합니다.
- 3
실행
AI 작업자가 자기 세션에서 일을 합니다.
- 4
평가
별도 검토자가 결과를 확인합니다. 검토 기록에는 제공자가 적히고, 부분 통과는 부분 통과로 남습니다.
- 5
수확
결과물은 날짜별 작업 폴더로, 교훈은 작업 백과로 갑니다.
- 6
마감
작업은 기록과 함께 마감됩니다. 검토를 거치기 전에는 완료로 치지 않습니다.
개인 위키
브리핑, 결정, 조사가 페이지로 남습니다. 목록에는 인덱스, 최근, 중요, 주제, 사람, 태그, 보관함 탭이 있고, 미리보기 패널에서 '이어 쓰기'와 '원문 열기'를 할 수 있습니다. 페이지마다 목차, 출처, 그리고 분류, 판 번호, 열린 질문, 최근 변경을 보여 주는 '한눈에' 상자가 있습니다.

화면 설명
화면: 개인 위키 목록입니다. 탭은 인덱스, 최근, 중요, 주제, 사람, 태그, 보관함입니다. 2026-08-13부터 2026-10-03까지의 페이지가 분류, 날짜와 함께 나열되어 있고, 예를 들어 '개인 AI 운영체제의 네 공간', '규칙은 방향, 금지는 명시', '메인 지휘가 설계하고 워커가 구현한다'가 있습니다. 오른쪽 미리보기에 '이어 쓰기'와 '원문 열기'가 있습니다.

화면 설명
화면: '아침신문 2026-10-07' 위키 페이지이며 마로 편집으로 표시되어 있습니다. 목차(AI 소식, 출처), '오늘 AI 소식' 섹션의 한 줄 요약, 그리고 무엇인지, 왜 우리에게 필요한지, 어떻게 쓸지, 확인 정도로 나눈 소식 항목이 있습니다. '한눈에' 상자에 분류, 판 2, 열린 질문, 최근 변경 10월 7일이 보입니다.
지식 지도
기록이 아침신문, 운영 원칙, 보고 같은 주제 섬으로 묶입니다. 둘러보기, 바다, 숲, 성좌, 연결, 성장, 시간의 일곱 가지 보기 탭으로 다르게 볼 수 있습니다.

화면 설명
화면: Maro Portal의 지식 지도입니다. 보기 탭은 둘러보기, 바다, 숲, 성좌, 연결, 성장, 시간의 일곱 가지입니다. 주제 섬으로 아침신문 · 5쪽(2026-10-03~10-05 페이지), 운영 원칙, 보고, 온톨로지, 창조역사, 개인 AI 운영체제가 있고, 왼쪽 메뉴에 데스크, 개인위키, 작업, 도서관 등이 있습니다.
도서관
자료는 다섯 방에 모입니다. 위키 서가, 세컨드 브레인, 지식 지도, 책·PDF·사진·영상·문서를 보는 뷰어실, 지식 정원입니다. 아래쪽 질문 입력창으로 사서 마로에게 물을 수 있습니다.

화면 설명
화면: '생각이 머물고 다시 자라는 도서관' 페이지입니다. 방 다섯 개와 항목 수가 보입니다. 마로위키(9), 세컨드 브레인(483), 지식지도, 뷰어실(책·PDF·사진·영상·문서, 151), 지식 정원(90). '사서 마로가 함께 있어요' 표시와 아래쪽 질문 입력창이 있습니다.
작업 백과
규칙, 개념, 교훈이 분류별로 정리됩니다. 오늘의 문서, 알고 계셨나요, 새 문서, 최근 바뀜 패널이 있어 지난 실수가 이후 작업의 점검표가 됩니다.

화면 설명
화면: '마로백과'입니다. 오늘의 문서, 알고 계셨나요, 새 문서, 최근 바뀜 패널과 '전체 219장'으로 설정된 분류 목록(1쪽, 전체 28쪽)이 있습니다. 항목으로 '모든 작업자의 공통 규칙', '공방 사례집의 오답', '관제 표준' 등이 보입니다.
연대기
작업 아래의 연대기는 지난 작업을 그림이 있는 이야기로 한 쪽씩 다시 보여 주고, 그날 배운 것과 작업 단계 흐름 띠를 함께 보여 줍니다.

화면 설명
화면: 작업 아래 '연대기' 화면으로, "md 줄이고 바로 가자"라는 이야기의 1쪽(전체 5쪽)입니다. 그림 옆에서 대표님께 이야기하듯 지난 작업을 들려주고, '이날 배운 것' 상자, 작업 단계를 보여주는 '흐름 띠', 1~5쪽 버튼이 있습니다.
AI 제공자
쓰고 싶은 제공자를 연결합니다. Anthropic Claude, OpenAI Codex, 온디바이스 모델 중에서 고릅니다. AI 호출은 연결한 제공자에게만 나갑니다. 제공자는 바꿔 끼울 수 있는 부품이라, 모델이 바뀌어도 작업 이력은 그대로입니다.
Maro Writer 안내
시작하기
- 작품 서가를 열고 새 작품의 제목과 장르를 입력한 뒤 "만들고 열기"를 누릅니다.
- 작품의 집필 방식을 고릅니다. AI 주도, 작가 주도, 함께 쓰기 중 하나입니다.
- 회차별로 씁니다. 문장을 선택하면 그 자리에서 요청하고, 비교하고, 반영할 수 있습니다.
- 마음에 드는 것만 채택합니다. 채택한 초안만 원고에 들어가고, 원본은 따로 보관됩니다.
- 장르 도구를 씁니다. 용어 사전과 이름 짓기 도구가 원고 옆에 있습니다.
작품 서가
모든 작품이 한 서가에 놓이고, 작품마다 장르와 마지막으로 연 시각이 보입니다. 새 작품 양식에 제목과 장르를 넣고 '만들고 열기'를 누르면 바로 원고로 들어갑니다.

화면 설명
화면: '작품 서가'에 내 작품 2편이 있습니다. 이도(무협, 마지막 연 때 2026-09-29 오후 11:42)와 별의 서고(판타지, 2026-10-08 오전 10:21)입니다. 오른쪽에 제목, 장르 입력과 '만들고 열기' 버튼이 있는 새 작품 양식이 있습니다.
원고 화면
원고 화면에는 글자 수, 어절 수, 문단 수와 '원본은 별도로 보존됨' 표시가 보입니다. 위쪽에 설계 모드와 집필 모드 버튼이 있고, 원고 옆 탭에 원고, 대화, 목차, 설계, 세계, 사전, 검토가 있습니다.

화면 설명
화면: Maro Writer 창(maro-writer-v1)에 《이도》 1화 · 채우지 않는 자 원고가 열려 있고, 12,254자 · 2,916어절 · 397문단, '원본은 별도로 보존됨' 표시가 있습니다. 위쪽에 설계 모드와 집필 모드 버튼이 있습니다. 오른쪽 '《이도》 공동 집필' 패널이 2화에 대한 질문에 답하고 '확인한 원고 근거 5곳'을 보여줍니다.
집필 방식
작품마다 방식을 고릅니다. 어떤 방식이든 AI 초안은 작가가 채택할 때만 원고에 들어갑니다.
AI 주도
AI가 초안을 쓰고 작가가 채택할 것을 고릅니다.
작가 주도
작가가 쓰고, 요청할 때 AI가 돕습니다.
함께 쓰기
작가와 AI가 나란히 회차를 씁니다.
근거와 함께 묻기
Claude 연결로 공동 집필 패널에 이야기에 대해 묻습니다. 답은 확인한 원고 근거와 함께 돌아오므로, 무엇을 근거로 했는지 볼 수 있습니다.
장르 도구와 테마
무협 사전에는 모두, 작품 사전, 무협 일반 탭이 있고 항목마다 '대화에 넣기' 버튼이 있습니다. 위쪽에 초식 이름 짓기 도구가 있습니다. 판타지 작품의 밤하늘 책상처럼 작품마다 테마를 따로 둘 수 있습니다.

화면 설명
화면: 《이도》의 '무협 사전'으로 475개 용어가 있고 탭은 모두, 이도 사전, 무협 일반입니다. 강호(江湖), 무림(武林), 정파(正派), 사파(邪派), 협(俠), 은원(恩怨) 등 항목마다 '대화에 넣기' 버튼이 있습니다. 위쪽에 '초식 이름 짓기'가 있고 오른쪽에 《이도》 공동 집필 패널이 있습니다.

화면 설명
화면: 밤하늘 테마로 《별의 서고》 1화 · 떨어지지 않는 별의 책 원고가 열려 있고 2,994자 · 758어절 · 59문단입니다. 옆 탭은 원고, 대화, 목차, 설계, 세계, 사전, 검토입니다. '《별의 서고》 공동 집필' 패널에 AI주도, 사용자주도, 같이의 집필 방식이 보입니다.
시스템 요구 사항
Maro Portal
| 운영체제 | macOS |
|---|---|
| 작동 방식 | 네이티브 앱 + 같은 Mac의 로컬 Node.js 서버 |
| AI | 연결한 제공자: Anthropic Claude, OpenAI Codex, 온디바이스 모델 |
| 화면 언어 | 한국어 |
Maro Writer
| 운영체제 | macOS |
|---|---|
| 작동 방식 | 네이티브 macOS 앱 |
| AI | 공동 집필용 Claude 연결 |
| 화면 언어 | 한국어 |