AI 스킬마트스킬 둘러보기명령어프로그램배우기스킬이 뭐예요?
 
← 목록으로

Archify 튜닝 실험 가이드

Archify 다이어그램 생성 품질(정확성·가독성·속도)을 실험·증거 기반으로 개선하는 내부 튜닝 절차 스킬.

개발·코딩고급★ 91,820⑂ 6,257AI 점수 6/10마지막 업데이트: 2026. 10. 30.

무엇을 해주나

  • Archify가 생성하는 아키텍처 다이어그램의 정확성 → 가독성 → 효율(소요 시간·재수정 횟수) 우선순위를 고정하고, 그 기준으로 변경을 판단하게 합니다.
  • 레이아웃·라우팅·진단(diagnostics)·작성 지침·합격 규칙(acceptance rules) 변경을 "가설 → 실험 설계 → 원인 귀속 → 최소 범위 수정 → 검증 → 결론 기록"의 6단계 루프로 진행시킵니다.
  • 테스트 통과 자체를 품질 증거로 삼지 않도록 경고하고, 부적절한 규칙은 범위·임계값·심각도를 고쳐 폐기하는 길까지 제시합니다.
  • replay.mjs(고정 입력 비교), round.mjs(작성 과제 준비), collect.mjs(트레이스 수집), shots.mjs(스크린샷 비교) 사용 지점을 표로 안내합니다.
  • 실험 기록은 저장소 밖 $ARCHIFY_TUNING_HOME(기본 ~/.local/share/archify-tuning)에 보관해 비공개 소스 유출을 막도록 규정합니다.

이런 분께 추천

  • Archify 저장소에 직접 기여하는 메인테이너·컨트리뷰터.
  • 다이어그램/그래프 렌더러의 레이아웃·라우팅 품질을 정량·정성 증거로 튜닝해야 하는 엔지니어.
  • 에이전트 생성물의 평가 체계를 설계하려는 사람 (방법론 참고용).

활용 예시

  1. "벤드 수 제한 규칙 때문에 멀쩡한 다이어그램이 반려된다" — 규칙이 막으려던 사용자 피해가 실제로 존재하는지 확인한 뒤 임계값을 조정하고 before/after 근거를 남긴다.
  2. 라우터 변경 후 replay.mjs --base <base>/archify로 고정 입력 결과를 비교하고, 바뀐 pass/fail 하나하나를 실제 회귀·오탐 수정·의도된 규칙 변경으로 구분한다.
  3. 새 프로젝트로 round.mjs를 돌려 첫 초안 품질과 최초 사용 가능 산출물까지의 시간을 측정하고, 실패한 실행은 속도 개선으로 집계하지 않는다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/tt-a1i/archify/HEAD/.agents/skills/archify-tuning/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

AI 스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 tt-a1i/archify 의 .agents/skills/archify-tuning 폴더를 내 ~/.claude/skills/archify-tuning/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/tt-a1i/archify.git && mkdir -p ~/.claude/skills && cp -r archify/.agents/skills/archify-tuning ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 이 스킬은 Archify 저장소 내부 전용(internal: true)이므로, 먼저 저장소를 받아야 합니다: git clone https://github.com/tt-a1i/archify.git
  2. 저장소 루트로 이동합니다: cd archify
  3. 저장소 안에서 그대로 쓰려면 추가 설치가 필요 없습니다. Claude Code를 archify 루트에서 실행하면 .agents/skills/archify-tuning을 인식시킬 수 있습니다.
  4. 전역으로 쓰고 싶다면 mkdir -p ~/.claude/skills && cp -r .agents/skills/archify-tuning ~/.claude/skills/ 를 실행합니다. 단, 본문이 참조하는 scripts/와 ../../../CONTRIBUTING.md 경로가 깨질 수 있습니다.
  5. 사전 준비물: Node 22.13 이상, 스크린샷용 Chrome/Chromium(ARCHIFY_CHROME으로 경로 지정 가능).
  6. 실험 기록 폴더를 정합니다: export ARCHIFY_TUNING_HOME=~/.local/share/archify-tuning (저장소에 커밋하지 마세요).
  7. Claude Code에서 "archify-tuning 스킬로 라우팅 변경 실험을 설계해줘"처럼 요청해 사용합니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0