가이드로 이동

Mind와 검토

Mind와 검토는 onemind가 팀 AI 지침을 버전 관리하고 동료 검토를 거치는 곳입니다. Mind에서 최근 Mind를 보거나 Project를 선택합니다. 변경을 제안하기 전에 활성 내용, 버전, 관련 Project, 파일, 기록을 확인합니다.

  1. Team 관리자는 Mind 추가를 선택하고 필요에 따라 Project를 고른 뒤 이름과 내용을 입력합니다. 파일 이름은 [이름].md가 됩니다. 만들기를 클릭해 Mind를 생성합니다. 생성은 서버에서 확인되며 관리 작업입니다.
  2. 기존 Mind는 업데이트를 선택합니다. 그러면 풀 리퀘스트 페이지가 바로 열립니다. 필수 제목과 선택적 세부 정보를 입력하고, 사이드 패널 편집기에서 파일 목록을 검토합니다. 취소를 선택하면 삭제하고, 저장을 선택하면 초안으로 보관하거나, 보내기를 선택하면 검토에 제출합니다.
  3. 제출만으로 승인된 Mind가 변경되지는 않습니다.
  4. 현재 관리자는 알림에서 정확한 변경과 검사 결과를 검토합니다. 승인하고 게시를 클릭하면 다음 불변 버전을 게시하며, 거절은 활성 버전을 유지합니다. 권한이 있는 관리자는 자신의 제안도 검토할 수 있습니다.
  5. 기록을 확인한 후 승인된 버전을 동기화합니다.

Mind 업데이트에서 지원되는 파일 형식은 Markdown, JSON, YAML, TOML, 일반 텍스트(UTF-8만)입니다. 새 Mind 내용은 최대 8,000자이고, 업데이트에 첨부하는 파일은 각 512 KiB로 제한됩니다. 초안에 파일을 업로드해도 승인이나 적용이 이루어지지는 않습니다.

기준 버전이 바뀌거나 검사가 실패하면 초안을 보존하고 현재 Mind를 읽어 충돌을 해결한 뒤 다시 제출합니다. Mind 삭제는 검토 요청이며 승인 전까지 계속 표시됩니다. 저장된 초안이나 대기 중 요청은 게시된 변경이 아닙니다. 팀 작업 진행 상황과 AI 도구 인터랙션은 Matrix 작업에서 추적됩니다.

Mind 보기 및 정렬

사이드 탐색의 Mind 섹션은 모든 Mind로 들어가는 시작점입니다. 최근 Mind가 목록 상단에 표시됩니다. Mind {count}개 모두 보기를 선택하면 팀의 모든 Mind를 볼 수 있고, 간단히 보기를 선택하면 목록을 접습니다. 프로젝트 아래에서 Project를 선택하면 그 안의 Mind를 볼 수 있고, Mind 이름을 클릭하면 상세 보기가 열립니다.

로그인한 팀 구성원은 사이드바에서 Project와 Mind의 순서를 개인적으로 설정할 수 있습니다. 행을 원하는 위치로 드래그하거나, 행에 포커스를 두고 위아래 화살표 키를 눌러 이동할 수 있습니다. 순서는 사용자별로 저장되며 다른 팀 구성원의 보기에 영향을 주지 않습니다. 순서가 저장되면 확인 메시지가 표시됩니다. 순서를 불러오지 못하면 서버의 기본 순서가 표시됩니다.

Mind 상세 보기에서 이전 Mind 및 다음 Mind 화살표를 사용해 목록으로 돌아가지 않고 Mind 사이를 이동할 수 있습니다.

상세 보기의 정보 패널에는 Mind의 현재 버전, 상태(활성 또는 제안 대기 중), 마지막 업데이트 날짜, 작성자 및 마지막 수정자, 관련 Project, 첨부 파일이 표시됩니다. 파일 미리 보기는 텍스트 전용(UTF-8)이며, 바이너리 파일이나 너무 큰 파일은 대체 메시지가 표시됩니다. 섹션 토글을 사용해 정보 패널을 펼치거나 접을 수 있습니다. 생성 시 설정된 Mind 목적 필드도 여기에 표시됩니다.

Team 요금제 변경이 진행 중인 경우 모든 Mind가 일시적으로 읽기 전용 상태가 됩니다. 정보 패널에 알림이 표시되며, 요금제 변경이 완료될 때까지 업데이트 및 보내기를 사용할 수 없습니다.

초안과 풀 리퀘스트

기존 Mind에서 업데이트를 선택하면 풀 리퀘스트 페이지가 바로 열립니다. 페이지에는 기본 Mind 파일과 첨부 파일 목록, 기본 버전이 표시되며, 필수 제목과 선택적 세부 정보를 입력할 수 있습니다. 사이드 패널 편집기에서 AI 하네스 파일(스킬, 훅, 프롬프트, 규칙 — JSON, YAML, TOML, Markdown 또는 일반 텍스트, 각 512 KiB)을 추가하거나 제거할 수 있습니다. 초안은 자동 저장되지 않습니다. 저장을 명시적으로 선택해 제출 없이 이 기기에 보관하세요.

초안이 진행 중인 상태에서 다른 곳으로 이동하면 이 Mind 제안에서 나갈까요? 대화 상자가 표시됩니다. 저장하고 나가기를 선택하면 초안이 이 기기에 보존되고, 계속 작업을 선택하면 편집기로 돌아갑니다. 같은 Mind로 돌아오면 저장한 제안 초안을 불러올까요? 대화 상자가 나타나 저장된 초안의 텍스트와 파일을 복원할 수 있습니다. 제안 불러오기를 선택하면 작업을 이어서 계속할 수 있고, 무시하면 새로 시작합니다.

보내기 전에 Markdown 파일 이름을 바꿀 수 있으며 파일 이름은 .md 또는 .markdown 확장자를 유지해야 합니다. 보내기를 선택하면 제안이 Safe Check와 검토에 제출됩니다.

Mind가 읽기 전용이거나 일시적으로 사용할 수 없거나 세션이 만료된 경우 보내기가 차단됩니다. 각 상태에 맞는 메시지가 페이지에 표시됩니다.

Mind 제목 변경

Mind의 표시 제목을 변경하는 것은 내용 변경과 별도의 승인 흐름입니다. 로그인한 팀 구성원은 누구나 제목 변경을 제안할 수 있습니다. Mind 상세 보기에서 제목을 클릭하고, 새 제목(1~160자, 제어 문자 없음)을 입력한 다음 승인 요청을 선택합니다. 고정된 제안 제목 Mind 제목 업데이트로 풀 리퀘스트가 자동으로 생성됩니다.

관리자가 제안을 승인할 때까지 현재 제목은 변경되지 않습니다. 제목을 편집하는 동안 Mind가 변경되면 편집기를 닫고 다시 열어 현재 버전을 사용하라는 메시지가 표시됩니다. Mind가 읽기 전용 상태인 경우에는 제목 변경을 보낼 수 없습니다.

Safe Check와 Conflict Check

풀 리퀘스트를 제출하면 서버가 자동으로 Safe Check를 실행합니다. Safe Check는 제안이 사람 검토자에게 도달하기 전에 발견 사항을 생성하는 AI 기반 검토입니다. Safe Check는 모든 제출마다 실행되며 사용자가 별도로 트리거할 필요가 없습니다.

충돌 검사는 Safe Check의 구조적 구성 요소입니다. 제안된 Mind를 다른 모든 활성 Mind와 비교하여 세 가지 심각도 그룹으로 발견 사항을 보고합니다.

  • 차단 — 승인을 막는 결정적 충돌입니다. 검토를 진행하기 전에 제안을 편집하거나 거부해야 합니다.
  • 검토 — 승인 전에 사람의 명시적 확인이 필요한 권고 사항입니다.
  • 중복 — 인식을 위한 낮은 심각도의 발견 사항입니다.

각 발견 사항에는 신뢰 수준이 있습니다: 결정적(확정적), 휴리스틱, 시맨틱. 11가지 발견 유형은 중복 ID, 오래된 버전 참조, 권한 또는 범위 위반, 잘못된 할당, 중복 할당, 보호된 주장 충돌, 누락된 버전 참조, 의존성 순환, 리소스 소유권 충돌, 모순된 지침, 중복 지침입니다. 각 발견 사항은 검토자 참고용으로 안정적 지문, 정확한 소스 버전, 영향받는 구성 컨텍스트를 표시합니다.

권고(검토 수준) 발견 사항이 있는 경우, 검토자는 승인하고 게시 작업이 활성화되기 전에 검토 확인 체크박스에 체크해야 합니다. 이를 통해 모든 권고 사항을 검토했으며 자동 해결이나 Mind 권한 변경이 없음을 확인합니다.

제출 전 Conflict Check를 로컬에서 실행하려면 Mind Check CLI 명령을 사용하세요. onemind mind-check member를 --harness 플래그와 함께 실행해 하네스 파일을 검사하거나(각 최대 256 KiB), onemind mind-check manager를 --subject 플래그와 함께 실행해 대상 Mind 또는 패키지 파일을 검사하세요. Mind Check는 현재 릴리스에서 경고만 제공하며 자체적으로 동기화를 차단하지 않습니다. --json을 사용하면 출력을 프로그래밍 방식으로 파싱할 수 있습니다. 전체 플래그 목록은 CLI 명령 참조를 참조하세요.

알림에서 검토

관리자는 알림에서 들어온 풀 리퀘스트를 검토합니다. 각 요청에는 정확한 제안 변경 내용, Safe Check 발견 사항, Conflict Check 발견 사항이 표시됩니다. 승인하거나 거부하려면 다음 단계를 따르세요.

  1. 사이드 탐색에서 알림을 엽니다.
  2. 들어온 Mind 검토 요청을 선택합니다.
  3. 제안된 변경 내용과 Conflict Check 발견 사항을 확인합니다.
  4. 권고(검토 수준) 발견 사항이 있으면 검토 확인 체크박스에 체크해 확인합니다.
  5. 승인하고 게시를 선택하면 다음 불변 버전이 게시되고, 거부를 선택하면 활성 버전이 유지됩니다.

팀에서 권한을 부여한 경우 관리자는 자신의 제안을 직접 검토하고 승인할 수 있습니다. Conflict Check의 차단 수준 발견 사항이 있으면 승인하고 게시 작업을 사용할 수 없습니다. 이 경우 제안을 편집하거나 PR을 거부한 후 새 버전을 제출해야 합니다.

제안을 검사한 뒤 승인된 Mind가 변경되면 승인하고 게시로 더 이상 그 제안을 게시할 수 없습니다. 검토 화면에 제안이 오래되었다고 표시되며, 제안 작성자나 관리자는 현재 버전에서 다시 제안을 선택할 수 있습니다. onemind는 같은 제목, 세부 정보, 파일, 작성자로 현재 버전에서 새 제안을 만들고 Safe Check를 다시 실행한 뒤, 이전 제안을 새 제안 링크와 함께 대체됨으로 표시합니다. 제안의 수정이 현재 버전의 변경과 겹치면 아무것도 대체하지 않고 현재 버전과 제안의 비교를 검토 화면에 표시하므로, 작성자가 수정된 제안을 제출할 수 있습니다. 현재 버전에 이미 변경 사항이 포함되어 있으면 이전 제안을 거부해 닫으세요.

알림은 삭제 검토 요청도 처리합니다. 삭제 요청에 대한 결정은 내용 변경 요청과 별개입니다. 아래 Mind 삭제 및 복구를 참조하세요.

Mind 이동 또는 복제

로그인한 팀 구성원은 사이드바에서 Mind 행을 대상 Project로 드래그하여 Mind를 다른 Project로 이동하거나 복제할 수 있습니다.

  1. 사이드바에서 Mind 행을 대상 Project로 드래그합니다.
  2. 복제를 선택하면 소스 Project에 Mind가 유지되고, 이동을 선택하면 소스 Project에서 제거됩니다.
  3. 요청이 전송되기 전에 Mind Checker가 자동으로 실행되며, 완료 메모에 검사된 버전과 해시가 표시됩니다.
  4. Mind Checker를 완료할 수 없는 경우 승인 요청이 생성되지 않습니다.
  5. 요청은 알림의 관리자 승인 대기열에 들어갑니다.
  6. 관리자가 변경을 승인하거나 거부하며, Mind는 승인 후에만 대상 Project에 표시됩니다.

로그인한 구성원은 누구나 이동 또는 복제 요청을 시작할 수 있지만 승인은 관리자만 할 수 있습니다. Mind 이동은 자동으로 되돌려지지 않습니다. 되돌리려면 두 번째 이동 요청이 필요합니다.

Mind 삭제 및 복구

Mind를 삭제하면 팀 관리자에게 검토 요청이 전송됩니다. 관리자가 삭제를 승인할 때까지 Mind는 계속 표시됩니다. 삭제를 요청하려면 Mind 작업 메뉴에서 삭제를 선택하고 대화 상자를 확인하세요.

관리자는 알림에서 삭제 요청을 검토하고 삭제 승인 또는 삭제 거부를 선택합니다. 승인하면 Mind가 숨겨지지만 영구 삭제되지는 않습니다. 관리 기록은 복구를 위해 유지됩니다.

삭제가 승인된 후 알림에 복구 옵션이 표시됩니다. Mind를 복원하려면 Mind 복구를 선택하세요. Mind의 Project도 삭제된 경우 Mind를 복구하기 전에 먼저 Project를 복구해야 합니다. 프로젝트 복구를 선택하면 Project와 해당 Mind가 관리 기록을 변경하지 않고 Mind 패널에 다시 표시됩니다. 복구가 실패하면 구체적인 오류 메시지가 표시됩니다. 현재 삭제 상태를 확인한 후 다시 시도하세요.