ax-navi

변경 대상(파일/함수/클래스/SQL/엔드포인트/DB 컬럼)의 직간접 영향과 위험도를 분석한다. "영향도 분석", "이거 수정하면 어디 영향?", "이 함수 수정해도 돼?", "이 SQL 바꾸면 어디 영향?", "이 컬럼 추가했을 때 영향", "impact analysis", "이 API 변경 영향", "분석해줘 영향", "이거 건드려도 돼?", "어디서 쓰이고 있어?", "이 메서드 호출처" 요청 시 트리거. 축약 호출 "영향도 [대상]", "임팩트 [대상]"도 트리거. 인덱스가 없으면 analyzer를 feature-scoped 모드로 먼저 호출.

페어 연동된 백엔드·프론트엔드(1:1) 또는 백엔드+여러 클라이언트(1:N) 중 한쪽에서 지시한 기존 기능 개선/수정을, 필요 시 관련 저장소들에 함께 반영한다. "이 기능 개선해줘", "API 필드 추가해줘", "이거 고쳐야 하는데 프론트도 같이", "양쪽 다 수정해줘", "cross-repo modify", "풀스택 수정", "백엔드 프론트 둘 다 고쳐줘", "이 API 바꾸는데 프론트 영향 있으면 같이 처리해줘" 요청 시 트리거.

기능/코드 위치 탐색 단축 호출(별칭). "/find [기능·키워드]" 요청 시 ax-navi:find-feature(관련 파일·클래스·메서드·SQL 목록 반환)로 위임한다.

harness 산출물(_workspace + .claude)을 기반으로 프로젝트 wiki 페이지 세트를 생성한다. call_graph.json을 vis-network 기반 인터랙티브 HTML(call-graph.html)로 변환하는 것을 포함. 생성 후 원하면 별도 프로젝트 wiki-hub(여러 시스템 통합·버전관리 중앙 허브)로 이어서 발행할 수 있다. "wiki 만들어줘", "wiki 생성", "문서 wiki", "프로젝트 wiki 생성", "위키 만들어줘", "generate wiki", "위키 업데이트", "call graph 시각화", "호출 그래프 wiki" 요청 시 트리거. harness-init 완료 후에는 자동 실행되지 않는다 — Phase 3.6 선택 작업 메뉴에서 사용자가 고를 때만 실행된다(2026-08-16 자동 실행 해제, 토큰 절감).

현재 프로젝트에 설치된 harness 파일 전체를 제거한다. "하네스 삭제", "하네스 제거", "harness 지워줘", "harness clean", "harness remove", "harness uninstall", "초기화 되돌려줘", "harness 롤백" 요청 시 사용. CLAUDE.md · .claude/skills/ · .claude/agents/ · .claude/patterns/ · _workspace/ 를 정리한다.

프로젝트를 심층 분석해 맞춤형 하네스(CLAUDE.md, 로컬 스킬 3종, 도메인 에이전트, 패턴, 인덱스)를 자동 생성하는 오케스트레이터. "하네스 초기화", "하네스 만들어줘", "하네스 다시 초기화", "harness 다시 만들어줘", "프로젝트 분석해서 설정해줘", "이 프로젝트 Claude 설정해줘", "create harness", "initialize harness", "re-initialize harness", "generate project harness", "하네스 업데이트", "하네스 보완", "스킬만 다시 생성", "에이전트만 다시 생성", "validator만 다시 실행", "패턴 추출해줘", "pattern extract" 요청 시 사용. `.claude/skills/trace.md`가 없으면 자동 트리거.

영향도 분석 단축 호출(별칭). "/impact [대상]" 요청 시 ax-navi:analyze-impact(변경 대상의 직간접 영향·위험도 분석)로 위임한다.

수정 작업 단축 호출(별칭). "/modify [내용]" 요청 시 ax-navi:safe-modify(사전 영향 분석→적용→사후 안전성 평가)로 위임한다. "modify로 고쳐줘" 같은 표현도 트리거.

생성된 폴더 wiki를 중앙 DB(MSSQL/PostgreSQL/Oracle/SQLite)에 발행한다. 시스템 단위로 구분하고 백엔드·프론트엔드를 컴포넌트로 분리 저장하며, 내용이 바뀐 페이지만 새 버전으로 쌓는다. API·DB테이블·화면·외부연동은 별도 인덱스 테이블에 함께 적재한다. "wiki 발행", "위키 중앙 DB에 올려줘", "wiki 허브에 등록", "시스템 위키 등록", "publish wiki", "위키 버전 올려줘", "백엔드 프론트엔드 위키 분리 저장" 요청 시 트리거. harness-init·generate-wiki 완료 후 자동 제안.

코드 변경을 사전 영향 분석 → 적용 → 사후 안전성 평가 순으로 안전하게 수행. "안전하게 수정", "회귀 위험 없이 변경", "safe modify", "이 변경 안전한가?", "변경 전 체크", "이 패치 적용해도 돼?", "운영 패치 검토", "긴급 핫픽스", "이 수정 GO/NO-GO?", "변경 리뷰" 요청 시 트리거. 범용 수정 요청("수정해줘", "고쳐줘", "개선해줘", "버그 잡아줘", "이거 바꿔줘")도 기본적으로 이 스킬을 탄다 — 게이트 없이 바로 하려면 vibe 스킬("알아서 해줘"). 축약 호출: "안전수정 [내용]".

신규 기능 생성 단축 호출(별칭). "/scaffold [기능명]" 요청 시 ax-navi:scaffold-feature(프로젝트 컨벤션 기반 신규 기능 스캐폴딩)로 위임한다.

작업 시작 전 소크라테스식 인터뷰로 목적·범위·제약을 명확화한다. "명세 명확화", "요구사항 정리해줘", "spec gate", "작업 범위 정해줘", "어디서부터 시작해야 해", "ambiguity check", "뭐부터 해야 해", "범위 정의해줘", "작업 목표 정리해줘", "시작 전 정리", "scope clarify" 요청 시 사용. harness-init은 자동 호출하지 않는다 — harness-init 실행 전 목적·범위를 먼저 정리하고 싶으면 이 스킬을 독립적으로 먼저 호출한다.

SQL 리뷰 단축 호출(별칭). "/sql [쿼리·SQL ID·DDL]" 요청 시 ax-navi:review-sql(사용처·성능·보안·트랜잭션·스키마 영향 종합 리뷰)로 위임한다.

특정 기능·API·화면의 처리 흐름을 진입점부터 DB까지 추적한다. "주문 취소 로직 어디 있어?", "이 API 어떻게 처리돼?", "결제 흐름 보여줘", "로그인 로직 따라가줘", "이 화면 저장 버튼 누르면 뭐가 실행돼?", "처리 흐름 알려줘", "실행 흐름", "로직 흐름", "trace logic", "flow of", "흐름 추적", "어떻게 동작해?", "동작 방식", "내부 구조" 요청 시 트리거.

영향도·안전성 에이전트 게이트는 생략하되 기존 프로젝트 패턴과 최소 실행 검증은 유지하는 빠른 작업 모드. "알아서 해줘", "그냥 해줘", "바이브로", "바이브 코딩", "빠르게 그냥 고쳐", "vibe" 요청 시 트리거.

프로젝트 위키 생성/갱신 단축 호출(별칭). "/wiki" 요청 시 ax-navi:generate-wiki(하네스 산출물 기반 위키 페이지 세트 생성, call graph 시각화 포함)로 위임한다.

별도 프로젝트 wiki-hub를 실행해 여러 시스템의 wiki를 한 사이트에서 통합 열람·검색·관리한다. 시스템 목록, 백엔드/프론트엔드 컴포넌트 구분, 전 시스템 문서 전문 검색, API·DB테이블·화면·외부연동 교차 인덱스, 페이지별 버전 이력·비교·복원을 제공한다. "위키 허브 띄워줘", "통합 위키 보여줘", "시스템 위키 목록", "wiki 검색", "위키 버전 비교", "이전 버전으로 되돌려줘", "wiki hub", "중앙 위키 관리", "DB 위키 보여줘" 요청 시 트리거.