> For the complete documentation index, see [llms.txt](https://docs.manyfast.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.manyfast.io/use/ai-1.md).

# 매니(AI) 커스터마이징

매니패스트 AI인 매니

매니 커스터마이징을 사용하면 프로젝트마다 매니가 따를 말투, 문서 작성 방식, 팀 용어와 금지사항을 정할 수 있습니다. 입력하지 않은 항목에는 별도 규칙이 적용되지 않습니다.

## 지원 플랜과 사용 범위

#### **플랜별 제공 범위**

* **Starter:** 대화 말투만 설정하고 저장할 수 있습니다. 기획서 스타일, 기능 설명 양식, 우리 팀 용어, 금지사항, 추가 정보는 Pro 전용으로 잠기며, 잠긴 항목을 선택하면 업그레이드 안내가 표시됩니다.
* **Pro와 Team:** 모든 설정 항목과 미리보기, 기존 문서 적용을 사용할 수 있습니다. 기존 문서 적용은 AI 재작성 작업이므로 크레딧이 사용됩니다.
* **프로젝트별 적용:** 설정은 현재 프로젝트에 저장됩니다. Team 플랜에서도 한 프로젝트의 규칙이 그룹의 다른 프로젝트에 자동으로 적용되지는 않습니다.
* **플랜 변경:** 플랜을 Starter로 변경하면 이전에 저장한 Pro 설정은 보존되어 확인할 수 있지만 새로 편집할 수는 없습니다. 대화 말투는 계속 수정할 수 있습니다.

## 1. 커스터마이징 열기

프로젝트 에디터의 **왼쪽 채팅 패널 상단에서 조절 아이콘**을 선택합니다. 커스터마이징 설정은 현재 프로젝트에만 적용됩니다.

<figure><img src="https://3323951709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0nDmWkcH3Ia4zEb82Qz%2Fuploads%2FmLUynnPlh9hN0FFXvRU9%2Fmanyfast-customizing-settings.png?alt=media&amp;token=86aa740d-e980-4e3f-865e-d30174166e9c" alt=""><figcaption></figcaption></figure>

## 2. 팀 규칙 입력하기

원하는 동작을 자연어로 구체적으로 작성합니다. 작성하지 않은 항목은 별도 규칙으로 적용되지 않습니다.

#### **설정할 수 있는 항목**

* **기획서 스타일:** 개조식·서술식, 문장 종결 방식 등 문서 전체의 문체를 정합니다.
* **기능 설명 양식:** 기능 설명의 순서와 반드시 포함할 내용을 정합니다.
* **우리 팀 용어:** 용어와 설명을 짝으로 등록하면 문서 작성 시 해당 표현을 사용합니다.
* **금지사항:** 임의 기능 추가처럼 매니가 하지 않았으면 하는 행동을 적습니다.
* **추가 정보:** 서비스 형태나 팀 배경처럼 매니가 계속 참고해야 할 맥락을 적습니다.

#### **항목별 입력 예시**

* **대화 말투:** “결론을 먼저 말하고 근거를 짧게 덧붙여 주세요. 이모지는 사용하지 마세요.” 대화 말투는 채팅 답변에만 적용되고 문서 문체에는 섞이지 않습니다.
* **기획서 스타일:** “문서는 개조식으로 작성하고 문장 끝은 ‘\~함’으로 통일해 주세요.” PRD와 기능명세서 등 문서 산출물의 문체를 정할 때 사용합니다.
* **기능 설명 양식:** “배경, 사용자 동작, 처리 규칙, 예외 상황, 완료 조건 순서로 작성해 주세요.” 기능 설명이나 연동 이슈의 구성을 반복해서 맞추고 싶을 때 유용합니다.
* **우리 팀 용어:** “예약자 = 예약을 신청하는 고객”, “운영자 = 매장 일정을 관리하는 사용자”처럼 용어와 설명을 함께 등록합니다.
* **금지사항:** “요청하지 않은 기능을 임의로 추가하지 마세요. 결제 정책은 확정된 내용만 작성하세요.”처럼 매니가 피해야 할 행동을 적습니다.
* **추가 정보:** 서비스 대상, 비즈니스 모델, 운영 방식, 팀이 이미 합의한 원칙처럼 여러 작업에서 반복해서 참고할 배경을 적습니다.

**입력 가능한 글자 수**는 대화 말투 200자, 기획서 스타일 300자, 기능 설명 양식 500자, 금지사항 300자, 추가 정보 3,000자입니다. 팀 용어는 최대 30개이며 용어는 30자, 설명은 100자까지 입력할 수 있습니다.

**공백만 입력한 항목은 저장되지 않습니다.** 팀 용어는 용어와 설명을 모두 입력한 항목만 저장됩니다. 여러 규칙이 충돌하지 않도록 한 항목에는 한 가지 목적을 구체적으로 적는 것이 좋습니다.

## 3. 적용 결과 미리보기

저장한 규칙이 문서에 어떻게 반영되는지 확인하려면 미리보기를 사용합니다. 실제 문서를 변경하지 않고 설정 적용 전후의 결과를 비교할 수 있습니다.

#### **미리보기 확인 순서**

* **규칙 저장:** 입력한 규칙을 저장한 뒤 매니 커스터마이징을 다시 열고 **미리보기 실행**을 선택합니다.
* **실행 조건:** 기획서 스타일, 기능 설명 양식, 우리 팀 용어 중 하나 이상을 저장해야 미리보기를 실행할 수 있습니다.
* **결과 비교:** 미리보기에서는 설정 미적용 결과와 이 프로젝트에 적용된 결과를 비교할 수 있습니다.
* **대화 말투 확인:** 대화 말투는 문서 미리보기가 아니라 채팅 답변에서 바로 확인합니다.
* **규칙 수정:** 수정이 필요하면 항목을 다시 편집하고 저장합니다. 저장된 규칙은 현재 프로젝트에서 이후에 실행되는 매니 작업에 적용됩니다.

## 4. 기존 문서에 설정 적용하기

저장한 규칙은 이후 매니의 채팅과 문서 생성 작업에 자동으로 적용됩니다. 이미 작성되어 있는 문서의 내용은 설정을 저장하는 것만으로 즉시 바뀌지 않습니다.

기존 문서까지 바꾸려면 매니 커스터마이징에서 **기존 문서에 적용**을 선택합니다. 기획서 스타일, 기능 설명 양식, 팀 용어처럼 문서 작성과 관련된 설정을 먼저 저장해야 실행할 수 있습니다.

#### **적용 전에 확인할 사항**

* **지원 플랜:** 기존 문서 적용은 Pro와 Team에서 제공됩니다.
* **크레딧 사용:** 기존 문서 적용은 AI 재작성 작업이므로 크레딧을 사용합니다. 실행 전에 예상 작업과 크레딧 사용을 확인하는 안내가 표시됩니다.
* **변경 제안 검토:** 재작성 결과가 문서를 바로 덮어쓰지는 않습니다. 각 항목에 변경 제안이 생성되며 승인하면 새 내용이 반영되고, 거절하면 원문을 유지합니다.
* **적용 범위:** 한 번에 적용할 수 있는 항목은 최대 100개입니다. 다른 AI 작업이 진행 중이거나 사용할 크레딧이 부족하면 적용할 수 없습니다.
* **반복 실행 주의:** 기존 문서에 적용을 실행할 때마다 새로운 AI 재작성 작업과 크레딧 사용이 발생할 수 있습니다. 같은 설정을 반복 실행하기보다 규칙이나 문서를 수정한 뒤 필요한 시점에만 실행하세요.
* **원문 언어 유지:** 미리보기와 기존 문서 적용은 원문의 언어를 유지합니다. 문서를 다른 언어로 바꾸고 싶다면 커스터마이징이 아니라 채팅에서 번역이나 언어 변경을 별도로 요청하세요.

## 5. 설정 변경 제안과 연동 활용

커스터마이징 규칙은 설정 화면에서 직접 입력하는 것뿐 아니라 채팅, 회의록, MCP 연결 과정에서 변경 제안으로 만들 수 있습니다. 모든 제안은 자동으로 반영되지 않으며 사용자가 검토하고 승인해야 저장됩니다.

#### **설정 변경 제안 및 연동 방식**

* **채팅에서 제안받기:** 채팅에서 “앞으로 계속 개조식으로 써줘”처럼 반복해서 사용할 규칙을 요청하면 매니가 커스터마이징 변경안을 제안할 수 있습니다.
* **사용자 승인 후 반영:** 매니가 설정을 직접 바꾸지는 않습니다. 제안에는 채팅, 외부 AI, 회의록과 같은 출처와 제안 이유, 현재 값과 변경될 값이 표시됩니다. 그룹 멤버가 승인해야 저장되며, 거절하면 현재 설정을 유지합니다.
* **회의록에서 제안받기:** 회의록에서 반복해서 지켜야 할 기획 원칙이나 새 팀 용어가 결정된 경우에도 설정 변경 제안이 만들어질 수 있습니다. 용어 제안은 기존 용어를 유지한 상태에서 새 항목을 추가하는 방식으로 검토합니다.
* **MCP에서 제안받기:** MCP로 연결한 외부 AI에서도 설정 변경안을 제안할 수 있습니다. 외부 AI가 보낸 제안 역시 자동으로 반영되지 않으며, 매니패스트에서 승인하거나 거절한 뒤 적용됩니다.
* **Linear·GitHub·Jira 연동:** 연동 이슈의 작성 형식을 맞추고 싶다면 기능 설명 양식이나 추가 정보에 제목과 설명의 구성, 필수 항목, 완료 조건을 적어 두세요. 매니가 이슈 생성안을 만들 때 해당 규칙을 참고합니다.
* **승인 전 저장:** 제안을 검토하는 동안 다른 입력칸에 작성 중인 내용이 있다면 먼저 저장한 뒤 승인하거나 거절하는 것이 안전합니다.

## 6. 권한과 프로젝트 복제

커스터마이징의 조회·편집 범위는 프로젝트가 속한 그룹과 사용자의 권한에 따라 달라집니다. 프로젝트를 복제할 때는 대상 그룹과 플랜에 따라 함께 복제되는 설정도 달라집니다.

#### **권한 및 복제 기준**

* **그룹 멤버:** 매니 커스터마이징은 프로젝트가 속한 그룹의 설정입니다. 그룹 멤버이면서 편집 권한이 있는 사용자는 설정을 작성하고 저장할 수 있습니다.
* **외부 사용자:** 프로젝트 링크로만 편집 권한을 받은 외부 사용자가 해당 그룹의 멤버가 아니라면 커스터마이징 설정을 열거나 변경할 수 없습니다. 일반 채팅과 허용된 문서 작업은 그대로 사용할 수 있습니다.
* **읽기 전용 권한:** 그룹 멤버가 읽기 전용 권한으로 프로젝트를 보고 있다면 왼쪽 위 프로젝트 메뉴에서 설정 내용을 확인할 수 있지만 입력, 저장, 기존 문서 적용은 할 수 없습니다.
* **같은 그룹으로 복제:** 같은 그룹 안에서 프로젝트를 복제하면 저장된 말투, 문체, 용어집과 다른 규칙도 복제본에 이어집니다. 아직 승인하지 않은 설정 변경 제안은 복제되지 않습니다.
* **다른 그룹으로 복제:** 다른 그룹으로 프로젝트를 복제하면 대상 그룹의 플랜에서 사용할 수 있는 설정만 이어집니다. Pro 프로젝트를 Starter 그룹으로 복제하는 경우 대화 말투만 유지되고 Pro 전용 항목은 복제되지 않습니다.

규칙을 바꾸면 이후 채팅, 문서 생성, 전체 생성, 회의록 반영과 연동 이슈 생성 등 현재 프로젝트에서 실행되는 매니 작업이 새 설정을 참고합니다.