# 프로젝트

> 하나의 업무를 중심으로 대화를 묶고, 에이전트가 실행마다 읽는 상시 맥락을 줍니다.

**프로젝트**는 같은 업무에 속하는 [대화](/ko/docs/work/conversations/)를 묶고, 그 안의 모든 대화가 읽을 수 있는 맥락을 함께 담습니다.

## 언제 쓰는가

실마다 같은 배경을 다시 설명하고 있다는 것을 깨달았을 때 씁니다. 그 고객, 그 코드베이스, 그 출시, 그 분기 같은 것들이죠. 프로젝트가 그 배경을 한 번만 갖습니다.

| 두는 곳 | 언제 |
| --- | --- |
| [시스템 프롬프트](/ko/docs/build/system-prompt/) | 에이전트가 하는 모든 일에 참인 것 |
| 프로젝트 | 이 업무에 참인 것 |
| [메모리](/ko/docs/capabilities/memory/) | 모든 업무를 통틀어 나에 대해 참인 것 |
| 메시지 | 이번 작업 하나에만 참인 것 |

## 프로젝트가 에이전트에게 주는 것

프로젝트 안의 대화는 그 프로젝트의 맥락을 쓸 수 있는 상태로 시작합니다. 에이전트는 프로젝트의 현재 상태를 읽고 일이 진행되는 대로 갱신할 수도 있습니다. 사용자가 옮겨 적지 않아도 에이전트가 유지하는 현황이 최신으로 남는 것이죠.

그래서 프로젝트는 공유 작업 기록으로도 쓸모가 있습니다. 이 일이 무엇이고, 어디까지 왔고, 무엇이 정해졌는지 말입니다.

## 프로젝트 안에서 일하기

프로젝트를 열고 거기서 대화를 시작하면 그 대화는 프로젝트에 속합니다. 프로젝트 페이지가 자기 대화 목록을 보여주므로, 하던 일로 돌아가려고 전체 최근 목록을 뒤질 필요가 없습니다.

<Aside type="note" title="프로젝트는 권한 경계가 아닙니다">
  대화를 프로젝트에 넣는 것은 에이전트가 *읽는* 것을 바꾸지 *닿을 수 있는* 것을 바꾸지 않습니다.
  접근 권한은 여전히 에이전트에 바인딩된 [연결과 스킬](/ko/docs/connect/overview/)에서 옵니다.
</Aside>

## 한계

- 대화는 프로젝트 하나에 속합니다.
- 프로젝트 맥락은 그 프로젝트 안의 대화에서 쓸 수 있습니다. 에이전트의 다른 실과 공유되지 않습니다.
- 프로젝트는 일을 묶습니다. 접근 권한을 주지도 않고, 문서를 보관하는 곳도 아닙니다. 산출물은 [아티팩트](/ko/docs/capabilities/artifacts/)에 둡니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="대화"
    href="/ko/docs/work/conversations/"
    description="프로젝트가 묶는 실들."
  />
  <LinkCard
    title="아티팩트"
    href="/ko/docs/capabilities/artifacts/"
    description="프로젝트 작업의 산출물이 쌓이는 곳."
  />
  <LinkCard
    title="메모리"
    href="/ko/docs/capabilities/memory/"
    description="업무가 아니라 사용자를 따라다니는 맥락."
  />
</CardGrid>
