워크스페이스와 프로젝트 구성
AiNecto의 자료는 워크스페이스 → 프로젝트 → 폴더 → 문서 구조로 관리됩니다. 워크스페이스는 여러 프로젝트를 묶는 가장 큰 운영 범위이고, 프로젝트는 사람과 Agent가 하나의 업무 문맥을 함께 사용하는 기본 단위입니다.
워크스페이스란 무엇인가
워크스페이스는 관련된 프로젝트를 한곳에서 관리하기 위한 상위 공간입니다. 회사, 조직, 팀 또는 서로 분리해 운영해야 하는 업무 영역을 기준으로 나눌 수 있습니다.
예를 들어 한 조직의 제품 개발과 마케팅 업무를 함께 운영한다면 하나의 워크스페이스 안에 다음과 같이 프로젝트를 둘 수 있습니다.
- 제품 출시
- 고객 조사
- 브랜드 개편
- 운영 자동화
워크스페이스 자체에 업무 원고를 쌓기보다, 실제 자료와 실행 기록은 목적이 분명한 프로젝트에 둡니다.
워크스페이스와 프로젝트의 차이
| 구분 | 워크스페이스 | 프로젝트 |
|---|---|---|
| 역할 | 여러 프로젝트를 묶는 상위 운영 공간 | 하나의 업무 목적과 문맥을 관리하는 공간 |
| 포함 대상 | 프로젝트 | 폴더, 문서, Kanban과 산출물 |
| 적합한 기준 | 조직, 팀, 고객군, 분리해야 할 운영 영역 | 제품 출시, 조사, 캠페인, 개발 과제 |
| Agent 작업 | 작업할 프로젝트의 범위를 찾는 기준 | 문맥을 읽고 결과를 저장하는 실제 단위 |
프로젝트를 단순한 문서 보관함으로 만들지 마세요. 목표, 기준, 결정, 진행 업무와 결과가 이어지는 하나의 업무 기억으로 운영합니다.
어떤 워크스페이스를 사용할지 정하기
먼저 접근 가능한 워크스페이스를 확인합니다.
접근 가능한 워크스페이스와 그 안의 프로젝트를 보여줘.
같은 이름의 프로젝트가 여러 워크스페이스에 있을 수 있습니다. Agent에게 프로젝트 이름만 말하기보다 워크스페이스와 프로젝트를 함께 지정하면 잘못된 위치에서 작업할 가능성을 줄일 수 있습니다.
[워크스페이스 이름]의 [프로젝트 이름]을 작업 대상으로 사용해줘.
Agent는 연결된 사용자가 접근할 수 있는 워크스페이스와 프로젝트만 볼 수 있습니다. 예상한 항목이 보이지 않으면 연결 계정과 접근 권한을 확인하세요.
워크스페이스 만들기
기존 워크스페이스가 업무 경계와 맞지 않을 때 새로 만듭니다.
[워크스페이스 이름] 워크스페이스를 만들어줘.
이름에는 조직이나 운영 범위를, 설명에는 어떤 프로젝트를 묶을 공간인지 적습니다. 생성 후에는 이름과 설명을 확인하고 그 안에 필요한 프로젝트를 만듭니다.
워크스페이스를 너무 잘게 나누면 검색과 협업 범위가 흩어집니다. 반대로 관계없는 고객, 조직이나 보안 경계까지 한곳에 넣으면 관리가 어려워집니다.
워크스페이스에 사람 추가하기
워크스페이스를 함께 사용할 사람은 AiNecto 웹의 워크스페이스 공유 또는 구성원 관리 화면에서 추가합니다.
- 대상 워크스페이스를 엽니다.
- 공유 또는 구성원 관리 화면으로 이동합니다.
- 추가할 사람이나 이메일을 지정합니다.
- 필요한 역할을 선택합니다.
- 적용 범위와 대상이 맞는지 확인한 뒤 초대하거나 추가합니다.
워크스페이스에 사람을 추가하면 그 사람은 워크스페이스 범위의 협업에 참여하게 됩니다. 역할에 따라 프로젝트와 자료를 보거나 편집하고 공유할 수 있는 범위가 달라집니다.
- Owner: 소유와 전체 관리
- Admin: 구성원과 공유 범위 관리
- Editor: 자료 작성과 편집
- Viewer: 열람과 댓글 참여
초대하거나 추가한 뒤에는 대상, 역할과 실제 접근 범위를 다시 확인하세요. 조직 전체가 함께 사용할 공간인지, 특정 프로젝트만 함께할 사람인지 먼저 판단해야 합니다. 한 프로젝트에만 참여할 사람을 필요 이상으로 워크스페이스 전체에 추가하지 않습니다.
워크스페이스 구성원의 초대·추가·역할 변경·제거는 AiNecto 웹에서 하며 Team 플랜이 필요합니다. 팀 밖 사람은 초대 메일을 받아 보기 권한(Viewer)으로 참여합니다. Agent는 연결된 사용자에게 이미 부여된 권한 안에서만 작업합니다.
프로젝트 만들기
실제 진행 중인 작은 업무로 시작합니다.
[업무 이름] 프로젝트를 만들어줘.
프로젝트는 선택한 워크스페이스에 속합니다. 여러 워크스페이스가 있다면 생성 위치를 함께 지정합니다.
[워크스페이스 이름]에 [업무 이름] 프로젝트를 만들어줘.
프로젝트 이름은 업무 목적을 알아볼 수 있게 정하고, 설명에는 무엇을 해결하는 프로젝트인지 남깁니다. 생성 후 워크스페이스, 프로젝트 이름과 설명을 확인합니다.
프로젝트에 사람 추가하기
워크스페이스 전체가 아니라 특정 프로젝트만 함께할 사람은 AiNecto 웹의 프로젝트 공유 화면에서 추가합니다.
- 대상 워크스페이스와 프로젝트를 확인합니다.
- 프로젝트 공유 화면을 엽니다.
- 추가할 사람이나 이메일을 지정합니다.
- 프로젝트에서 필요한 역할을 선택합니다.
- 함께 노출되는 폴더와 문서 범위를 확인한 뒤 추가합니다.
프로젝트에 추가된 사람은 부여된 권한에 따라 프로젝트의 폴더, 문서와 Kanban에 참여합니다. 더 좁은 폴더나 문서에 별도 권한이 있다면 실제 적용 범위를 함께 확인하세요.
워크스페이스 구성원이라고 해서 모든 프로젝트에 같은 역할이 필요한 것은 아닙니다. 반대로 프로젝트 하나만 함께할 사람을 워크스페이스 전체 협업자로 추가하면 불필요한 범위까지 열릴 수 있습니다.
프로젝트 구성원의 역할 변경·제거는 AiNecto 웹에서 합니다. 사람 추가는 웹에서 하거나, 연결한 Agent에게 역할을 정해 초대해 달라고 요청할 수 있습니다. 둘 다 Team 플랜과 그 프로젝트의 소유자·관리자 권한이 필요합니다 — 사용 중인 Agent 연결하기를 참고하세요.
사람을 추가한 뒤 확인하기
- 올바른 워크스페이스 또는 프로젝트에 추가했는가
- 필요한 최소 역할을 부여했는가
- 상위 범위에서 예상보다 넓은 권한을 받지 않는가
- 폴더나 문서의 더 가까운 공유 설정이 있는가
- 더 이상 참여하지 않는 사람의 접근을 정리했는가
- Agent가 사용하는 계정에도 의도한 권한만 있는가
전체 구조 이해하기
- 워크스페이스: 여러 프로젝트를 묶는 상위 운영 공간
- 프로젝트: 하나의 업무 목적과 관련 문맥을 모으는 기본 단위
- 폴더: 프로젝트 안에서 기준, 진행 작업, 검토 결과와 산출물을 구분하는 단위
- 문서: Markdown, Kanban, HTML, Diagram, OpenAPI, File과 ERD
- 첨부: 특정 문서에 연결해 함께 관리하는 파일
한 문서를 찾을 때도 어느 워크스페이스의 어느 프로젝트에 속하는지까지 확인하면 동명의 문서와 오래된 자료를 구분하기 쉽습니다.
현재 구조 확인하기
[워크스페이스 이름]의 프로젝트 목록을 보여줘.
[프로젝트 이름]의 폴더와 문서 구조를 보여줘.
예상한 문서가 보이지 않으면 다음 순서로 확인합니다.
- 올바른 계정으로 연결했는가
- 올바른 워크스페이스를 선택했는가
- 같은 이름의 다른 프로젝트를 열지 않았는가
- 프로젝트나 문서에 접근할 수 있는가
- 문서가 이동·보관되거나 이름이 바뀌지 않았는가
프로젝트 안에 폴더 구성하기
처음부터 많은 폴더를 만들 필요는 없습니다. 첫 기준 문서를 만든 뒤 실제 결과가 생길 때 필요한 구조를 추가합니다.
예시:
- 00 기준과 결정
- 10 진행 작업
- 20 검토 결과
- 30 전문 산출물
- 90 참고 자료
00 기준과 결정 폴더를 만들고, 프로젝트 기준 문서를 그 안으로 옮겨줘.
같은 문서를 복사하거나 다시 만들지 않고 기존 문서를 이동합니다. 대상이 확실하지 않으면 먼저 후보를 확인합니다.
프로젝트를 다른 워크스페이스로 옮기기
프로젝트의 운영 주체나 경계가 바뀌면 다른 워크스페이스로 이동할 수 있습니다. 이동 전에는 대상 워크스페이스의 쓰기 권한과 구성원 접근 범위를 확인합니다.
[프로젝트 이름]을 [대상 워크스페이스]로 옮겨줘.
이동 후에는 프로젝트를 볼 수 있는 사람, 공유 범위, 연결 문서와 진행 중인 Kanban 업무를 다시 확인합니다. 워크스페이스 이동은 단순한 정렬 변경이 아니라 협업 경계를 바꿀 수 있는 작업입니다.
이름과 위치 바꾸기
워크스페이스, 프로젝트, 폴더와 문서는 업무가 바뀌면 이름을 조정할 수 있습니다. 문서는 프로젝트 안에서 다른 폴더로 이동할 수 있습니다.
변경 전후에 다음을 확인하세요.
- 이름이 운영 범위를 정확히 설명하는가
- 동명의 워크스페이스나 프로젝트와 혼동되지 않는가
- 기준 문서의 새 위치를 다시 찾을 수 있는가
- 다른 문서에서 가리키는 이름이 오래되지 않았는가
- 다음 사람과 Agent가 새 구조를 이해할 수 있는가
변경된 워크스페이스, 프로젝트와 문서 구조를 보여줘.
문서와 산출물 배치하기
- Markdown: 목표, 결정, 열린 질문과 다음 작업
- Kanban: 실행 업무, 담당자와 검토 흐름
- HTML: 화면과 프로토타입
- Diagram: 흐름, 관계와 구조
- OpenAPI: API 계약
- File: 원본 자료와 결과 파일
- ERD: 데이터 구조
전문 산출물을 별도로 만들더라도 핵심 결정과 현재 상태는 Markdown 기준 문서에 다시 연결합니다.
File과 첨부 구분하기
File 문서는 프로젝트 트리에 독립된 자료로 관리합니다. 첨부는 특정 문서나 협업 맥락과 함께 보는 자료입니다.
파일을 올리는 것만으로 프로젝트 기준이 생기지는 않습니다. 중요한 내용은 Markdown에 요약하고 원본 파일을 근거로 연결하세요.
민감한 파일은 필요한 사람만 접근하는지, 상위 범위의 접근 설정이 의도와 맞는지, 공개 링크로 노출되지 않는지 확인합니다.
여러 문서 함께 보기
앱의 탭을 이용하면 기준 문서, 자료와 산출물을 함께 열어 비교할 수 있습니다. 여러 탭이 열려 있을 때는 현재 활성 문서와 저장 대상을 확인하세요.
Agent는 화면에 열린 탭을 자동으로 작업 대상으로 가정하지 않습니다.
[워크스페이스 이름]의 [프로젝트 이름]에 있는 [문서 이름]을 읽어줘.
운영 경계를 나누는 기준
새 워크스페이스가 필요한 경우:
- 조직이나 소유 주체가 다릅니다.
- 프로젝트 목록과 운영 범위를 분리해야 합니다.
- 같은 이름의 프로젝트라도 독립적으로 관리해야 합니다.
같은 워크스페이스 안에 새 프로젝트가 필요한 경우:
- 참여하는 업무 목적이나 완료 기준이 다릅니다.
- 기준 문서와 산출물의 수명주기가 다릅니다.
- Kanban과 검토 흐름을 독립적으로 운영해야 합니다.
기존 프로젝트 안에 폴더만 추가하면 되는 경우:
- 목표와 책임 범위는 같고 자료의 성격만 다릅니다.
- 같은 기준 문서와 결정에 따라 움직입니다.
- 검색과 협업 맥락을 분리할 필요가 없습니다.
다음으로 검색·버전·복원에서 워크스페이스와 프로젝트 범위를 좁혀 필요한 문서를 찾는 방법을 확인하세요.