> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 코딩 에이전트로 빌드하기

코딩 에이전트에게 태스크 맡기기: 에이전트가 읽는 파일, 포함된 스킬, 통제를 유지하는 검토.

## 초보자 연습

전제 조건: 아래 두 개의 초보자 가이드를 읽고 Desktop 로컬 설정을 완료하십시오. 코딩 에이전트는 AI 도구 — Cursor, Claude Code, Devin 또는 유사한 어시스턴트 — 로 프로젝트를 읽고 파일을 편집하고 명령을 실행합니다. 이 페이지의 모든 내용은 사용하는 어떤 도구에도 적용됩니다.

빠른 용어: 프롬프트는 에이전트에 붙여넣는 지시 텍스트입니다. diff는 에이전트가 제안하는 파일 변경 목록입니다. 저장소 루트는 package.json이 들어 있는 최상위 폴더입니다 — 에이전트는 항상 거기서 시작해야 합니다.

1. 리포지토리 루트의 `.agents/skills/`를 열고 태스크에 가장 가까운 스킬을 복사합니다 — `add-a-desktop-capability`가 좋은 첫 시도입니다.

2. 그것을 에이전트에 붙여넣고 변경 사항을 설명한 다음 한 줄을 추가합니다: 코드를 건드리기 전에 `llms.txt`, 다음 `AGENTS.md`, 다음 `.ai/PROJECT_CONTEXT.md`를 읽으십시오.

3. 에이전트가 편집하기 전에 변경할 파일과 실행할 검사를 나열하게 하세요. 끝나면 diff를 리뷰하세요 — 제품에 대한 실제 변경을 승인하는 것입니다.

4. 게시, 설치 프로그램 릴리스, 유료 공급자 호출은 태스크 프롬프트의 일부가 절대 아닙니다. 명시적으로 승인하는 별도의 단계로 유지하십시오.

[시작하기 전에](https://supastack.dev/ko/docs/desktop/before-you-start.md)

[단말기 기본사항](https://supastack.dev/ko/docs/desktop/terminal-basics.md)

[데스크탑 로컬 설정](https://supastack.dev/ko/docs/desktop/ship-in-5-minutes.md)


## 에이전트가 읽는 파일

저장소에는 사람뿐 아니라 에이전트를 위해 쓰인 작은 파일 묶음이 들어 있습니다. 이 컨텍스트를 직접 붙여넣을 필요는 없습니다 — 에이전트를 `llms.txt`로 향하게 하면 나머지는 스스로 읽습니다.

읽는 순서가 중요합니다: `llms.txt`는 지도이고, `AGENTS.md`는 경계를 정하며, `.ai/PROJECT_CONTEXT.md`는 이전 세션에서 배운 내용을 담고 있습니다. 경계를 건너뛰는 에이전트는 출시할 수 없는 코드를 만듭니다.

| 파일 | 에이전트에게 주는 것 |
|---|---|
| `llms.txt` | 이 체크아웃이 실제로 제공하는 것만 나열하도록 생성된 리포지토리 진입 맵 |
| `AGENTS.md` | 비협상적 경계: 더 승인할 때까지 로컬 작업만, 셸은 제품 UI를 절대 포크하지 않음 |
| `.ai/PROJECT_CONTEXT.md` | 세션을 가로지르는 메모리 — 최근에 무엇이 왜 바뀌었는지. 코드 변경 전에 읽음 |
| `.ai/` 미러 문서 | 중요한 파일 옆에 있는 대응하는 .ai/<path>.md 노트. 파일별 결정과 미해결 스레드를 기록 |
| `.agents/skills/` | 에이전트를 위해 작성된 태스크 런북 — 아래에 나열된 5개의 Desktop 스킬 |
| `docs/agent-security.md` | 승인 체크리스트 — 인증, 워크스페이스 및 권한 검사, 마스킹된 로그 |
| `docs/desktop-updates.md` | 업데이트 채널 런북 — 서명 키, 엔드포인트, 릴리스 채널 |
| `.env.example` | 환경 설정의 완전한 목록 — 에이전트는 이 파일에 없는 변수명을 절대 만들지 않음 |


## 포함된 스킬

`.agents/skills/` 아래의 각 파일은 완전한 브리프입니다: 붙여넣거나 에이전트가 읽게 하면 키트의 규칙이 함께 전달됩니다 — 제품 UI는 웹 앱에 남고, OS 동작만 Rust에 들어갑니다.

붙여넣기 가능한 `prompts/` 라이브러리는 Web 리포지토리에만 제공되고 이 체크아웃에는 대신 스킬이 있습니다. 무인 설정에는 agent-setup 가이드의 준비된 프롬프트를 사용하십시오.

[에이전트가 설정을 실행하게 하기](https://supastack.dev/ko/docs/desktop/agent-setup.md)

- `add-a-desktop-capability` — 창, 트레이, 단축키, 업데이트 또는 빌드 변경
- `adding-a-dependency` — npm 종속성을 안전하게 추가, 업그레이드 또는 이동
- `reviewing-a-pr` — 정확성, 워크스페이스 격리, 비밀에 대한 diff 검토
- `upgrading-from-upstream` — 더 새로운 키트 릴리스를 셀로 가져오기
- `verify-changes` — 인계 전에 올바른 검사를 선택하고 실행


## 에이전트가 세션 사이에서 기억하는 방법

에이전트는 세션 간에 메모리가 없습니다 — `.ai/` 폴더가 메모리입니다. `.ai/PROJECT_CONTEXT.md`는 최근 변경 사항과 이유를 기록합니다. 그 옆의 `.ai/apps/desktop/src-tauri/src/lib.md`와 같은 미러 문서는 코드만으로는 보이지 않는 `apps/desktop/src-tauri/src/lib.rs` 뒤의 결정을 설명합니다.

계약은 단순합니다: 파일을 편집하기 전에 그 미러를 읽고, 변경이 반영되면 미러를 업데이트합니다. Open Threads 항목은 끝나지 않은 작업을 기록해 다음 세션이 처음부터가 아니라 이어서 할 수 있게 합니다. 오래된 미러는 없는 것보다 나쁩니다 — 에이전트의 diff를 리뷰할 때 변경된 파일들의 미러가 코드와 함께 움직였는지 확인하세요.


## 에이전트의 작업을 정직하게 리뷰하기

완료된 작업은 요약이 아니라 증거입니다. 에이전트의 작업을 채택하기 전에 `docs/agent-security.md`가 배포를 검사하는 것과 같은 방식으로 확인하세요:

무언가 잘못되면 diff를 돌려보내세요 — 실패한 검사를 지명하면 에이전트가 자기 작업을 가장 빨리 고칩니다. 혼자 시도해서는 안 되었던 일에 대해서는 한 번 명시적으로 말하세요. 그 경계는 나머지 세션 동안 유지됩니다.

[검증 게이트와 테스트 스위트](https://supastack.dev/ko/docs/desktop/testing.md)

- cargo test, cargo check 또는 릴리스 프리플라이트 등 주장하는 검사를 실행했는지 — 결론이 아니라 명령과 그 출력을 요구하십시오.
- 비밀은 서버에만 남았습니다 — 서명 키나 인증서가 보고서나 커밋에 인쇄되지 않았고 셸은 여전히 공급자 자격 증명을 가지고 있지 않습니다.
- 제품 동작은 웹 앱에 남았습니다 — diff는 Rust에서 병렬 UI, 인증 또는 채팅 로직을 추가하지 않습니다.
- 변경된 각 파일의 `.ai/` 미러가 코드와 함께 움직였는지.
- 게시, 설치 프로그램 릴리스, 유료 공급자 호출은 승인한 별도의 단계로 남았습니다 — 에이전트는 스스로 병합, 푸시 또는 릴리스하지 않습니다.
- 한 단계가 두 번 실패하면 임기응변으로 우회하지 않고 멈춰 실패한 명령을 보고했는지.


설정을 계속하려면 [데스크톱 릴리스 계정 만들기](https://supastack.dev/ko/docs/desktop/external-accounts.md) 가이드를 읽어보세요.


## 다음

[데스크톱 릴리스 계정 만들기](https://supastack.dev/ko/docs/desktop/external-accounts.md)