AI 에이전트 하네스로 전략보고서 작성해보기

소개

긱뉴스에서 본, 스킬과 에이전트 팀을 묶어 주제별로 활용할 수 있는 하네스를 써 봤습니다. 파이썬 등의 실행파일이 있는 그런 구조를 기대했었지만 모두 md 파일이었어요. 스킬이 오케스트레이터 역할을 하고, 5개의 에이전트가 실행됩니다.

하나를 완성하지 못하고 리밋이 2번이나 걸렸는데 결과적으로 인상깊은 점은 구조였어요.
구조 분석을 해보니 아주 정교한게 하네라스라는게 이런거였네요.

진행 방법

1. git에서 harness-100 둘러보기

10개의 주제별로 100개의 하네스(스킬-단계별 에이전트 팀 묶음)이 있습니다.

"하네스란 최근 AI 에이전트 분야에서 "모델을 제어하고 도구와 연결하는 시스템 전체"를 가리키는 핵심 용어로 재정의되며 다시 주목받고 있습니다. (by gemini)"

https://github.com/revfactory/harness-100/blob/main/README_ko.md

100개 중에서 "그냥" 골라 47번 조직의 전략보고서를 작성해주는 하네스를 써봤습니다.
용도나 사용법등은 아래의 CLAUDE.md 파일로 확인할 수 있습니다. 파이썬등의 실행파일이 있기를 희망했는데 모두 md 파일로만 구성되어 있습니다.

안타깝게 토큰이 많이 들어갑니다.


# Strategy Framework Harness

조직의 전략 프레임워크를 OKR설계→BSC매핑→SWOT분석→비전·미션선언문→전략실행로드맵 순으로 에이전트 팀이 협업하여 생성하는 하네스.

## 구조

```
.claude/
├── agents/
│   ├── okr-designer.md          — OKR 설계 (목표·핵심결과 구조화, 정렬)
│   ├── bsc-analyst.md           — BSC 매핑 (4대 관점 연계, KPI 설계)
│   ├── swot-specialist.md       — SWOT 분석 (내외부 환경, 전략 매트릭스)
│   ├── strategy-writer.md       — 전략 문서 (비전·미션, 로드맵 작성)
│   └── strategy-reviewer.md     — 교차 검증 (OKR↔BSC↔SWOT↔문서 정합성)
├── skills/
│   ├── strategy-framework/
│       └── skill.md             — 오케스트레이터 (팀 조율, 워크플로우, 에러핸들링)
│   ├── okr-quality-checker/
│   │   └── skill.md             — OKR 품질 검증 (QSIM/SMART-V, 정렬, 안티패턴)
│   └── tows-matrix-builder/
│       └── skill.md             — TOWS 매트릭스 (SO/WO/ST/WT 전략, 우선순위)
└── CLAUDE.md                    — 이 파일
```

## 사용법

`/strategy-framework` 스킬을 트리거하거나, "전략 프레임워크 만들어줘" 같은 자연어로 요청한다.

## 산출물

모든 산출물은 `_workspace/` 디렉토리에 저장된다:
- `00_input.md` — 사용자 입력 정리
- `01_okr_design.md` — OKR 설계서
- `02_bsc_mapping.md` — BSC 매핑표
- `03_swot_analysis.md` — SWOT 분석서
- `04_vision_mission.md` — 비전·미션 선언문
- `05_strategy_roadmap.md` — 전략 실행 로드맵
- `06_review_report.md` — 리뷰 보고서

2. 전략 보고서 작성 하네스 써보기

사용하기 위한 대략 순서는 이렇습니다.
100개의 하네스를 git clone 해서, 작업폴더에 그 중에 사용할 하네스를 폴더와 .claude 를 복사합니다.
claude.ai 가 알려준 명령어를 치다 경로에러가 나서 그냥 시켰습니다.
역시 클로드는 시키는 맛이죠.

텍스트가 있는 검은 화면

텍스트가 있는 검은 화면


하네스가 사용한 전략분석 방법론에 적합한 주제를 claude 에게 물었습니다.
어떻게 돌아가는지 과정을 알고 싶었기 때문입니다.

한국 TV 채널 홈페이지 스크린샷
검정색 배경에 한국어 텍스트
한국어 텍스트가 있는 검은 화면


어떻게 돌아가는건지 과정을 좀 유심히 보았습니다.
총 7단계를 실행합니다.

한국어 텍스트가 있는 �검은 화면


첫단계를 완성하는데 15분, 툴을 8개 사용
다음 단계를 "병렬"로 진행하는게 인상적이네요.

검정색 배경의 Python 스크립트


총 7단계에서 3단계만에 1차 리밋

다양한 옵션을 보여주는 컴퓨터 화면의 스크린샷


다시 진행, 2단계 완료하고 또 2차 리밋
이것저것 찾던중에 때마침 올라온 뉴스에 옳거니 했지만,
토큰이 이렇게 빨리 소진되니 test 도 두번은 못하겠습니다

검정색 배경에 한국어 텍스트

검정색 배경에 흰색 글자가 적혀 있어요

한국어 웹사이트 스크린샷


교차검증을 거쳐 수정 후 완료 ~!



결과와 배운 점

오직 자연어로 구성된 md 파일로 구성된 스킬과 에이전트가 완벽하게 돌아가게 한 구조에 대해 배울 수 있었습니다. 다음은 폴더를 분석한 내용입니다.

'오케스트라 및 작업 흐름 관리'라는 단어가 포함된 한국 앱 스크린샷


다중 에이전트 통신 프로토콜의 스크린샷

3 상태 및 컨텍스트 관리


1
5개의 답글

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요