cat contribution.sh
# CLI · 그래프 최적화 · CI · 프로젝트 일정에 기여했습니다.
- project=
- "
Gitrochi
" - role=
- "기여 개발자" # 기존 프로젝트 기여
- since=
- "2026.10.23" # 첫 기여
- verified=
- "2026.11.05" # 이력 확인
- stack=
- ("Bash" "Rust" "TypeScript · React" "SQLite" "Tauri" "MCP")
Gitrochi는 Git 저장소, CI와 프로젝트 작업을 한곳에서 다루는 macOS·Windows 개발 워크스페이스입니다. 저는 CLI 통합과 구조 그래프·최적화, CI와 일정·프로젝트 기능을 중심으로 기여하고, 검사 실행과 AI 작업 원장까지 개발 흐름을 확장했습니다.

제가 기여한 핵심 영역
Gitrochi에서 CLI 통합, 구조 그래프와 최적화, CI·프로젝트·일정 기능을 중심으로 기여했습니다. 코드의 연결을 파악하고, 변경을 검사하고, 팀의 작업과 AI 세션의 반영 상태까지 이어지는 개발 흐름을 다뤘습니다.
CLI와 구조 그래프로 변경의 맥락을 드러냅니다
다중 계정 Git CLI를 통합하고, Tuist의 graph 발상을 파일·모듈·변경 이력 분석으로 확장했습니다. 공통 데이터와 웹 화면을 연결하고 큰 그래프의 탐색 비용을 다뤘습니다.
사례 보기계정 정책과 호환성 · 의존 분석 · 그래프 최적화 ↓CI와 프로젝트·일정을 개발 흐름에 연결합니다
저장소의 코드 작업과 CI 결과, 프로젝트 이슈·보드·일정을 한 워크스페이스에서 이어 가도록 기여했습니다. 화면의 진입 경로뿐 아니라 조회와 식별, 상태 갱신까지 함께 다뤘습니다.
사례 보기CI 실행 맥락 · 프로젝트 관리 · 일정 탐색 ↓검사 결과와 AI 작업 상태에 판단 근거를 남깁니다
Flow에서는 실제 테스트 실행과 결과를 함께 판정하고, Ledger에서는 시작 기준·질문·산출물·반영 상태를 기록했습니다. 앱·CLI·MCP가 같은 계약을 사용하도록 구성했습니다.
사례 보기실행·관측·판정 · 기준 버전 · 사람과 에이전트의 권한 ↓
기여 사례 01
앱과 터미널에서 이어지는 다중 계정 Git CLI
개인 GitHub와 회사 GitLab처럼 여러 계정을 한 컴퓨터에서 사용하면 저장소의 작성자와 실제 push 계정이 엇갈릴 수 있습니다. 사람이 터미널에서 작업할 때와 AI 도구가 명령을 실행할 때 같은 규칙이 적용되어야 했고, 기존 gitsw 사용자의 설정과 스크립트도 계속 동작해야 했습니다.
제가 기여한 내용
- 기존 gitsw를 gitch라는 이름으로 Gitrochi의 tools/gitch에 통합했습니다. 명령만 옮기는 데서 끝내지 않고 스크립트·설명서·회귀 테스트를 함께 가져와 앱과 CLI가 공유하는 배포 단위로 구성했습니다.
- 저장소별 계정 잠금과 폴더·조직·원격 주소에 따른 계정 규칙을 유지했습니다. 작업 전 점검과 커밋·push 시점의 검사가 같은 계정 정책을 따르도록 연결했습니다.
- 예전 gitsw 명령을 호출하는 연결 스크립트와 기존 설정 경로, 저장소의 계정 키, Git 훅과 복구 참조를 보존했습니다. 명칭 변경 때문에 사용자의 계정 설정과 작업 이력이 끊기지 않도록 호환 경계를 유지했습니다.
- 설치 과정에서 CLAUDE.md·AGENTS.md 규칙, 스킬과 명령 검사 훅의 기존 이름을 새 이름으로 옮기도록 구성했습니다. 사용자가 별도로 작성한 규칙과 허용 항목은 보존하는 방향으로 마이그레이션을 구현했습니다.
- 새 이름과 예전 이름 모두 같은 보호 정책을 거치도록 검사했습니다. AI가 사용하는 명령 이름만 바꾸어 계정·인증 관련 작업의 권한 경계를 벗어나지 않도록 다뤘습니다.
기술을 도입한 이유와 구현
- Bash + 시스템 Git
도입 이유CLI 설치에 필요한 실행 환경을 줄이고, Git의 실제 동작과 기존 사용자의 도구를 그대로 활용하기 위해서입니다. 계정 선택과 작업 정책을 공통 명령에 모으면 앱과 터미널이 같은 기준으로 작업할 수 있습니다.
구현기본 Bash와 시스템 Git을 사용하는 CLI를 통합했습니다. 현재 Windows에서는 Git for Windows의 Git Bash를 통해 같은 스크립트를 실행합니다. 플랫폼별 화면은 CLI의 결과를 소비하고 Git 작업은 기존 실행 경계로 연결합니다.
- 저장소 계정 잠금 + 실행 전·훅 검사
도입 이유화면에 계정 이름을 보여 주는 것만으로는 다른 도구가 실행하는 커밋과 push까지 일관되게 다루기 어렵습니다. 사용자가 작업을 시작할 때 확인하고, 실제 변경이 기록되거나 전송되는 시점에도 검사할 필요가 있었습니다.
구현preflight에서 작성자·push 대상과 계정 상태를 확인하고, 커밋·push 훅에서 작성자 불일치, 비밀값과 보호된 작업을 검사하는 기존 정책을 함께 통합했습니다. AI 규칙과 명령 검사 훅도 같은 CLI 명령을 사용하도록 연결했습니다.
- 기존 명령 호환 + 설치 마이그레이션
도입 이유CLI 이름을 바꾸더라도 이전 이름을 사용하는 자동화와 계정 설정이 남아 있습니다. 사용자가 모든 호출과 설정을 한꺼번에 바꾸지 않아도 새 배포로 이동할 수 있어야 했습니다.
구현gitsw를 gitch로 연결하는 호환 경로를 두고 기존 설정·훅·백업 식별자를 유지했습니다. 설치 시 관리 대상 규칙과 스킬을 옮기면서 사용자 소유 파일을 덮어쓰지 않는 조건을 테스트했습니다.
기능이 이어지는 흐름
- 저장소에 적용된 계정 확인
폴더·조직 규칙과 저장소 잠금을 바탕으로 작업 계정을 정합니다. preflight로 커밋 작성자와 push 대상이 그 계정에 맞는지 살펴봅니다.
- 변경 선택과 기록
사용자가 올릴 파일을 선택한 뒤 gitch c로 커밋합니다. 실제 커밋 시점의 훅이 계정과 변경 내용을 검사하고, 막힌 이유를 CLI에서 확인할 수 있습니다.
- 동일한 정책으로 원격 작업
gitch p·pl·pr로 원격 전송과 협업을 이어갑니다. 사람이 터미널에서 실행하든 AI 도구가 실행하든 저장소별 계정과 명령 검사 경계를 공유합니다.
- 기존 사용자의 전환 유지
예전 gitsw 호출과 설정을 계속 읽으면서 관리되는 AI 규칙을 새 이름으로 옮깁니다. 기존 사용자 파일과 별도 허용 항목은 보존하는지 확인합니다.
CLI에서 사용하는 명령
기능을 설명하기 위한 사용 예시입니다.
gitch preflight --json- 계정·작성자·원격 대상의 점검 결과를 사람이 확인하거나 도구가 읽을 수 있는 JSON으로 제공합니다.
gitch ck --json- 변경 파일, 전송 전 커밋과 진행 중인 Git 작업 상태를 확인합니다.
gitch c -m "변경 내용"- 선택된 변경을 계정 정책과 훅 검사를 거쳐 커밋하는 진입점입니다.
gitch doctor --no-net- 명령 연결과 로컬 설정 상태를 진단합니다. 예전 이름의 연결이 다른 CLI 복사본을 가리키는 경우도 확인할 수 있습니다.
검증을 위해 남긴 것
- CLI 통합 커밋에 기존 gitsw 호출과 gitch 호출이 같은 실행 파일로 이어지는지 확인하는 호환 테스트를 포함했습니다.
- 사용자가 직접 만든 기존 명령 파일을 덮어쓰지 않는 조건과, 다른 복사본을 가리키는 예전 연결을 진단·갱신하는 조건을 검증했습니다.
- AI 규칙·스킬·훅을 새 이름으로 옮긴 뒤에도 사용자가 추가한 규칙과 허용 항목이 남는지 확인했습니다.
- 새·옛 명령의 동일한 권한 검사와 비밀값 예외 주석의 호환을 확인하는 테스트를 추가했습니다.
이 기여에서 쌓은 경험개발 도구를 통합할 때 기능뿐 아니라 기존 사용자의 설정, 자동화와 전환 경로까지 다뤘습니다. 공통 CLI에 정책을 두고 여러 진입점이 이를 사용하도록 연결하는 경험입니다.
기여 사례 02
Tuist의 구조 가시화에서 대형 그래프 탐색·최적화까지
저장소가 커지면 폴더 목록과 diff만으로는 파일이 어디에 연결되는지, 모듈이 어떤 방향으로 의존하는지 파악하기 어렵습니다. 정적인 import뿐 아니라 실제로 함께 수정되는 파일과 저장소의 크기 분포까지 서로 다른 관점에서 살펴볼 도구가 필요했습니다.

- 관점과 변경 범위파일·모듈·같이 바뀜·폴더를 전환하고, 선택한 변경에서 확인할 영향을 좁힙니다.
- 폴더 안으로 탐색큰 원은 폴더를 요약합니다. 확대하면 안쪽 파일과 연결을 단계적으로 읽을 수 있습니다.
- 질문에 맞는 배치폴더 원·층·의존성 링 등으로 배치를 바꾸고 언어·연결·변경 횟수로 관점을 조정합니다.
제가 기여한 내용
- tuist graph가 타깃 의존성을 그림으로 보여 주는 방식에서 아이디어를 얻어 gitch graph를 구현했습니다. 파일·모듈·함께 변경·폴더라는 네 관계를 CLI의 하위 명령과 공통 그래프 데이터로 제공했습니다.
- TS/JS의 상대 경로와 tsconfig 별칭, reexport·require·동적 import를 비롯해 Python·Go·Rust·Kotlin/Java의 참조를 분석했습니다. Git이 추적하는 파일을 기준으로 삼고 주석·문자열에 적힌 가짜 import는 제외하도록 처리했습니다.
- Tuist 프로젝트도 분석 대상으로 지원했습니다. Project.swift에서 타깃 선언과 .target·.project·.external·.package·.sdk 의존을 읽고, Project.module(...)처럼 도우미 함수로 작성한 매니페스트에서는 파일에 선언된 참조를 수집했습니다.
- 후속 기여에서는 대형 그래프를 폴더 원으로 접고, 확대하거나 클릭할 때 해당 위치에서 내부 파일을 펼치도록 구현했습니다. 닫힌 폴더끼리의 연결은 하나로 집계해 파일과 선이 한꺼번에 몰리는 문제를 줄였습니다.
- 노드 겹침을 해소하는 반복 계산에 시간 예산을 두고 남은 겹침은 순서대로 배치하는 방식으로 마무리했습니다. 줌의 진행률 범위를 보정하고 필터 후 배치를 다시 계산해 탐색이 멈추거나 이전 그림이 남는 조건도 수정했습니다.
- Swift처럼 파일끼리 import하지 않는 언어는 다른 파일에 선언된 타입 이름으로 연결을 추정하고 heuristic 표시를 남겼습니다. 현재 분석기는 Tuist·SwiftPM의 모듈 소속과 접근 범위도 사용하지만, 이를 모든 동적 Swift 코드를 해석하는 컴파일러 분석으로 설명하지는 않습니다.
- 사람이 탐색하는 단일 HTML과 도구가 읽는 JSON을 같은 분석 결과에서 만들었습니다. 화면은 CDN 없이 오프라인으로 열리고, 그림을 공유해야 할 때는 Graphviz를 사용하는 SVG·PNG 출력도 제공했습니다.
기술을 도입한 이유와 구현
- Tuist graph의 가시화 발상 + 매니페스트 분석
도입 이유타깃 간 관계를 그림으로 확인하는 방식을 파일과 여러 언어의 모듈까지 확장하면 변경 검토에 사용할 수 있습니다. Tuist를 사용하는 저장소에서는 실제 Project.swift의 선언을 분석 근거로 삼을 수 있습니다.
구현구조 탐색의 발상을 참고하고 Tuist 매니페스트를 분석 대상으로 지원했습니다. 정적으로 읽을 수 있는 타깃·프로젝트·외부 패키지·SDK를 구분해 nodes/edges로 변환합니다. 임의의 Swift 코드를 실행하지 않으므로 동적으로 만들어지는 선언은 분석 범위에 한계가 있습니다.
- Bash + awk 일괄 분석
도입 이유기존 CLI의 배포 환경을 유지하면서 파일 수가 늘어날 때 파일마다 별도 프로세스를 실행하는 비용을 줄이기 위해서입니다.
구현Git 추적 목록과 소스를 모아 awk로 일괄 분석합니다. 폴더 집계도 Git 객체 정보를 한 번에 읽는 방식으로 구성했습니다. 언어별 참조 규칙을 공통 노드·연결 출력으로 변환합니다.
- 계층형 폴더 원 + 시간 예산을 둔 배치
도입 이유큰 저장소의 파일을 모두 펼치면 노드와 연결이 겹쳐 구조를 읽기 어려워지고, 겹침을 풀기 위한 반복 계산도 화면 조작을 지연시킬 수 있습니다. 전체 윤곽에서 필요한 부분으로 들어가는 탐색과 배치 계산의 종료 조건을 함께 다룰 필요가 있었습니다.
구현폴더 안의 파일·하위 폴더를 원으로 채우는 front-chain packing을 적용하고 확대 수준에 따라 접고 펼치도록 구성했습니다. 닫힌 폴더 사이 연결은 집계해 굵기로 표현합니다. 상자 배치의 반복 충돌 해소에는 시간 예산을 두고, 남은 항목은 위에서 아래로 정리하는 sweep으로 마무리했습니다. 애니메이션 진행률을 유효 범위로 제한해 무거운 계산 뒤의 줌 정지 조건도 수정했습니다.
- 역방향 인접 목록·분석 캐시 + 반복 탐색
도입 이유변경 파일의 선택과 영향 깊이를 바꿀 때마다 모든 연결과 소속 모듈을 다시 찾으면 같은 분석을 반복하게 됩니다. 깊게 연결된 저장소에서는 재귀 호출 한계 때문에 배치나 순환 분석 자체가 중단될 수도 있습니다.
구현변경 영향 분석에 역방향 인접 목록과 큐 탐색을 사용하고, 추정 포함 여부별 그래프·순환 결과와 파일의 소유 모듈을 캐시했습니다. 나무·방사형 배치와 폴더 순환 분석은 명시적인 스택을 사용하는 반복 탐색으로 구성했습니다. 작은 그래프의 기존 배치 순서를 보존하면서 긴 의존 체인도 처리하도록 검증했습니다.
- 공통 JSON 계약 + 독립된 HTML/JavaScript 화면
도입 이유AI와 자동화에는 구조화된 데이터가, 사람에게는 탐색 가능한 화면이 필요합니다. 같은 분석을 두 경로로 제공하면 플랫폼마다 구조 분석 화면을 별도로 구현하는 부담을 줄일 수 있습니다.
구현스크립트·AI에는 JSON을, 사람이 사용하는 터미널에는 HTML을 기본 출력으로 제공합니다. 생성 HTML은 macOS와 Windows에서 같은 웹 결과물로 열 수 있으며, 현재 브라우저 테스트는 이 화면의 레이아웃·필터·선택과 오프라인 동작을 검증합니다.
- 정적 참조와 변경 이력의 구분
도입 이유함께 바뀐 파일이 반드시 코드로 서로 참조하는 것은 아닙니다. 각 연결이 무엇을 근거로 만들어졌는지 구분해야 구조를 잘못 해석하지 않습니다.
구현files는 소스 참조, modules는 모듈 선언, changes는 Git 이력, tree는 폴더 포함 관계를 나타냅니다. 타입 이름으로 추정한 연결은 heuristic으로 구분하고, 함께 변경된 횟수는 정적 의존의 증명으로 사용하지 않습니다.
| 관점 | 분석 근거 | 검토할 수 있는 내용 |
|---|---|---|
| files · 파일 참조 | 소스의 import·use·mod와 일부 언어의 타입 이름 | 이 파일이 무엇을 사용하는지 확인합니다. 타입 이름에 따른 추정 연결은 별도로 표시합니다. |
| modules · 모듈 의존 | Project.swift·Package.swift·package.json·Cargo.toml·go.mod·Gradle | 타깃·작업공간·패키지의 경계와 내부·외부 의존 방향을 확인합니다. |
| changes · 함께 변경 | Git 이력에서 한 커밋에 같이 바뀐 파일 쌍과 횟수 | 같이 검토할 후보와 자주 수정되는 파일을 찾습니다. 코드 참조와는 다른 관측입니다. |
| tree · 폴더 구조 | Git 추적 파일과 크기·파일 수 집계 | 저장소의 규모와 분포를 폴더 단위로 축약해 확인합니다. |
기능이 이어지는 흐름
- 살펴볼 관계와 범위 선택
파일·모듈·함께 변경·폴더 중 질문에 맞는 관점을 고릅니다. 폴더와 언어 필터를 사용해 분석 범위를 줄이고 필요한 연결에 집중합니다.
- 서로 다른 근거를 그래프 데이터로 변환
소스의 import, 프로젝트 매니페스트, Git 커밋과 추적 파일 목록에서 노드와 연결을 만듭니다. 파일 밖 패키지와 추정한 참조도 구분해 기록합니다.
- 같은 결과를 화면과 자동화에서 사용
사람은 오프라인 HTML에서 탐색하고, AI·스크립트는 JSON을 읽습니다. macOS와 Windows가 공통 웹 결과물을 사용하므로 그래프 탐색 동작을 같은 브라우저 화면에서 확인할 수 있습니다.
- 분석의 근거와 한계 확인
정적인 import인지, 선언된 모듈 의존인지, 이름으로 추정한 연결인지 확인합니다. 함께 수정된 파일은 실제 코드 의존과 구분해 변경 검토의 참고 자료로 사용합니다.
CLI에서 사용하는 명령
기능을 설명하기 위한 사용 예시입니다.
gitch graph files --json- 파일 간 참조를 도구가 읽는 노드·연결 데이터로 확인합니다.
gitch graph modules --json- Tuist·SwiftPM·npm·Cargo 등 프로젝트 선언에 기반한 모듈 의존을 확인합니다.
gitch graph changes --since "6 months ago" --json- 선택한 기간에 함께 변경된 파일 쌍과 변경 횟수를 확인합니다.
gitch graph tree --depth 2 --json- 지정한 깊이의 폴더 구조와 파일 수·크기를 살펴봅니다.
gitch graph --format html --out structure.html- 같은 분석을 브라우저에서 탐색할 수 있는 오프라인 한 페이지로 만듭니다.
검증을 위해 남긴 것
- 최초 구조 그래프 기여에 TS 경로 별칭·주석 제외·미추적 파일 제외, Python·Go·Rust·Kotlin/Java 참조와 Swift의 추정 표시를 검증하는 CLI 테스트를 포함했습니다.
- Tuist의 타깃·프로젝트·외부 패키지·SDK 의존과 Project.module 도우미 매니페스트, SwiftPM의 정적 분석과 describe 경로를 확인하는 테스트를 작성했습니다.
- npm 작업공간·Cargo·Go·Gradle 모듈, 함께 변경 횟수와 대규모 커밋·lock 파일 제외, 폴더 집계와 출력 형식을 검증했습니다.
- 폴더 원과 배치 최적화 후속 기여에서 생성 HTML을 헤드리스 Chrome으로 열어 화면 오류, 배치별 노드 겹침과 PNG 저장을 확인하는 회귀 검증을 추가했습니다.
- 깊은 구조 탐색의 후속 테스트는 15,000개 노드의 의존 체인에서 나무·방사형 좌표가 모두 유효한지 확인하고, 작은 그래프의 기존 좌표와 순서를 보존하는지 비교합니다. 이 수치는 테스트 입력 규모입니다.
- 현재 프로젝트에는 생성 HTML의 레이아웃·언어 필터·선택·PNG 저장과 외부 요청 없는 동작을 확인하는 브라우저 테스트가 있습니다. 이 후속 검증 구성은 최초 커밋의 CLI 테스트 범위와 구분합니다.
이 기여에서 쌓은 경험구조 분석 CLI의 구현부터 큰 그래프의 배치·반복 계산·깊은 탐색까지 개선했습니다. 개발자의 화면 탐색과 AI의 데이터 활용을 같은 결과로 연결하고, 속도뿐 아니라 읽을 수 있는 배치와 조작이 이어지는 조건까지 다룬 경험입니다.
기여 사례 03
로컬 검사부터 원격 CI의 실행 이력과 로그까지
코드를 확인하는 과정은 로컬 테스트에서 끝나지 않습니다. GitHub Actions·GitLab 파이프라인·Jenkins의 실행 상태와 실패한 작업의 로그를 확인하고, PR·MR의 검토 내용으로 다시 돌아와야 합니다. 서비스마다 다른 실행 의미를 유지하면서도 현재 어떤 작업을 보고 있는지 놓치지 않는 공통 작업공간이 필요했습니다.

제가 기여한 내용
- macOS·Windows의 파이프라인과 PR·MR 작업공간을 함께 개선했습니다. 실행 상태를 텍스트로 명시하고, 실제로 불러온 작업을 단계별로 묶어 선택한 작업과 로그가 연결되도록 구성했습니다. PR·MR의 대화·변경 파일·검사 탭을 오가도 댓글 초안, 메타데이터 편집과 이미 읽은 검사 내용을 유지하도록 보완했습니다.
- Flow의 시각적 편집과 Connected CI 개발에 기여했습니다. 로컬 흐름 이력 옆에서 저장소의 GitHub Actions·GitLab 실행과 기존 제어 기능을 확인하고, 이름을 붙인 Jenkins 연결에서는 폴더·작업·빌드 이력·로그를 탐색할 수 있도록 연결했습니다.
- 앱의 시각적 편집이 공유 Rust 엔진의 YAML 해석과 JSON 계약을 사용하도록 구성했습니다. GitHub Actions·GitLab YAML과 Jenkins 원본을 보존하고, 원격 실행은 해당 workflow·pipeline·job을 호출하는 별도 ci.* 단계로 제안했습니다. 외부 CI의 조건·러너·배포 정책을 임의의 로컬 명령으로 바꾸지 않도록 경계를 두었습니다.
- 연결 정보, 허용 작업 범위와 비밀값 참조를 실행 코드와 구분했습니다. Jenkins 탐색에도 연결의 허용 목록을 적용하고, 로그 크기 제한과 비밀값 마스킹, 다른 출처로 이동할 때 인증 헤더를 보내지 않는 조건을 구현했습니다.
기술을 도입한 이유와 구현
- 공유 Rust 엔진의 YAML·JSON 계약
도입 이유두 앱이 설정을 따로 해석하면 같은 파일이 서로 다른 실행 계획으로 보일 수 있습니다. 시각적 편집을 도입하더라도 원본의 고급 설정과 실행 의미를 보존해야 했습니다.
구현읽기 전용 inspect·render 계약으로 소스와 모듈을 변환하고, 알려지지 않은 필드와 지원 범위를 진단합니다. 파일 가져오기는 원본을 확인한 뒤 별도 소스로 저장하며, 파일을 바꾸는 동작과 실행 신뢰 승인을 분리했습니다.
- CI 제공자의 실행 의미를 유지하는 연결 모듈
도입 이유Actions의 표현식, GitLab의 조건, Jenkins 플러그인을 모두 로컬 셸 명령으로 재현하면 실제 서버와 다른 결과가 생길 수 있습니다. CI가 소유한 설정은 그 제공자가 실행하도록 해야 했습니다.
구현ci.github.workflow·ci.gitlab.pipeline·ci.jenkins.job 등으로 원본 workflow와 job을 호출합니다. 실행은 Flow의 신뢰·취소·판정·운영 환경 보호를 거치며, 가져온 외부 CI 제안의 연결은 사용자가 명시적으로 지정하도록 비워 둡니다.
- 선택 상태를 유지하는 작업·로그 탐색
도입 이유실패 원인을 찾는 동안 탭을 바꿀 때 초안이나 선택한 로그가 사라지면 검토 맥락을 다시 만들어야 합니다. 작은 창에서도 작업 목록과 로그를 각각 읽을 공간이 필요했습니다.
구현실제 로드한 작업의 상태 요약과 단계별 목록을 제공하고 선택한 작업의 로그를 함께 유지합니다. PR·MR의 탭 전환과 diff 왕복에서도 편집 상태를 보존하며, 화면 폭·테마·키보드 이동을 회귀 검사에 포함했습니다.
기능이 이어지는 흐름
- 설정과 실행 대상을 확인
기존 흐름이나 CI 원본을 읽고, 의존 관계·입력·연결·대상 workflow와 job을 확인합니다. 원본과 설정을 검토한 뒤 실행에 필요한 승인과 보호 조건을 적용합니다.
- 실행에서 실패한 작업으로 이동
로컬 실행 이력과 Connected CI에서 실행 상태를 살펴보고, 단계별 작업을 선택해 해당 로그를 확인합니다. Jenkins는 허용된 폴더·작업·빌드만 탐색하고 로그는 제한된 크기로 마스킹해 제공합니다.
- 검토 맥락을 유지하며 수정
PR·MR의 대화·변경 파일·검사 화면을 오가며 실패 원인과 코드 변경을 연결합니다. 작성 중인 댓글과 메타데이터, 선택한 검사·로그를 보존해 검토를 이어갑니다.
CLI에서 사용하는 명령
기능을 설명하기 위한 사용 예시입니다.
gitch ci status- 현재 저장소의 원격 CI 상태를 터미널에서 확인합니다.
gitch ci logs- 앱의 CI 탐색과 연결되는 원격 실행 로그를 확인합니다.
gitch flow connect test ci- ci라는 이름으로 저장한 연결을 읽기 전용으로 점검합니다. 실제 이름은 등록한 연결에 맞춥니다.
검증을 위해 남긴 것
- 본인 작성 커밋으로 파이프라인·PR 작업공간 개선과 시각적 Flow·Connected CI 구현을 확인했습니다. 테스트 범위에는 탭 전환 후 초안·로그 유지, 타임스탬프, 키보드 이동, 단계 선택과 반응형 화면이 포함됩니다.
- 공유 엔진에는 YAML 원본 보존, 알 수 없는 필드, 외부 CI 제안, Jenkins 탐색과 허용 목록, 마스킹·다른 출처의 인증 헤더 처리에 대한 회귀 테스트를 추가했습니다. 앱에서는 격리된 Jenkins fixture와 실제 Rust 설계 계약을 사용해 화면을 확인했습니다.
- 합성 데이터로 macOS 네이티브 화면과 Windows의 실제 React 화면을 여러 폭과 밝은·어두운 테마에서 검증했습니다. 실제 GitHub·GitLab·Jenkins 배포와 계정별 쓰기 권한은 별도의 실제 환경 검증 범위로 남겼습니다.
이 기여에서 쌓은 경험CI 결과를 보여 주는 화면과 그 아래의 실행 계약을 함께 다뤘습니다. 여러 제공자의 차이를 유지하면서 실행·작업·로그·코드 검토를 연결하고, 사용자가 작업 맥락을 잃지 않도록 상태와 실패 경로를 설계하는 경험을 제공할 수 있습니다.
기여 사례 04
프로젝트의 할 일과 일정에서 실제 Git 작업까지
이슈 목록, 일정과 코드 작업이 따로 있으면 오늘 확인할 일과 실제 개발을 연결하기 어렵습니다. GitHub 프로젝트의 날짜·상태를 다시 복제하지 않고 Home·캘린더·보드에서 같은 작업을 보여 주면서, 계정이 없는 상황에서도 로컬 계획을 사용할 수 있어야 했습니다. 일정 변경과 여러 항목 저장에서는 동시 편집과 일부만 저장된 결과도 다뤄야 했습니다.

제가 기여한 내용
- GitHub 계획과 작업 상세를 로컬 브랜치·PR 작업으로 연결하는 통합 프로젝트 작업공간에 기여했습니다. Home에서 여러 프로젝트를 모아 기한 초과·오늘·다음 7일·미지정·완료 작업을 살펴보고, Overview·Calendar·Board·Table·Roadmap으로 같은 할 일을 탐색하도록 구성했습니다.
- GitHub Projects의 시작일·마감일·상태 필드를 사용자가 고르게 하고, 완료로 해석할 상태를 명시하도록 구현했습니다. 일정은 별도 작업 DB에 복제하지 않고 선택한 프로젝트 필드에 저장합니다. 캘린더에서 날짜를 옮기면 시작일과 마감일의 간격을 유지하며 변경안을 확인한 뒤 저장하도록 했습니다.
- 로컬 프로젝트 생성과 지속 저장을 추가했습니다. 계정·토큰 없이 같은 계획 화면을 사용하되 로컬 데이터는 앱의 전용 저장 위치에 둡니다. 버전이 있는 JSON 문서, 운영체제 파일 잠금, 비교 후 저장과 원자적 교체로 오래된 편집이나 손상된 데이터가 기존 작업을 조용히 덮어쓰지 않도록 구현했습니다.
- 조직 프로젝트를 저장소를 열지 않고 선택하고 Home에서 Projects로 이동해도 범위를 유지하도록 확장했습니다. 프로젝트 항목을 모든 페이지에서 읽은 뒤 표시하고, 반복·누락 커서와 계정 변경을 검사했습니다. 갱신 실패 시 기존에 읽은 작업을 보존하고 오래된 데이터임을 표시하도록 보완했습니다.
- 보드 열 안의 빠른 작업 추가, 상태·우선순위·담당자·날짜 편집과 연결 이슈의 대화를 양쪽 앱에서 다뤘습니다. 중복 제출 방지, 실패한 입력 보존과 지연된 응답이 다른 작업의 초안을 지우지 않는 조건을 함께 구현했습니다.
기술을 도입한 이유와 구현
- GitHub Projects 필드를 기준으로 한 일정 모델
도입 이유별도의 일정 DB를 만들면 프로젝트와 캘린더가 서로 다른 날짜·완료 상태를 가질 수 있습니다. 프로젝트마다 필드 이름과 완료 기준이 다르므로 이를 명시적으로 연결해야 했습니다.
구현선택한 시작일·마감일·상태 필드를 모든 일정 화면에서 공유합니다. 날짜 이동 전 서버의 현재 값을 확인하고, 동시 변경이면 새로 읽도록 안내합니다. 여러 필드 중 일부만 저장됐을 가능성이 있으면 갱신이 성공할 때까지 추가 쓰기를 제한합니다.
- 버전 문서·파일 잠금·원자적 저장의 로컬 계획
도입 이유계정 접근이나 네트워크를 기다리지 않고 계획을 작성할 수 있어야 합니다. 동시에 여러 창이 같은 로컬 프로젝트를 편집하거나 저장 문서를 읽지 못하는 상황에서 데이터가 사라지지 않아야 했습니다.
구현로컬 프로젝트는 HTTP·계정 자격 증명 경로를 거치지 않고 앱의 전용 디렉터리에 저장합니다. 읽은 버전과 저장 시점을 비교하고 파일 잠금과 원자적 교체를 사용합니다. 여러 작업 편집과 날짜 범위 이동은 함께 저장하며 손상된 문서를 빈 프로젝트로 간주하지 않습니다.
- 완전한 항목 스냅샷과 계정·프로젝트 경계
도입 이유첫 페이지만 보여 주면 뒤쪽 이슈·초안·완료 항목이 없는 것처럼 보이고 일정 요약도 달라집니다. 긴 요청 중 계정이나 프로젝트를 바꾼 경우 다른 범위의 결과가 현재 화면에 들어오지 않아야 했습니다.
구현프로젝트 항목의 모든 커서를 따라가고 항목 ID를 중복 제거한 뒤 스냅샷을 게시합니다. 매 페이지에서 시작한 계정·프로젝트를 확인하고 잘못된 커서를 부분 성공으로 처리하지 않습니다. 일정 요약과 전체 목록을 함께 제공하며 갱신 실패 시 이전 스냅샷을 보존합니다.
| 출처 | 일정과 작업 | 저장과 연결 |
|---|---|---|
| GitHub Projects | 프로젝트 날짜·상태 필드로 Home·캘린더·보드 연결 | 서버 프로젝트가 기준 · 계정·조직 권한 확인 |
| 로컬 프로젝트 | 계정 없이 같은 계획 화면과 할 일 편집 | 앱 전용 로컬 문서 · 장치 간 동기화 없음 |
| GitLab 보드 | 기존 Board·Table·Roadmap과 그룹 이슈 탐색 | GitLab 그룹·프로젝트 범위 · GitHub 일정과 구분 |
기능이 이어지는 흐름
- 프로젝트를 고르고 오늘의 일을 정리
로컬 계획 또는 연결한 GitHub 계정·조직의 프로젝트를 선택합니다. Home은 여러 프로젝트의 작업을 모아 중복 이슈를 구분하고 기한·담당자·검색 조건으로 확인할 일을 보여 줍니다.
- 일정을 조정하고 상태를 확인
Overview에서 실제 작업 수와 마감을 살펴보고 월·주 캘린더에서 날짜와 범위를 조정합니다. 미지정 일정과 잘못된 날짜도 드러내며, 저장 전 대상 필드와 동시 변경 여부를 확인합니다.
- 작업 상세에서 개발과 협업으로 이동
같은 작업을 보드·표·로드맵과 상세 화면에서 열고 브랜치·PR 동작으로 이어갑니다. 연결 이슈의 설명·대화를 읽고 댓글을 작성하며, 실패한 입력과 진행 중인 편집 맥락을 유지합니다.
검증을 위해 남긴 것
- 본인 작성 커밋으로 통합 계획 작업공간, 로컬 일정·저장·작업 협업, 조직 범위 선택과 프로젝트 항목 완전 조회를 확인했습니다. 공개 변경은 macOS와 Windows에 함께 반영했습니다.
- 일정 필드·완료 상태·날짜 범위·동시 편집, 원자적 로컬 생성과 부분 저장, 중복 제출·실패 입력 보존을 회귀 검사에 포함했습니다. 네이티브·브라우저 fixture는 격리된 설정과 합성 계정·프로젝트 데이터를 사용했습니다.
- 전체 항목 조회는 여러 페이지의 이슈·초안·보관·접근 제한 항목, 중복·빈 페이지, 잘못된 커서, 계정 변경과 생성·편집 후 재조회 조건을 검사했습니다. 실제 연결 프로젝트에서는 읽기 전용 동작을 확인했습니다.
이 기여에서 쌓은 경험일정 화면을 추가하는 작업을 넘어 데이터의 기준, 오프라인 저장, 원격 동시 편집과 목록 완전성을 함께 다뤘습니다. 사용자가 계획한 일을 실제 Git 작업으로 옮기는 과정에서 화면·API·지속 저장·실패 복구를 끝까지 연결할 수 있습니다.
기여 사례 05
Flow · 실행 계획부터 테스트 판정까지 연결한 CLI
검사 명령이 정상 종료돼도 필요한 테스트가 실제로 실행됐다고 단정할 수는 없습니다. 보고서가 이전 실행의 것이거나 종료 코드와 서로 다른 결과를 가리킬 수도 있습니다. 앱·터미널·CI에서 같은 검사를 반복하는 환경에서는 실행 순서뿐 아니라 성공을 판단하는 기준도 함께 공유해야 했습니다.

제가 기여한 내용
- gitch flow와 gitch test의 실행 계층인 Rust gitch-flow 엔진 개발에 기여했습니다. YAML 해석, DAG 계획, 실행, 결과 관측과 판정을 분리하고 앱·CLI가 같은 JSON 계약을 사용하도록 구성했습니다.
- 의존 관계에 따른 병렬 실행, 자원 잠금, fail-fast와 실패 분기를 구현했습니다. 취소 시에는 실행 명령뿐 아니라 하위 프로세스까지 정리하도록 처리했습니다.
- 보고서 존재 여부, 실제 실행한 테스트 수, 통과율과 종료 상태를 함께 판정했습니다. 검사 누락과 판정 불가를 통과로 숨기지 않고 오류 코드와 관측 근거를 남겼습니다.
- 흐름 파일의 신뢰 승인, 실행 기록 서명과 로그 비밀값 마스킹을 포함했습니다. 사람이 승인한 뒤에도 흐름 내용이 바뀌면 다시 검토하도록 연결했습니다.
기술을 도입한 이유와 구현
- Rust 실행 엔진 · JSON / NDJSON 계약
도입 이유앱·터미널·CI가 실행과 판정 로직을 각각 가지면 같은 흐름에서도 결과 해석이 달라질 수 있습니다. 여러 환경에서 호출할 수 있는 하나의 실행 계층이 필요했습니다.
구현gitch는 명령 진입점을 맡고 gitch-flow가 계획·실행·판정을 담당합니다. 앱은 JSON 결과와 NDJSON 이벤트를 읽어 표시하며, 엔진의 판정을 다시 계산하지 않습니다. 실행 기록은 worktree별로 분리합니다.
- YAML 명세 · DAG 계획 · 영향 기반 선택
도입 이유검사 순서와 병렬 실행 가능 여부를 명시하면서, 실행 전에 무엇을 왜 돌리거나 생략하는지 설명할 수 있어야 했습니다.
구현행 번호를 보존한 YAML을 typed spec으로 읽고 needs, 복합 블록, 하위 흐름과 실패 분기를 DAG로 펼칩니다. plan이 만든 계획을 run에서도 사용합니다. 영향받은 테스트를 확신할 수 없거나 설정·의존 파일이 바뀌면 전체 실행으로 넓히고 이유를 기록합니다.
- 테스트 보고서 관측 · 순수 판정 함수
도입 이유명령 실행과 성공 판정은 서로 다른 문제입니다. 종료 코드 하나만 확인하면 0개 테스트 실행, 오래된 보고서와 결과 모순을 놓칠 수 있습니다.
구현실행기와 보고서 파서가 관측값을 만들고 verify가 그 값으로 PASS·FAIL·INDETERMINATE를 결정합니다. 최소 실행 수는 적어도 1개이며, 근거가 없거나 판정할 수 없는 경우도 성공으로 처리하지 않습니다.
- 해시 기반 신뢰 · 서명 기록 · 제한된 결과 캐시
도입 이유저장소의 검사 설정은 명령을 실행할 수 있으므로 파일을 바꾼 주체가 스스로 승인해서는 안 됩니다. 이전 실행을 재사용할 때도 입력과 외부 상태의 차이를 구분해야 했습니다.
구현사람이 승인한 흐름 파일 해시를 저장하고 변경 시 신뢰를 해제하며 AI의 승인 호출을 거부합니다. 실행 기록을 HMAC으로 서명하고 이벤트·로그를 마스킹합니다. 캐시는 입력을 선언한 순수 노드의 통과 결과만 사용하고 네트워크·서비스·외부 변경이 있는 노드는 제외합니다.
| 관측한 상황 | 판정과 이유 |
|---|---|
| 정상 종료 · 테스트 실행 0개 | 실패 · TEST-03. 실행하지 않은 검사를 통과로 처리하지 않습니다. |
| 보고서 없음 · 이전 실행의 보고서 | 판정 불가 또는 실패. 이번 실행을 설명하는 근거가 필요합니다. |
| 종료 코드와 보고서 결과가 모순 | 통과하지 않음. 두 관측값의 일치를 확인합니다. |
| 유효한 보고서 · 실행 수와 통과율 충족 | 다른 필수 판정도 충족했을 때 통과합니다. |
기능이 이어지는 흐름
- 명세를 읽고 계획을 확인
.gitch/flow.yml을 검증하고 의존 관계를 펼칩니다. 실행·생략·거절 대상과 영향받은 테스트를 선택한 이유를 plan에서 확인합니다.
- 신뢰와 실행 조건 점검
승인된 파일 해시와 연결·환경 조건을 확인합니다. 미신뢰 흐름은 사람이 검토하며, AI가 승인이나 보호 장치를 해제하지 못하도록 구분합니다.
- 의존 순서에 따라 실행
준비된 노드를 병렬 실행하고 잠금과 실패 분기를 적용합니다. 취소·시간 초과 시 하위 프로세스도 함께 정리해 실행 상태가 남지 않도록 다룹니다.
- 실행 결과를 관측하고 판정
실행기가 수집한 종료 상태와 이번 실행의 테스트 보고서를 대조합니다. 보고서 유효성, 실제 테스트 수와 통과율을 확인하고 관측 근거에 따라 결과를 결정합니다.
- 근거를 기록하고 같은 결과 공유
계획·이벤트·로그·보고서를 worktree별 실행 기록에 남깁니다. 앱·CLI·CI가 이 계약을 공유해 어떤 검사를 수행했고 왜 실패했는지 추적할 수 있게 합니다.
CLI에서 사용하는 명령
기능을 설명하기 위한 사용 예시입니다.
gitch flow plan pre-push --affected- 변경에 영향받은 검사와 실행·생략 이유를 먼저 확인합니다.
gitch test --affected --summary- 영향받은 테스트를 실행하고 간결한 판정 근거를 받습니다.
gitch flow run pre-push --summary- 정의한 검사 흐름을 의존 순서에 따라 실행합니다.
gitch flow report last- 마지막 실행의 관측값과 결과를 다시 확인합니다.
검증을 위해 남긴 것
- 임시 저장소와 격리된 HOME에서 실제 CLI를 호출하는 통합 테스트를 추가했습니다. 미신뢰 흐름 거부, AI의 승인 거부와 파일 변경 후 신뢰 해제를 다룹니다.
- 0개 테스트, 오래된 보고서, 실패 분기, 서명된 결과와 전체 프로세스 트리 취소를 검증하는 테스트를 포함했습니다.
- 영향 기반 테스트 선택과 입력 변경에 따른 캐시 무효화, 서비스·네트워크 노드의 캐시 제외를 확인하는 검증을 남겼습니다.
이 기여에서 쌓은 경험개발 자동화를 명령 실행에서 끝내지 않고 계획·관측·판정·기록으로 연결한 경험입니다. CLI와 제품 화면이 같은 결과를 공유하도록 계약을 설계하고, 검사 누락과 실패를 설명할 수 있는 근거를 남기는 데 기여했습니다.
기여 사례 06
Ledger · AI 작업의 기준과 반영 상태를 기록하는 CLI·MCP
여러 AI 대화가 서로 다른 기준 버전에서 작업하면 완료 보고와 실제 반영 상태가 흩어집니다. 무엇을 만들었는지뿐 아니라 어떤 기준에서 시작했고, 누가 확인했으며, 어느 버전에 반영됐는지를 함께 기록해야 했습니다. 동시에 에이전트의 보고가 사람의 답변이나 최종 확인을 대신하지 않도록 권한을 구분할 필요가 있었습니다.

제가 기여한 내용
- 세션의 기준 버전, 진행 보고, 질문, 산출물과 반영 상태를 기록하는 Rust Ledger 코어·CLI·MCP 서버 개발에 기여했습니다.
- 상태·판정과 보고 규칙을 공통 코어에 두고 C ABI, CLI와 MCP가 하나의 dispatcher를 사용하도록 구성했습니다. 여러 진입점이 같은 기록과 계약을 다루게 했습니다.
- 사용자별 SQLite 데이터베이스에 공통 쓰기 경계와 트랜잭션을 적용했습니다. 앱·CLI·여러 MCP 프로세스의 동시 접근, 스키마 변경과 백업을 함께 다뤘습니다.
- 에이전트는 보고하고 사람은 답변·확인·정리하도록 호출 권한을 나눴습니다. 사람의 메시지는 해당 세션에 한 번만 전달하고, 단순 조회가 메시지를 소비하지 않도록 구분했습니다.
기술을 도입한 이유와 구현
- Rust 공통 코어 · C ABI · CLI · MCP
도입 이유앱과 에이전트가 별도 규칙으로 상태를 수정하면 완료·질문·반영에 대한 해석이 달라집니다. 접근 방법이 달라도 기록과 판정의 주체는 같아야 했습니다.
구현api dispatcher를 C ABI와 gitrochi-ledger CLI, stdio JSON-RPC MCP 서버가 공유합니다. MCP에는 overview·report·session 도구를 제공하고 JSON Schema와 계약 문서로 입출력 범위를 명시했습니다.
- 기준 버전 · 세션 이벤트 · 공통 상태 판정
도입 이유작업 완료와 제품 반영은 다른 상태입니다. 오래된 기준에서 수행한 작업이나 아직 결정이 필요한 질문을 완료 표시 뒤에 숨기지 않아야 했습니다.
구현start에 기준과 touches를 기록하고 산출물·질문·done·merged·release를 구분합니다. 저장된 상태와 열린 질문 등으로 화면용 판정을 계산합니다. 지속 구현은 sync→작업→applied 주기로 연결하며, 종료된 세션에 새 작업이 오면 재개하고 이전 확인을 해제합니다.
- SQLite WAL · 공통 쓰기 경계 · revision
도입 이유여러 에이전트와 앱이 같은 기록을 읽고 쓰므로 동시 접근 시 보고 유실과 서로 다른 읽기 시점을 다뤄야 했습니다. 별도 서버 없이 로컬 프로세스가 같은 데이터를 사용할 수 있어야 했습니다.
구현모든 쓰기를 같은 Rust 경로의 BEGIN IMMEDIATE 트랜잭션으로 처리하고 WAL과 15초 busy timeout을 적용했습니다. 쓰기와 meta.rev 증가를 함께 커밋하며 읽기는 하나의 스냅샷을 사용합니다. user_version 기반 추가형 마이그레이션을 두고 더 새 스키마에는 이전 빌드가 쓰지 않도록 했습니다.
- 사람·에이전트 권한 구분 · 한 번만 전달
도입 이유에이전트가 남긴 완료 보고를 스스로 승인하거나 사람의 답변을 대신하면 기록의 의미가 흐려집니다. 반대로 답변이 중복 전달되면 같은 지시를 반복 수행할 수 있습니다.
구현CLI·MCP는 사람 전용 확인·답변·설정 호출을 거부합니다. 사람의 메시지 수신과 전달 표시를 한 트랜잭션에서 처리해 해당 세션에 한 번만 전달합니다. 앱의 조회와 명시적인 전달을 구분하고, sync·applied의 정해진 hand-off만 별도 계약으로 다뤘습니다.
| 기록 | 의미와 후속 판단 |
|---|---|
| start · base · touches | 어느 기준에서 어떤 범위를 작업하는지 남깁니다. |
| artifact · question | 만든 결과와 사람의 결정이 필요한 항목을 남깁니다. |
| done | 작업 완료 보고입니다. 반영 여부는 별도로 남습니다. |
| merged · release · applied | 반영된 기준과 적용 관계를 기록합니다. |
| 사람의 답변 · 확인 · 보관 | 사람이 수행하며 CLI·MCP의 에이전트 호출과 구분합니다. |
기능이 이어지는 흐름
- 최신 기준과 동시 작업 확인
overview에서 프로젝트의 기준 버전과 열려 있는 작업을 확인합니다. 세션의 시작 기준, 최신 기준과의 차이, touches가 겹치는 작업을 함께 살핍니다.
- 시작 기준과 작업 범위 등록
start에 프로젝트·작업 종류·제목·기준 버전·변경 범위를 남깁니다. 이후 보고를 같은 세션 ID에 연결해 대화의 작업 이력을 이어 갑니다.
- 산출물과 판단이 필요한 질문 보고
이정표마다 산출물과 버전, 본문과 질문을 기록합니다. 단순 진행 로그와 사람이 결정해야 할 질문을 구분해 후속 작업의 근거를 남깁니다.
- 사람의 답변을 세션에 전달
사람이 앱에서 답변·확인합니다. 해당 세션의 다음 보고나 명시적 수신이 답변을 한 번만 가져오며, 화면에서 읽어 보는 행동은 전달 상태를 바꾸지 않습니다.
- 완료와 실제 반영 연결
done으로 작업 완료를 보고한 뒤 반영 여부를 별도로 다룹니다. release·merged·sync·applied로 기준 버전과 구현의 연결을 남겨 완료 보고를 실제 적용으로 오해하지 않게 합니다.
CLI에서 사용하는 명령
기능을 설명하기 위한 사용 예시입니다.
gitrochi-ledger overview -p "Example App"- 기준 버전과 열려 있는 작업의 상태를 확인합니다.
gitrochi-ledger report -p "Example App" -e start -k implementation -t "CLI validation" -b 1.4.2 --touches tools/gitch- 시작 기준과 변경 범위를 세션에 등록합니다.
gitrochi-ledger report -s S1031-02 -e artifact -m "Validation report" -a "report@1.4.2#r1"- 어떤 기준에서 만든 어떤 개정의 산출물인지 기록합니다.
gitrochi-ledger session S1031-02 --deliver- 자신의 세션에 도착한 사람의 답변과 메시지를 수신합니다.
gitrochi-ledger mcp- 외부 에이전트가 같은 코어를 사용하는 MCP 서버를 시작합니다.
검증을 위해 남긴 것
- 상태 판정 순서, 종료 세션 재개, 기준 버전과 hand-off, 질문과 한 번만 전달 규칙을 다루는 테스트를 추가했습니다.
- SQLite 마이그레이션과 쓰기 중 백업, 스레드·실제 다중 프로세스의 동시 쓰기를 검증했습니다. 여러 MCP 서버와 CLI가 함께 보고할 때 ID 중복과 보고 유실, revision 증가를 확인하는 테스트를 포함했습니다.
- C ABI와 C·C++ 헤더, CLI와 MCP의 실제 프로세스 왕복 호출, JSON Schema를 검증하는 테스트를 남겼습니다. CLI의 사람 전용 호출 거부도 확인합니다.
이 기여에서 쌓은 경험AI 기능을 대화 이력으로만 남기지 않고 기준·산출물·질문·반영 상태로 연결한 경험입니다. CLI·MCP·앱의 공통 계약과 동시 쓰기를 다루며, 에이전트의 보고와 사람의 최종 판단이 각각 의미를 유지하도록 기여했습니다.
기여 사례 07
한 번 만든 분석 결과를 두 플랫폼과 웹에서 검증하기
Gitrochi는 macOS의 SwiftUI 앱과 Windows의 React·Tauri 앱을 함께 제공합니다. 화면과 운영체제 연동 방식이 달라 같은 분석 기능을 따로 구현하면 결과와 사용 흐름이 어긋날 수 있습니다. CLI의 구조 분석 결과를 두 앱에서 재사용하고, 운영체제별 앱을 설치하기 전에도 실제 화면을 확인할 수 있는 경계가 필요했습니다.

제가 기여한 내용
- CLI가 계산한 파일·모듈·변경 관계를 JSON과 독립적인 HTML로 제공하는 구조에 기여했습니다. 앱에서는 번들에 포함된 gitch로 HTML을 생성해 기본 브라우저에서 열고, 터미널에서도 같은 결과를 탐색할 수 있도록 연결했습니다.
- 공유 그래프 화면의 탐색·폴더 선택·경로 동작을 보완하고, Chrome에서 실제 HTML을 조작하는 회귀 테스트를 개선했습니다. 페이지 이동 직후의 고정 대기를 해당 문서의 URL과 로딩 완료 확인으로 바꾸어, 느린 실행기에서 아직 읽지 못한 화면을 실패로 판정하거나 이전 화면의 테스트 상태를 잘못 읽는 문제를 줄였습니다.
- 제품의 Windows 프런트엔드는 실제 React 컴포넌트를 브라우저에서도 실행하고 파일·프로세스·네트워크 호출을 대체하는 검증 구조를 사용합니다. 이 구조에서는 macOS의 Chrome에서도 화면 상태와 버튼 동작을 점검할 수 있습니다. 저의 직접 기여는 공개 커밋으로 연결한 CLI 그래프·탐색·브라우저 회귀 개선을 중심으로 구분했습니다.
기술을 도입한 이유와 구현
- JSON 계약과 오프라인 HTML
도입 이유분석 결과를 사용하는 주체가 앱, 터미널, 자동화 도구로 나뉩니다. 분석을 다시 구현하지 않고도 사람이 탐색하는 화면과 도구가 읽는 데이터를 같은 결과에서 제공할 수 있어야 했습니다.
구현gitch graph가 노드·연결 데이터를 JSON으로 내보내고, 같은 분석을 독립적인 HTML 문서로 제공합니다. HTML은 외부 서비스 없이 열리며 macOS·Windows 앱과 CLI에서 같은 그래프 UI를 사용할 수 있습니다.
- React 화면과 시스템 호출의 경계
도입 이유운영체제 연동을 포함한 앱 전체를 매번 실행해야만 화면을 확인할 수 있다면 여러 상태와 화면 크기를 반복 점검하기 어렵습니다. 실제 사용자 화면을 유지하면서 외부 동작을 통제할 수 있는 검증 환경이 필요합니다.
구현Windows 앱은 React 화면과 Tauri 호출 경계를 분리합니다. 제품의 브라우저 fixture는 실제 컴포넌트에 데모 백엔드와 대체 IPC를 연결해 질문·실패·빈 상태·탭 이동 등을 재현하며, macOS에서도 Windows 프런트엔드의 주요 동작을 살펴볼 수 있게 합니다.
- Chrome DevTools Protocol 기반 화면 검증
도입 이유데이터 생성 테스트만으로는 그래프의 겹침, 선택 동작, 좁은 화면 배치나 보고서 내보내기를 확인하기 어렵습니다. 실제 브라우저가 화면을 다 읽은 시점에 사용자 조작을 검증해야 합니다.
구현CLI 그래프 테스트는 Node의 fetch·WebSocket으로 Chrome에 연결해 실제 HTML을 엽니다. 저의 기여에서는 문서별 URL과 readyState 완료를 기다리는 방식으로 회귀 테스트를 보완했습니다. 제품의 그래프 검증은 오프라인 상태에서 레이아웃·필터·키보드 선택·보고서·여러 언어를 다룹니다.
| 영역 | 구현과 역할 | 확인하는 범위 |
|---|---|---|
| macOS 앱 | SwiftUI 화면 · Rust C ABI · 시스템 Git | 네이티브 탐색과 Finder·앱 라우팅 |
| Windows 앱 | React·TypeScript 화면 · Tauri Rust 백엔드 | 브라우저 화면 검사와 Windows 통합 검증 |
| 공유 CLI 그래프 | 하나의 분석 결과 · JSON 계약 · 오프라인 HTML | 두 플랫폼의 같은 탐색 화면과 Chrome 회귀 |
기능이 이어지는 흐름
- CLI에서 같은 분석을 생성
파일과 매니페스트를 분석한 결과를 JSON으로 확인하고, 사람이 탐색할 때는 HTML로 생성합니다. 앱도 번들 CLI의 결과를 열어 분석 기준을 공유합니다.
- 웹에서 상태와 조작을 반복 검증
공유 HTML 그래프와 실제 React 화면의 브라우저 fixture를 사용합니다. 화면 크기·테마·데이터 상태를 바꾸고, 선택·필터·탭 이동 같은 사용자 조작을 실제 브라우저에서 확인합니다.
- 운영체제 연동은 별도로 확인
브라우저에서 확인한 화면을 바탕으로 Finder 이동, 앱 URL 라우팅, Tauri 명령과 Windows 설치 등 운영체제에 속한 동작을 각 플랫폼의 검사로 확인합니다. 브라우저 검증 결과와 실제 기기 검증 범위를 구분합니다.
CLI에서 사용하는 명령
기능을 설명하기 위한 사용 예시입니다.
gitch graph files --json- 화면과 자동화가 사용하는 파일 연결 데이터를 같은 CLI 계약으로 조회합니다.
gitch graph --format html --out graph.html- macOS·Windows의 브라우저에서 열 수 있는 독립적인 구조 탐색 화면을 만듭니다.
gitch graph diff --format html- 브랜치에서 바뀐 의존 관계를 웹 화면으로 열어 변경 영향과 확인 대상을 살펴봅니다.
검증을 위해 남긴 것
- 직접 기여: 그래프 탐색·폴더 검사·네이티브 경로 동작과 관련 회귀 테스트를 보완했습니다. Chrome의 페이지 이동 완료 응답과 문서 로딩 완료가 다르다는 점을 반영해, 고정 대기 대신 해당 문서가 준비됐는지 확인하도록 수정했습니다.
- 제품의 공통 검증 구조: CLI가 생성한 실제 HTML에서 배치·선택·필터·보고서·오프라인 동작을 검사하며, Windows의 실제 React 화면은 대체 백엔드와 시스템 호출을 사용해 Chrome에서도 확인합니다.
- 검증 범위: 브라우저 화면 검사는 네이티브 Windows 설치, 자격 증명 저장소, PowerShell·WSL 연동이나 실제 서버 쓰기를 대신하지 않습니다. 해당 환경의 결과는 별도 검증으로 구분합니다.
이 기여에서 쌓은 경험CLI의 분석 계약과 공유 웹 화면을 함께 설계하면 여러 플랫폼에서 기능을 다시 만들거나 따로 해석하는 부담을 줄일 수 있습니다. 저는 공통 결과를 사용하는 탐색 화면과 브라우저 검증을 보완하며, 화면에서 반복 확인할 수 있는 영역과 운영체제별로 확인해야 하는 영역을 구분하는 경험을 쌓았습니다.
향후 전환 계획 · 현재 구현과 구분
Electron으로 macOS·Windows의 웹 UI를 공유하는 방향
현재 제품은 macOS의 SwiftUI와 Windows의 React·Tauri 앱으로 구성되어 있습니다. 다음 방향은 공통 웹 화면을 검증해 온 경험을 넓혀, Electron 기반으로 두 OS의 화면과 사용자 흐름을 공유하는 것입니다. 이 항목은 앞으로의 전환 계획입니다.
- 도입 이유 · 하나의 웹 UI에서 함께 확인
현재는 플랫폼마다 화면 수정과 검증이 필요합니다. 공통 React 화면과 상태 모델을 두 OS에서 사용하면, 같은 기능을 같은 웹 테스트 시나리오로 먼저 확인하고 수정 내용을 함께 적용할 수 있습니다. CLI와 Rust 코어에 모은 처리 계약도 유지하는 방향입니다.
- 기술적 방향 · 화면과 운영체제 기능의 경계
Electron의 renderer는 웹 UI를 맡고 main은 창·파일·프로세스 등 운영체제 연동을 맡도록 구성할 계획입니다. preload와 IPC를 통해 필요한 기능을 명시적인 API로 연결하고, 브라우저 검증에서는 해당 경계를 대체해 정상·실패·빈 상태를 재현하는 방향입니다.
- 검증 계획 · 공통 화면과 OS별 통합 확인
그래프·CI·일정·원장의 화면 조작을 공통 웹 환경에서 반복 검증한 뒤, 설치·업데이트·메뉴·경로·자격 증명 연동은 macOS와 Windows에서 확인할 계획입니다. 공유 UI가 주는 이점을 실제 두 OS의 동작과 함께 검증하겠습니다.
공통 기반과 후속 개선
주요 기여를 뒷받침하는 공통 Rust 코어·저장소 인덱스와 GitLab 탐색 개선도 함께 다뤘습니다.
두 플랫폼과 CLI가 공유하는 저장소 이력
macOS·Windows 앱과 CLI는 서로 다른 실행 환경에서 Git 기록, 변경 내용과 파일 관계를 다룹니다. 이 정보를 함께 사용하려면 처리 기능의 경계를 맞추고, 여러 프로세스가 같은 저장소 이력을 조회·갱신하는 조건도 다뤄야 했습니다.
- Git 기록 파싱, diff·patch 처리, 충돌 처리와 그래프 배치를 공유하는 Rust 코어 개발에 기여했습니다.
- 네이티브·WebAssembly 빌드와 C ABI를 마련해 플랫폼별 UI가 공통 처리 계층을 사용할 수 있도록 연결했습니다.
- 저장소 이력을 담는 Rust·SQLite 인덱스에 증분 동기화와 검색 캐시를 추가했습니다. 쓰기는 Rust에서 담당하고 CLI·C ABI·crate API가 공통 조회 경계를 사용하도록 구성했습니다.
- 같은 저장소를 여러 프로세스가 갱신하거나 Git 이력이 다시 작성되는 경우를 포함해 인덱스의 동기화 조건을 다뤘습니다.
그룹 보드의 접근 경로와 목록 조회 개선
GitLab 보드는 열린 저장소를 통해 접근해야 해 그룹 단위 보드를 찾기 어려웠습니다. 보드와 이슈 목록은 API의 다음 페이지까지 조회해야 했고, 여러 프로젝트에서 같은 이슈 번호를 사용할 수 있어 식별 기준도 구분해야 했습니다.
- macOS·Windows 양쪽 앱에서 저장소를 열지 않고도 그룹을 선택해 보드에 진입할 수 있도록 탐색을 개선했습니다.
- 보드 목록과 보드의 이슈 목록이 다음 페이지까지 조회하도록 페이지네이션을 보완했습니다.
- 그룹의 이슈는 전역 ID로 구분하고, 변경 요청은 각 이슈가 속한 프로젝트를 사용하도록 보완했습니다.
- 관련 회귀 테스트와 다국어 문자열을 함께 갱신해 조회 처리와 실제 화면을 연결했습니다.
첫 기여부터 이어진 기록
2026.10.23의 Finder 탐색 개선부터 CLI·분석·협업 기능으로 기여 범위를 넓혔습니다. 각 항목에 당시 수행 내용과 공개 커밋을 연결했습니다.
macOS 탐색과 업데이트 검증
커밋 상세와 파일 이력을 살피다가 실제 파일로 이동하거나 앱을 업데이트하는 흐름을 개선했습니다.
첫 기여로 Finder에서 파일·폴더를 여는 동작을 추가했습니다. 이후 업데이트 파일의 SHA-256 확인, Ed25519 서명 검증 조건, 백그라운드 다운로드와 설치 실패 처리를 보완했습니다.
다중 Git 계정 CLI 통합
앱과 터미널에서 같은 계정 규칙과 Git 작업 흐름을 사용할 수 있도록 CLI를 연결했습니다.
gitch CLI를 Gitrochi 저장소에 통합하고, 이전 명령과 설정을 유지하기 위한 호환·마이그레이션 검사를 추가했습니다. 계정별 작업과 기존 사용자의 전환 경로를 함께 다뤘습니다.
저장소 구조를 읽는 그래프
파일 목록만으로 파악하기 어려운 코드 연결과 변경 관계를 살펴볼 수 있도록 구조 분석 기능을 구현했습니다.
파일 import, 모듈 의존, 함께 변경된 파일, 폴더 구조를 분석하는 gitch graph 개발에 기여했습니다. 결과를 HTML과 JSON 등으로 제공해 사람이 살펴보거나 다른 도구에서 활용할 수 있게 했습니다.
macOS·Windows가 함께 쓰는 Rust 코어
플랫폼별 화면이 공통 Git 처리 기능을 사용할 수 있도록 공유 코어를 추가했습니다.
Git 기록 파싱, diff·patch 처리, 충돌 처리와 그래프 배치를 공통 Rust 엔진으로 구성하는 작업에 기여했습니다. 네이티브·WebAssembly 빌드 경계와 C ABI, 회귀 테스트를 함께 마련했습니다.
테스트·CI 흐름 실행 엔진
여러 검사를 의존 순서에 따라 실행하고, 실행 여부와 결과를 구분할 수 있는 흐름을 만들었습니다.
YAML 흐름을 DAG로 계획하는 Rust gitch-flow 엔진에 병렬 실행, 잠금, 취소와 실패 분기 처리를 추가했습니다. 실행된 테스트·보고서·종료 상태에 따른 판정, 미신뢰 흐름의 승인 경계, 로그 비밀값 마스킹과 CLI 통합 테스트를 구현했습니다.
대형 그래프 탐색과 배치 최적화
폴더를 펼치거나 특정 파일의 영향을 따라갈 때 그래프 계산과 화면 탐색을 함께 다뤘습니다.
폴더 단위 원 배치와 닫힌 폴더의 연결 집계, 충돌 해소 계산의 시간 예산을 적용했습니다. 역방향 인접 목록·BFS·그래프 캐시와 명시적 스택 탐색으로 반복 계산과 깊은 의존 관계를 다루고 회귀 검증을 남겼습니다.
프로젝트 계획·일정과 로컬 작업 연결
할 일과 코드 작업을 연결하고, 계정이 없는 환경에서도 계획을 작성할 수 있도록 확장했습니다.
프로젝트 작업공간에 Home·달력·보드·타임라인을 연결했습니다. GitHub 날짜·상태 필드를 공유하고, 로컬 프로젝트의 지속 저장과 동시 편집·부분 저장·입력 보존 조건을 양쪽 앱에서 다뤘습니다.
SQLite 기반 저장소 이력 인덱스
저장소 이력을 여러 도구에서 공통으로 조회하고 변경분을 반영할 수 있도록 인덱스를 추가했습니다.
Rust·SQLite 기반 인덱스에 증분 동기화, 검색 캐시와 다중 프로세스 접근을 구현했습니다. CLI·C ABI·crate API의 공통 조회 경계를 마련하고 이력 재작성, 동시 동기화, 이름 변경을 검증하는 통합 테스트를 작성했습니다.
원격 CI·파이프라인과 검토 맥락 연결
실행 이력에서 실패 작업의 로그를 찾고 PR·MR 검토로 돌아오는 흐름을 개선했습니다.
단계별 작업·상태·선택 로그를 연결하고 탭 전환 뒤의 초안과 검토 상태를 보존했습니다. 공유 Rust 계약을 사용하는 시각적 Flow와 Connected CI에 GitHub Actions·GitLab·Jenkins의 실행·탐색을 연결했습니다.
AI 작업 이력을 남기는 Ledger
에이전트가 어떤 기준 버전에서 작업했고 무엇을 만들었는지 사람과 도구가 함께 확인할 수 있도록 작업 기록 기능을 추가했습니다.
세션의 시작 기준, 진행 보고, 질문, 산출물과 반영 상태를 기록하는 Rust Ledger 코어·CLI·MCP 서버 개발에 기여했습니다. SQLite WAL과 단일 쓰기 경계, UI·CLI·MCP 공통 계약과 사람·에이전트의 권한 구분을 다뤘습니다.
GitLab 그룹 보드 탐색 개선
저장소를 열지 않은 상태에서도 그룹의 작업 보드를 찾고 여러 프로젝트의 이슈를 구분할 수 있도록 탐색을 개선했습니다.
macOS·Windows 양쪽 앱의 그룹 보드 진입, 보드·이슈 페이지네이션과 프로젝트 간 같은 이슈 번호의 구분을 보완했습니다. 관련 회귀 테스트와 다국어 문자열도 함께 갱신했습니다.
질문 & 답변
궁금한 점을 남겨주세요 — GitHub 로그인이 필요해요.