의도와 구현의 분리를 통한 Structured Graph 기반 제품 설계 체계

Topogram’s structured graph: concept and implementation

John Attebury2026년 5월 15일4분intermediate

AI 요약

Context

제품 명세, API 계약, 전달 결과물이 코드 및 프로세스와 불일치하는 전형적인 동기화 실패 문제 발생. 파편화된 위키, OpenAPI 파일, 실제 구현체가 서로 다른 정보를 제공하는 비정형 문서 관리의 한계 존재.

Technical Solution

Durable Intent와 Stack Realization의 레이어 분리를 통한 설계 의도와 실행 환경의 독립적 관리
.tg 파일 및 Markdown 기반의 Typed Model을 구축하여 제품 지식을 명시적 Graph 구조로 정규화
폴더 구조와 무관하게 모든 데이터를 단일 Graph로 평탄화하는 Parser 기반 Ingestion 파이프라인 설계
CLI를 통한 Model Validation 단계 도입으로 생성 아티팩트 전파 전 오류를 사전 차단하는 가드레일 구축
UI, API, DB, CLI 계약을 Projection으로 정의하여 다양한 스택에 표준화된 Contract 제공
Graph-native 구조의 Journey 모델링을 통해 절차적 진실을 단순 텍스트가 아닌 구조적 데이터로 관리

실천 포인트

- 설계 의도(Intent)와 구현(Realization)을 분리하여 관리하는 아키텍처 검토 - 비정형 문서 대신 Typed Model을 도입하여 시스템 간 Traceability 확보 가능성 확인 - 핵심 기능(Capability), 투영(Projection), 여정(Journey) 단위의 작은 슬라이스로 POC 시작

태그

#Domain Modeling #SDLC #Traceability #Structured Graph #Contract Alignment

원문 읽기