ai-tuilisted
Install: claude install-skill TeiNam/my_harness_for_claude_code
# AI TUI — 터미널 AI 에이전트 초기화면·두뇌 세팅 레퍼런스
Claude Code · stocker 같은 **터미널 AI 에이전트**를 새로 만들 때, (1) 초기 접속화면(intro screen)과 (2) 에이전트 두뇌(프롬프트·스킬·MCP·사용룰)를 언어별로 세팅하는 틀을 제공한다.
> 기준 구현: `stocker` (bun + `@mariozechner/pi-tui`) — `src/components/intro.ts`, `src/cli.ts`, `src/components/hint-bar.ts`, `src/theme.ts`
## When to Activate
- 터미널에서 도는 AI 에이전트/챗봇의 **초기화면·입력창·힌트바**를 짤 때
- 그 에이전트의 **시스템 프롬프트·스킬 로딩·MCP 연동·사용 룰**을 세팅할 때
- Node/Rust/Python 중 어느 걸로 갈지 결정하고 그 언어의 최소 골격을 얻을 때
대상 아님: 웹 UI, GUI 앱, TUI 없는 백엔드 에이전트, 한 번 출력하고 끝나는 단순 CLI 스크립트.
## 경로 규약
레퍼런스는 스킬 디렉터리에 설치된다. `${CLAUDE_SKILL_DIR}` = 이 SKILL.md가 위치한 디렉터리(런타임 주입).
- `${CLAUDE_SKILL_DIR}/references/node-pi-tui.md` — Node/TypeScript (pi-tui, stocker 원본)
- `${CLAUDE_SKILL_DIR}/references/rust-ratatui.md` — Rust (ratatui + crossterm)
- `${CLAUDE_SKILL_DIR}/references/python-textual.md` — Python (textual / rich)
- `${CLAUDE_SKILL_DIR}/references/agent-brain-setup.md` — 프롬프트·스킬·MCP·사용룰 (언어 중립)
## Step 0: 언어 선택
먼저 이 한 줄을 출력하고 시작한다:
```
ai-tui — lang: {node|rust|python} / scope: {intro | brain | both}
```
언어가 안 정해졌으면 결정 트리:
| 조건 | 언어 | 레퍼런스 |
|------|------|----------|
| 이미 LangChain/Vercel AI SDK 생태계, 빠른 반복, npm 자산 재사용 | **Node** | `node-pi-tui.md` |
| 단일 바이너리 배포, 저지연, 메모리 안전, 성능 우선 | **Rust** | `rust-ratatui.md` |
| 데이터/ML 파이프라인 옆, 위젯 풍부한 화면, 파이썬 자산 재사용 | **Python** | `python-textual.md` |
두 개가 비슷하면 **이미 팀이 쓰는 언어**를 택하고 넘어간다. 새 언어를 배우는 비용이 TUI 라이브러리 차이보다 항상 크다.
## 초기화면 6요소 (언어 중립)
터미널 에이전트 초기화면은 거의 항상 이 조합이다. 위→아래:
| 순서