# 📘 herdr_docs.md: Herdr 공식 문서 사이드맵 및 문서 구조 레퍼런스

이 문서는 AI 에이전트 인지형 멀티플렉서인 **herdr**의 공식 문서 구조 및 핵심 경로 링크들을 정리한 참고서입니다. 개발 과정 및 스킬 설계 시 참조용 사양으로 활용합니다.

---

## 🔗 Herdr 공식 문서 사이트 구조

공식 홈페이지 및 메인 설명: **[herdr.dev](https://herdr.dev)**

### 1. 🚀 시작하기 (Start here)
*   **Overview (개요)**: [herdr.dev/docs/](https://herdr.dev/docs/)
    *   Herdr의 도입 목적 및 핵심 철학
*   **Install (설치 방법)**: [herdr.dev/docs/install/](https://herdr.dev/docs/install/)
    *   시스템 요구사항 및 바이너리 설치 스크립트 제공
*   **Quick start (빠른 시작)**: [herdr.dev/docs/quick-start/](https://herdr.dev/docs/quick-start/)
    *   기본 워크스페이스 생성 및 에이전트 실행 예시
*   **Concepts (핵심 개념)**: [herdr.dev/docs/concepts/](https://herdr.dev/docs/concepts/)
    *   에이전트 인지식 터미널 구조, Pane, Tab, Workspace 관계
*   **Keyboard (키보드 단축키)**: [herdr.dev/docs/keyboard/](https://herdr.dev/docs/keyboard/)
    *   멀티플렉서 제어를 위한 주요 기본 단축키 목록

### 2. 🤖 Herdr 실무 활용 (Using Herdr)
*   **How to work with Herdr (작업 워크플로우)**: [herdr.dev/docs/how-to-work/](https://herdr.dev/docs/how-to-work/)
    *   개발자와 에이전트 간의 화면 분할 및 협업 모범 사례
*   **Agents (에이전트 제어)**: [herdr.dev/docs/agents/](https://herdr.dev/docs/agents/)
    *   Claude Code, Cline, Agy 등 주요 코딩 에이전트 실행 및 연동 규칙
*   **Session state and restore (세션 상태 및 복원)**: [herdr.dev/docs/session-state/](https://herdr.dev/docs/session-state/)
    *   호스트 리부팅 및 연결 유실 시 대화 상태 원자적 백업 및 복원
*   **Persistence and remote access (영속성 및 원격 접속)**: [herdr.dev/docs/persistence-remote/](https://herdr.dev/docs/persistence-remote/)
    *   백그라운드 영속 구동 및 원격 터미널에서의 Attach 방법

### 3. ⚙️ 설정 가이드 (Configure)
*   **Configuration (설정 기초)**: [herdr.dev/docs/configuration/](https://herdr.dev/docs/configuration/)
    *   사용자 프로필 설정 및 환경 변수 연동
*   **Config reference (설정 참조)**: [herdr.dev/docs/config-reference/](https://herdr.dev/docs/config-reference/)
    *   `config.toml` 구조 및 전역 키 맵 변경 스펙
*   **Plugins (플러그인)**: [herdr.dev/docs/plugins/](https://herdr.dev/docs/plugins/)
    *   Herdr 확장용 플러그인 사양 및 연동
*   **Marketplace (마켓플레이스)**: [herdr.dev/docs/marketplace/](https://herdr.dev/docs/marketplace/)
    *   커뮤니티 플러그인 공유 및 다운로드

### 4. 📚 레퍼런스 및 사양 (Reference)
*   **CLI reference (명령어 참조)**: [herdr.dev/docs/cli-reference/](https://herdr.dev/docs/cli-reference/)
    *   `herdr run`, `herdr capture`, `herdr kill` 등 CLI 인자 설명
*   **Socket API (소켓 API)**: [herdr.dev/docs/socket-api/](https://herdr.dev/docs/socket-api/)
    *   프로그래밍 방식으로 창 분할, 입력 전송, 상태 조회를 수행하기 위한 로컬 Unix 소켓 규격
*   **Integrations (외부 연동)**: [herdr.dev/docs/integrations/](https://herdr.dev/docs/integrations/)
    *   CI/CD 환경 및 외부 IDE 어댑터 연동 방안
*   **Agent skill file (에이전트 스킬 파일)**: [herdr.dev/docs/agent-skill/](https://herdr.dev/docs/agent-skill/)
    *   에이전트가 자체적으로 Herdr 환경을 진단할 때 읽는 규칙 정의
*   **Windows beta (윈도우 베타)**: [herdr.dev/docs/windows-beta/](https://herdr.dev/docs/windows-beta/)
    *   Windows 환경 구동 현황 및 제약 사항

### 5. 🚑 문제 해결 및 기타 (Help)
*   **Troubleshooting (문제 해결)**: [herdr.dev/docs/troubleshooting/](https://herdr.dev/docs/troubleshooting/)
    *   인증 실패, PTY 블로킹, 세션 크래시 자가 진단 및 대처법
*   **Preview docs (프리뷰 문서)**: [herdr.dev/docs/preview/](https://herdr.dev/docs/preview/)
    *   차기 업데이트 예정 기능 문서