# Context: Setup — Harness
- URL: https://zimmy.dev/harness/setup
- Tags: harness, coding-agent, setup

## User intent hint
Use this focused section as execution context and keep recommendations concrete.

## Hyperlinks (1-depth)
- Compound Engineering: https://every.to/guides/compound-engineering
- SDD Tools — Exploring Gen AI: https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html
- Harness Engineering: https://openai.com/index/harness-engineering/
- Effective Harnesses for Long-Running Agents: https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
- How Every Codes with Agents: https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents
- Building a C Compiler with an Agent: https://www.anthropic.com/engineering/building-c-compiler
- The Loop: https://ghuntley.com/loop/

## Article content
This is a focused section from the Harness workflow.

## 00. Setup
Environment, logging, and session management essentials

1. 병렬로 App이 뜰 수 있게 만든다.
   - 병렬 실행시 재시작되거나 Kill 하거나 다른 App에서 테스트하는 경우를 방지한다.
   - 포트 충돌 방지할 수 있게 만든다.
2. log를 파일로 남긴다. backend error를 복붙하는거 병목이다.
   - timestamp와 로그가 발생한 파일도 작성해둔다.
   - 1줄로 남긴다. grep으로 한 방에 찾을 수 있게.
3. CLAUDE.md (AGENTS.MD)는 Knowledge Dump가 아닌 Routing File 역할을 하도록 단순하게 유지한다.
   - architecture, schema 등 구체적인 내용은 docs/ 에 몰아 넣고 링크만 남긴다.
4. 세션 관리
   - 한 화면에 2개 이상 세션은 안둔다. 인지력 부하가 온다
   - 탭으로 나눈다
   - 탭에 이름을 넣고 필요할 때만 나중에 이어서 작업할 때만 세션에 이름을 부여한다.
   - Image: 탭 기반 세션 관리 예시 — 각 탭에 작업 이름을 부여한 터미널 화면 (asset: session-management.png)
5. Plugin을 쓰되 공부하고 사용한다. 자신의 입맛에 맞게 수정해서 쓴다.
6. 음성 입력을 적극 활용하여 타이핑 병목을 줄인다.
   - 무선 핀 마이크를 사용하여 접근성과 활동성을 높인다.
   - Willow Voice와 같은 음성 인식 도구를 활용한다.

## References
1. [Compound Engineering](https://every.to/guides/compound-engineering) (every.to)
2. [SDD Tools — Exploring Gen AI](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html) (martinfowler.com)
3. [Harness Engineering](https://openai.com/index/harness-engineering/) (openai.com)
4. [Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents) (anthropic.com)
5. [How Every Codes with Agents](https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents) (every.to)
6. [Building a C Compiler with an Agent](https://www.anthropic.com/engineering/building-c-compiler) (anthropic.com)
7. [The Loop](https://ghuntley.com/loop/) (ghuntley.com)