chore: readme 수정
This commit is contained in:
DongHyeonka
@@ -1,12 +1,12 @@
|
||||
# TechViz Harness 0.2.0
|
||||
|
||||
기존 Markdown/MDX 기술문서의 앞뒤 문맥을 읽고, 문서에 근거한 **diagram-only 기술 시각화**를 생성하는 에이전트 하네스입니다. Codex, Claude Code, Antigravity가 같은 Agent Skill, CLI, VizSpec IR을 사용합니다.
|
||||
에이전트 하네스입니다. 기존 Markdown/MDX 기술문서의 앞뒤 문맥을 읽어 문서에 근거한 diagram-only 기술 시각화를 생성합니다. Codex, Claude Code, Antigravity가 같은 Agent Skill, CLI, VizSpec IR을 사용합니다.
|
||||
|
||||
|
||||
|
||||
## 0.2.0에서 해결한 문제
|
||||
|
||||
0.1.x의 예제 갤러리는 렌더러의 목표 품질을 보여 주었지만 실행 파이프라인과 연결되지 않았습니다. 그 결과 모델은 예제를 보지 않은 채 일반 노드 목록을 생성했고, 런타임은 모든 문서를 같은 위상 정렬과 둥근 박스로 그릴 수 있었습니다. 전역 제목·질문·footer도 SVG 안에 반복되었습니다.
|
||||
0.1.x의 예제 갤러리는 렌더러의 목표 품질을 보여 주었지만 실행 파이프라인과 연결되지 않았습니다. 그 결과 모델은 예제를 보지 않은 채 일반 노드 목록을 생성했고 런타임은 모든 문서를 같은 위상 정렬과 둥근 박스로 그릴 수 있었습니다. 전역 제목·질문·footer도 SVG 안에 반복되었습니다.
|
||||
|
||||
0.2.0은 이 문제를 런타임 계약 수준에서 수정합니다.
|
||||
|
||||
@@ -17,7 +17,7 @@
|
||||
- `comparison`과 `timeline`을 제외한 끊어진 카드 묶음을 하드 오류로 차단합니다.
|
||||
- 문맥에서 선택되지 않은 profile/reference 사용을 lint 오류로 차단합니다.
|
||||
- 여러 결과가 하나의 topology로 붕괴하는 현상을 `audit-batch`로 검출합니다.
|
||||
- SVG는 diagram-only이며, 보이는 제목·부제·footer·워터마크를 생성하지 않습니다.
|
||||
- SVG는 diagram-only이며 보이는 제목·부제·footer·워터마크를 생성하지 않습니다.
|
||||
|
||||
## 파이프라인
|
||||
|
||||
@@ -111,7 +111,7 @@ payment-approval-sequence sequence score=8 matched=승인
|
||||
runtime: examples/runtime-profiles/08-sequence/spec.json
|
||||
```
|
||||
|
||||
에이전트 호스트가 이미지를 열 수 있으면 preview를 확인하고, 반드시 runtime `spec.json`도 읽습니다. 이미지 입력이 없는 호스트를 위해 동일한 구조 규칙이 프롬프트에 텍스트로 포함됩니다.
|
||||
에이전트 호스트가 이미지를 열 수 있으면 preview를 확인하고 반드시 runtime `spec.json`도 읽습니다. 이미지 입력이 없는 호스트를 위해 동일한 구조 규칙이 프롬프트에 텍스트로 포함됩니다.
|
||||
|
||||
### 4. 모델 프롬프트 생성
|
||||
|
||||
@@ -137,7 +137,7 @@ VizSpec 1.1의 핵심 블록:
|
||||
}
|
||||
```
|
||||
|
||||
모든 사실 노드·엣지·경계는 원문 라인 근거를 가집니다.
|
||||
모든 사실 노드·엣지·경계에는 원문 라인 근거가 있습니다.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -192,7 +192,7 @@ SVG에는 다이어그램 해독에 필요한 노드·경계·연결선·상태/
|
||||
techviz audit-batch .techviz --pattern "**/spec.json"
|
||||
```
|
||||
|
||||
`audit-batch`는 레이블과 id를 제거한 topology fingerprint를 계산합니다. 25개 그림의 이름만 달라지고 구조가 같은 경우 다음과 같이 실패합니다.
|
||||
`audit-batch`는 레이블과 id를 제거한 topology fingerprint를 계산합니다. 25개 그림의 이름만 달라지고 구조가 같은 경우 실패합니다.
|
||||
|
||||
```text
|
||||
ERROR batch-template-collapse 22/25 specs share the same label-independent topology
|
||||
@@ -236,7 +236,7 @@ examples/runtime-profiles/01-...10-.../
|
||||
현재 Python compositor와 SVG renderer가 실제 생성한 실행 fixture
|
||||
```
|
||||
|
||||
`examples/runtime-profiles`는 테스트에서 전부 load → lint → layout → SVG render → XML parse됩니다. 정적 갤러리만 좋아 보이고 런타임이 다른 결과를 내는 문제를 방지하기 위한 회귀 계약입니다.
|
||||
`examples/runtime-profiles`는 테스트에서 전부 load → lint → layout → SVG render → XML parse됩니다. 회귀 계약입니다. 정적 갤러리만 좋아 보이고 런타임이 다른 결과를 내는 문제를 방지하기 위해서입니다.
|
||||
|
||||
## 에이전트 호스트 통합
|
||||
|
||||
@@ -269,7 +269,7 @@ python scripts/sync_skills.py
|
||||
- **Excalidraw:** 초안/워크숍 원본. 기본 배포 형식은 아님.
|
||||
- **alt.md:** 짧은 alt와 구조화된 상세 설명.
|
||||
|
||||
SVG는 표현력의 병목이 아닙니다. 품질을 결정하는 것은 VizSpec의 의미 구조, profile 선택, role, compositor와 lint gate입니다.
|
||||
품질은 VizSpec의 의미 구조와 profile 선택, role, compositor와 lint gate가 결정합니다. SVG는 표현력의 병목이 아닙니다.
|
||||
|
||||
## 보안 및 신뢰성
|
||||
|
||||
@@ -311,4 +311,4 @@ PYTHONPATH=src python scripts/check_generated.py
|
||||
techviz audit-batch examples/runtime-profiles
|
||||
```
|
||||
|
||||
0.2.0의 테스트는 schema/parser, 문맥, profile lint, 실제 10개 compositor, SVG diagram-only 계약, batch-collapse 탐지를 포함합니다.
|
||||
0.2.0의 테스트는 schema/parser, 문맥, profile lint를 포함합니다. 실제 10개 compositor와 SVG diagram-only 계약, batch-collapse 탐지도 포함합니다.
|
||||
|
||||
Reference in New Issue
Block a user