Archimate Skeleton — Development skill for Claude Code

archimate-skeleton

Claude Code skill — **서비스·시스템의 개념을 표준 어휘(ArchiMate)로 정리하고 결정론으로 컴파일한다.**

사람이 고치는 것은 JSON 사전 하나(`model.json`)뿐이다. 표와 그림은 산출물이고, 체커가 `exit code` 로 앞을 막는다.


references/archimate.catalog.json   어휘 정본 — 원소 61 · 관계 11 · 마커 8 · 프로파일 · 규칙
            │
        model.json                  당신의 개념 — 원소·관계. 좌표 없음
            │
        view.*.json                 좌표 + show 필터 (뷰 = 모델의 걸러진 투영)
            │
  archicheck.py  →  exit code       게이트. 여기서 막히면 나머지는 뜻이 없다
  model_table_draw.py → 표          기본. 손 배치 0
  model_draw.py  → 그림       뷰를 줄 때만

왜

"이게 기능인가 저장소인가" 를 두 번 이상 물었다면 이 스킬이다. 매번 새로 답하면 같은 상자가 보는 각도에 따라 종류가 바뀌고, 그림은 관계를 못 말하고 **나열**이 된다.

어휘를 고정하면 그 어휘가 거꾸로 기능을 심문한다 — 저장소끼리는 직접 못 잇고, 프로세스는 입력과 출력이 있어야 한다. 실측: 한 서비스의 개념 17개를 넣자마자 **출구 없는 프로세스 1건 · 입력 없는 프로세스 2건 · 한 이름에 입구 셋 1건**이 드러났다.

쪼갬은 비용이 아니라 축이다

개념 1개	쪼개짐	얻는 것
저장소	Data Object(논리) ← Artifact(물리) ← System Software	개념층/실제층 분리. Artifact 가 비면 "개념은 확정, 구현은 아직" 이 구조로 표현된다
기능	Application Service(계약) ← Application Function(내부)	계약은 확정, 내부는 리팩터 중 — 그 상태가 적힌다
묶음	Grouping + composition	화살표가 아니라 포함. "테두리에 화살표가 꽂힌다" 는 거짓말이 불가능

판별 한 줄: **데이터가 그 상자를 통과하는가.** 통과하면 프로세스, 아니면 묶음.

설치

git clone https://github.com/fbdeme/archimate-skeleton ~/.claude/skills/archimate-skeleton

`exlib.py`(Excalidraw JSON 팩토리)와 PNG 렌더러는 [fbdeme/excalidraw](https://github.com/fbdeme/excalidraw) 스킬 소유다. 스크립트가 그쪽에서 찾으므로 복사하지 않는다.

쓰기

mkdir arch && cd arch
cp ~/.claude/skills/archimate-skeleton/examples/{model,view.structure,view.flow}.json .
S=~/.claude/skills/archimate-skeleton/scripts

python3 $S/archicheck.py --selftest          # 7/7 가드 발화
python3 $S/archicheck.py                     # 게이트 — exit 1 = FAIL
python3 $S/model_table_draw.py               # 표 4장 (표 1 = 체커 결과)
python3 $S/model_draw.py view.structure.json # 그림

시행 기록이 이 스킬의 방법론이다

ArchiMate 로 정한 것은 **두 번 시행해서 기록했기 때문*