IssueOps01 / record
함정과 결정을 파일로 남기고 코드와 함께 리뷰합니다
caution은 함정과 해결 방법을, ADR은 설계 결정을 기록합니다. 둘 다 .issueops/ 아래의 마크다운 파일입니다. 오른쪽은 이 저장소의 실제 기록입니다. 항목을 누르면 그 항목이 담는 내용을 보여 줍니다.
02 / route
다음 작업에는 맞는 기록을 먼저 건넵니다
작업을 시작하기 전에 route-docs가 작업 설명과 단어가 두 개 이상 겹치는 과거 기록을 최대 다섯 건 고릅니다. 작업을 입력해서 어떤 기록이 골라지는지 확인해 보세요.
route-docs의 기록 선택 규칙을 브라우저에서 그대로 실행합니다. 대상은 이 저장소의 caution·ADR 기록 172건입니다(2026-11-03 기준). 드물게 쓰이는 단어일수록 점수가 높습니다. 겹치는 단어 하나마다 ln(N/df)를 더합니다.03 / enforce
기억에 맡기지 않고 게이트로 막습니다
기록은 10단계 사이클 안에서 작성합니다. 문서 반영 판정은 변경 집합에 묶이기 때문에, 오래된 기록을 담은 PR은 발행되지 않습니다. 판정 전에 발행하거나, 판정 뒤에 diff를 바꿔 보세요.
04 / integrate
다섯 호스트가 하나의 코어와 계약을 씁니다
Codex, Claude Code, Omo native, omp, opencode는 같은 Go 코어, 같은 CLI/MCP 응답 계약, 같은 명령 정책, 같은 skills/ 원본을 씁니다. 설치는 홈 디렉터리에만 파일을 쓰고, 저장소는 명시적으로 bootstrap할 때만 바뀝니다.
05 / compare
AGENTS.md, 에이전트 메모리와 무엇이 다른가
IssueOps는 AGENTS.md를 대신하지 않습니다. 모든 세션에 필요한 규칙은 AGENTS.md에 두고, 일부 작업에만 필요한 함정과 결정은 기록으로 남깁니다.
AGENTS.md / CLAUDE.md | 에이전트 내장 메모리 | IssueOps 기록 | |
|---|---|---|---|
| 작성자 | 사람이 직접 씁니다 | 에이전트가 대화에서 씁니다 | 에이전트가 쓰고 사람이 PR에서 리뷰합니다 |
| 저장 위치 | 저장소의 파일 하나 | 각자의 컴퓨터 | 저장소의 .issueops/, 기록마다 파일 하나 |
| 팀원에게 전달 | git으로 전달됩니다 | 전달되지 않습니다 | git으로 전달됩니다 |
| 에이전트가 읽는 범위 | 세션 시작 시 파일 전체 | 도구가 고른 내용 | 작업과 관련된 기록만 |
| 작성 시점 | 누군가 기억할 때 | 도구가 정할 때 | 알게 된 즉시, 늦어도 문서 반영 단계에서 |
06 / install
소스에서 빌드합니다
Git, Go 1.26.6 이상, 사용할 코딩 호스트 하나 이상이 필요합니다. 아직 공개된 바이너리 릴리스는 없습니다.
$ git clone https://github.com/m16khb-org/issueops.git $ cd issueops $ ./install.sh --dry-run --json # 설치 계획을 먼저 확인합니다 $ ./install.sh $ ./bin/issueops doctor --repo . --json
설치한 뒤 에이전트에게 이렇게 요청합니다. "issueops로 로그인 오류를 고쳐 줘. 만료된 세션으로 재현하고 테스트를 추가해. draft PR 생성까지 진행해." 자세한 내용은 전체 README에 있습니다.