배경
현재 사이트 IA는 Concept Map의 서로 다른 책임 종류와 콘텐츠 형식을 동급 내비게이션 그룹으로 평탄화한다. Calendar는 Hands > /demo/calendar, AI Agent는 Artifact > /artifact/llm-agent에 배치되어 실제 Application 정체성과 제품에서 canonical module을 발견·추출하는 프로젝트의 개발 방향이 드러나지 않는다.
Goal Anchor
- Outcome: 사이트 IA가
Foundation → Building Blocks → Hands → Artifact → Applications 구조로 제품 세계관을 전달하고, 제품에서 canonical module을 발견·추출하는 양방향 흐름을 보여준다.
- Done: 전역 내비게이션, Concept Map, 홈 진입 구조가 새 IA와 일치하며 Calendar와 AI Agent가
Applications에서 독립 제품으로 탐색된다.
- Don't: canonical API·Usage의 기존 owner를 App으로 옮기지 않는다. Calendar의 reusable 책임과 Calendar App을 합치지 않는다. Artifact Viewer를 완성된 Application으로 승격하지 않는다.
Target Structure
json-document
├─ Overview
│ ├─ Why json-document
│ ├─ How We Build
│ └─ Concept Map
├─ Foundation
│ ├─ JSON Document
│ ├─ Document Types
│ ├─ Editing
│ └─ Collaboration
├─ Building Blocks
│ ├─ Platform Adapters
│ ├─ Ecosystem Connectors
│ ├─ Affordances
│ └─ UI Primitives
├─ Hands
│ ├─ Overview
│ ├─ Artifact Hands
│ └─ Agent Hands
├─ Artifact
│ ├─ Overview
│ ├─ Artifact Model
│ ├─ File Intake
│ ├─ Markdown
│ └─ Prototypes
├─ Applications
│ ├─ Calendar
│ │ ├─ Open Application
│ │ ├─ Product Overview
│ │ ├─ Composition Map
│ │ └─ Extracted Modules
│ └─ AI Agent
│ ├─ Open Application
│ ├─ Product Overview
│ ├─ Composition Map
│ └─ Extracted Modules
└─ Reference
├─ Package Index
├─ API Index
├─ Usage Index
├─ Live Examples
├─ Standards
└─ Changelog
Grounded Decision Context
- Problem: 책임 그래프, 콘텐츠 형식, 제품 residency가 하나의 IA 축에 섞여 Usage·Hand·Prototype·Application의 차이를 찾기 어렵다.
- Cause: Concept Map의 책임 분류를 사용자 IA로 직접 투영했고, Artifact를 담고 제품 정책을 소유하는 Application 위치를 모델링하지 않았다.
Application은 Artifact를 실제 제품 경험으로 제공하는 runtime/composition owner다.- 읽기 방향은
Foundation → Building Blocks → Hands → Artifact → Application이다.
- 발견 방향은
Application → 책임 발견 → Canonical Module → Application이다.
- Calendar는
Document Type, Hand/Toolkit, Application의 서로 다른 책임으로 유지한다.
- AI Agent는 session, runtime 연결, product shell과 정책을 소유하는 Application이다.
- Collaboration은 최종 별도 계층이 아니라 Foundation의
JSONDocument 대체 구현으로 배치한다.
- API와 Usage는 canonical owner에 남긴다.
Reference는 원문을 복제하지 않는 색인이다.
- 개별 Demo는 독립 IA 계층으로 두지 않고 해당 owner의 Usage 또는 Live Example로 연결한다.
Success Evidence
- 새 대분류와 하위 구조가 전역 내비게이션에서 탐색된다.
- 홈과 Concept Map이 구현 의존 방향과 제품에서 모듈을 추출하는 발견 방향을 함께 설명한다.
- Calendar App과 AI Agent App에 독립적인 진입 경로가 있다.
- Calendar의 문서 계약·Hands·App 책임이 서로 다른 owner로 표현된다.
- 기존 route, breadcrumb, sitemap 및 route validation이 새 IA와 일치한다.
- 관련 테스트, 타입 검사, 빌드와 실제 브라우저 탐색이 통과한다.
배경
현재 사이트 IA는 Concept Map의 서로 다른 책임 종류와 콘텐츠 형식을 동급 내비게이션 그룹으로 평탄화한다. Calendar는
Hands > /demo/calendar, AI Agent는Artifact > /artifact/llm-agent에 배치되어 실제 Application 정체성과 제품에서 canonical module을 발견·추출하는 프로젝트의 개발 방향이 드러나지 않는다.Goal Anchor
Foundation → Building Blocks → Hands → Artifact → Applications구조로 제품 세계관을 전달하고, 제품에서 canonical module을 발견·추출하는 양방향 흐름을 보여준다.Applications에서 독립 제품으로 탐색된다.Target Structure
Grounded Decision Context
Application은 Artifact를 실제 제품 경험으로 제공하는 runtime/composition owner다.Foundation → Building Blocks → Hands → Artifact → Application이다.Application → 책임 발견 → Canonical Module → Application이다.Document Type,Hand/Toolkit,Application의 서로 다른 책임으로 유지한다.JSONDocument대체 구현으로 배치한다.Reference는 원문을 복제하지 않는 색인이다.Success Evidence