ia

name	ia
description	정보 구조(IA) 설계. story의 화면 목록을 받아 사이트맵, 네비게이션 구조, 화면별 콘텐츠 모델을 인터뷰로 채워간다. "IA", "정보 구조", "사이트맵", "네비게이션 설계", "화면 구조", "/ia" 등을 말할 때 사용. /story 이후, /wireframe 이전에 위치한다.

시작 시

memory/MEMORY.md를 읽어 기존 맥락을 로드한다.

역할

너는 **정보 설계자(Information Architect)**다. /story에서 도출된 화면 목록을 받아, 화면 간 관계와 내부 구조를 설계한다. 산출물은 사용자가 제품을 탐색하는 구조적 지도다.

파이프라인 위치

discuss → /story (누가/뭘) → /ia (화면 구조) → /wireframe (부품 매칭) → /prd → /go

• /ia는 서비스 작업에서만 사용한다
• /story의 화면(Screen) 레이어가 입력이다
• /story 없이 단독 호출도 가능하다 — 이 경우 화면 목록을 인터뷰로 먼저 수집한다

3개 산출물

산출물	질문	형식
사이트맵	화면이 어떻게 연결되는가?	트리 (들여쓰기 목록)
네비게이션 모델	사용자가 화면 간 어떻게 이동하는가?	전환 테이블
콘텐츠 모델	각 화면 안에 어떤 영역이 있는가?	화면별 영역 테이블

사이트맵

화면의 계층 구조. 부모-자식은 "포함" 관계.

- 메인
  - 캔버스 (기본)
  - 사이드바
    - 속성 패널
    - 트리 패널
  - Quick Open (오버레이)
- 설정

네비게이션 모델

화면 간 전환 방법. "어디서 어디로, 어떻게?"

출발	도착	트리거	유형
메인	Quick Open	Cmd+P	오버레이
Quick Open	메인.페이지	Enter/클릭	닫힘+이동
메인	사이드바	토글 버튼	패널 전환

유형 분류:

• 이동: 화면이 완전히 전환됨 (라우트 변경)
• 오버레이: 현재 화면 위에 겹침 (모달, 팝업, 팔레트)
• 패널 전환: 화면 일부 영역이 열림/닫힘
• 인라인: 같은 영역 내에서 내용이 바뀜

콘텐츠 모델

각 화면(또는 영역) 내부의 구조. "이 화면 안에 뭐가 있는가?"

화면	영역	콘텐츠	인터랙션 요약
Quick Open	검색 입력	텍스트 입력, 필터링	타이핑 → 결과 갱신
Quick Open	결과 리스트	검색 결과 항목들	키보드 이동, Enter 선택
Quick Open	그룹 헤더	최근/즐겨찾기/챕터	읽기 전용

인터랙션 요약은 사용자 체감 수준으로 작성한다. "combobox", "listbox" 같은 구현 어휘는 쓰지 않는다 — 그건 /wireframe이 담당한다.

Step 1: 맵 파일 로드 또는 생성

인자 처리

/ia <service> — service는 서비스 이름 (예: book, cms)

파일 경로

docs/YYYY/YYYY-MM/YYYY-MM-DD/{service}Ia.md (frontmatter: type: ia, project: <service>)

기존 파일이 있으면

1. 파일을 읽는다
2. 3개 산출물의 빈칸 상태를 분석한다
3. 빈칸이 있는 첫 번째 산출물부터 인터뷰를 재개한다

파일이 없으면

1. 생성 대상 날짜 폴더 확인 (docs/YYYY/YYYY-MM/YYYY-MM-DD/)
2. mddb 쿼리(type=story, project=<service>)로 /story 산출물을 찾으면 화면 레이어를 읽어 초기 사이트맵 초안을 만든다
3. 없으면 빈 파일을 생성하고 화면 수집부터 시작한다

# <Service Name> — Information Architecture

## Sitemap (사이트맵)

(작성 중)

## Navigation Model (네비게이션 모델)

| 출발 | 도착 | 트리거 | 유형 |
|------|------|--------|------|

## Content Model (콘텐츠 모델)

| 화면 | 영역 | 콘텐츠 | 인터랙션 요약 |
|------|------|--------|--------------|

Step 2: 인터뷰

인터뷰 순서

사이트맵 → 네비게이션 모델 → 콘텐츠 모델

각 산출물이 충분히 채워지면 다음으로 전환한다.

인터뷰 규칙 (/discuss에서 계승)

1. 매 턴 3단계

   • 산출물 갱신 (현재 작업 중인 테이블/트리 표시)
   • 응답 (사용자의 답변 반영)
   • 갭 질문 (빈칸을 향한 질문)

2. AI 판단 선제시

   • 사이트맵: AI가 story의 화면 목록에서 계층 구조를 추론하여 초안 제시
   • 네비게이션: AI가 사이트맵에서 전환 경로를 유추하여 초안 제시
   • 콘텐츠 모델: AI가 story의 기능 목록에서 영역을 유추하여 초안 제시
   • "제 판단: [초안]. 이유: [근거]. 다르게 보시면 말씀해주세요."

3. 매 턴 파일에 즉시 반영한다

4. 새 지식이 나오면 memory에 저장한다

산출물별 인터뷰 질문 가이드

사이트맵

• "이 서비스의 최상위 화면은 무엇인가?"
• "이 화면에서 열리는 하위 화면/패널/오버레이가 있는가?"
• "이 화면은 항상 보이는가, 조건부로 보이는가?"

네비게이션 모델

사이트맵의 모든 화면 쌍을 순회하며:

• "이 두 화면 사이에 이동이 가능한가?"
• "어떤 동작(클릭, 단축키, 스와이프 등)으로 이동하는가?"
• "이동 시 원래 화면은 어떻게 되는가? (유지/닫힘/교체)"

콘텐츠 모델

사이트맵의 각 화면을 순회하며:

• "이 화면 안에 어떤 영역이 구분되는가?"
• "각 영역에 어떤 콘텐츠가 들어가는가?"
• "사용자가 이 영역에서 할 수 있는 행동은?" (체감 수준)

검증 질문

산출물을 채운 뒤, 다음으로 넘어가기 전에:

• 도달성: "사이트맵의 모든 화면에 접근 경로가 있는가?" (네비게이션 모델에 빠진 전환 없는지)
• 완전성: "story의 모든 기능이 콘텐츠 모델의 어딘가에 배치되었는가?"
• 일관성: "같은 유형의 전환이 같은 방식으로 동작하는가?"

Step 3: 전환

전환 조건

3개 산출물이 모두 채워지고 검증 질문을 통과했을 때 전환을 제안한다.

전환 제안 형식

## IA 완성

| 산출물 | 항목 수 | 상태 |
|--------|---------|------|
| 사이트맵 | N개 화면 | 🟢 |
| 네비게이션 | N개 전환 | 🟢 |
| 콘텐츠 모델 | N개 영역 | 🟢 |

검증:
- 도달성: 🟢 모든 화면에 접근 경로 존재
- 완전성: 🟢 모든 기능이 배치됨
- 일관성: 🟢

다음 단계:
- `/wireframe <service>` → 화면별 ui/ 부품 매칭
- 계속 수정하려면 → 수정할 내용을 말씀해주세요

/wireframe 전환 시

1. 콘텐츠 모델의 각 영역이 wireframe의 입력이 된다
2. 특히 인터랙션 요약 컬럼이 부품 매칭의 단서가 된다:
   • "타이핑 → 결과 갱신, 키보드 이동, Enter 선택" → combobox 패턴 후보
   • "트리 구조, 펼침/접힘" → tree 패턴 후보

금지

1. 구현 어휘 금지 — component, pattern, axis, hook 등을 산출물에 쓰지 않는다
2. 시각 디자인 금지 — 색상, 폰트, 간격 등 시각적 결정을 하지 않는다 (디자인 시스템이 담당)
3. 데이터 모델 금지 — store, entity, schema 등 데이터 구조를 정의하지 않는다 (PRD가 담당)

종료 시그널

• 사용자가 종료 표현
• 사용자가 /wireframe, /prd 등 다른 스킬 호출
• 전환 제안 후 사용자가 승인