Skip to content

feature(okayJing): add jing-bridge pipeline post#21

Merged
seoJing merged 5 commits into
mainfrom
feature/okaying-post-jing-bridge
May 13, 2026
Merged

feature(okayJing): add jing-bridge pipeline post#21
seoJing merged 5 commits into
mainfrom
feature/okaying-post-jing-bridge

Conversation

@seoJing
Copy link
Copy Markdown
Owner

@seoJing seoJing commented May 13, 2026

Summary

  • jing-bridge 파이프라인 도입 내용을 okayJing 포스트로 작성
  • hermes-worker + notjing watcher 구조, 오케이징 역할 변화 설명
  • jing-bridge 첫 실전 테스트 포스트

Test plan

  • 빌드 통과 확인
  • /okayJing/jing-bridge-pipeline 페이지 렌더링 확인

🤖 Generated with Claude Code

Summary by CodeRabbit

릴리스 노트

  • 문서
    • 헤르메스의 Discord 게이트웨이 직접 연결 전환 및 포럼 티켓 기반 워크플로우 변경에 대한 설명서 추가
    • 디렉토리 기반 에이전트 파이프라인 워크플로우(작업 큐·검토·리젝션 흐름) 문서화
    • 멀티 에이전트 조율을 위한 티켓 기반 구조의 설계 배경, 비교 분석 및 향후 자동화/개선 계획 추가

Review Change Stack

seoJing and others added 4 commits May 13, 2026 02:00
- rename: forum-tickets-hermes-gateway-clab-apply → forum-tickets-hermes-gateway
- fix: remove blank line in tags array

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 13, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
seojing 4448c6d Commit Preview URL

Branch Preview URL
May 13 2026, 08:18 AM

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 13, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 26cae77a-1e47-4d2f-adc8-2f01afb29e21

📥 Commits

Reviewing files that changed from the base of the PR and between fae2a29 and 4448c6d.

📒 Files selected for processing (1)
  • apps/web/content/okayJing/jing-bridge-pipeline.mdx
✅ Files skipped from review due to trivial changes (1)
  • apps/web/content/okayJing/jing-bridge-pipeline.mdx

워크쓰루

세 개의 MDX 문서를 추가하여 다중 에이전트 조율 아키텍처와 두 가지 워크플로우 구현(Discord 포럼 티켓 기반 및 디렉토리 기반 파이프라인)을 문서화합니다. 티켓 기반 구조 선택의 배경, 운영 흐름, 한계와 향후 개선 계획을 설명합니다.

변경 사항

다중 에이전트 조율 아키텍처 및 워크플로우 설계

계층 / 파일 요약
조율 패턴 비교 및 의사결정 프레임워크
apps/web/content/okayJing/multi-agent-ticket-structure.mdx (라인 1–26)
프런트매터 정의 및 6가지 조율 패턴(Hub-and-Spoke, Pipeline, Blackboard, Flat Chat, Swarm, Ticket 기반)의 개요를 제시하고, 현재 구조 선택의 배경을 소개합니다.
패턴별 세부 비교
apps/web/content/okayJing/multi-agent-ticket-structure.mdx (라인 29–97)
각 패턴의 특성, 장점, 단점을 섹션별로 상세 비교하여 의사결정의 근거를 제공합니다.
운영 구조 및 티켓 선택 이유
apps/web/content/okayJing/multi-agent-ticket-structure.mdx (라인 100–150)
okayJing 팀의 혼합 구조(Hub-and-Spoke + Ticket 기반), 포럼 티켓을 통한 세션 간 컨텍스트 복원, 그리고 세션 교체 시 상태 추적 어려움 해결 방식을 설명합니다.
한계 및 향후 개선 계획
apps/web/content/okayJing/multi-agent-ticket-structure.mdx (라인 153–195)
포럼 스레드 생성 마찰, 실시간 반응 지연 가능성, 운영 정책(개발은 티켓 필수, 단순 질문은 채팅 처리), 자동화/템플릿 개선, 그리고 향후 패턴 재검토 계획을 문서화합니다.
Hermes 게이트웨이와 포럼 티켓 기반 워크플로우
apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx (라인 1–122)
Hermes의 Discord 게이트웨이 직접 연결로의 전환, CLI 단방향 실행에서 채널 수신 모델로의 변화, 그리고 포럼 티켓(스레드)에 작업 상태·로그·결과를 누적 기록하면서 채팅에는 간단한 알림만 남기는 워크플로우를 단계별로 설명합니다.
디렉토리 기반 파이프라인 대안 (jing-bridge)
apps/web/content/okayJing/jing-bridge-pipeline.mdx (라인 1–107)
Discord를 통신 채널로 사용하지 않는 대체 파이프라인으로, 디렉토리 구조(inbox, active, review, done, rejected)를 통해 okayJing, hermes-worker, notjing 간의 작업 조율을 설명하고, systemd timer 기반 자동화로의 향후 전환 계획을 제시합니다.

예상 코드 리뷰 노력

🎯 2 (Simple) | ⏱️ ~10분

관련 가능성이 있는 PR

  • seoJing/SEOJing#20: 둘 다 Hermes의 Discord 게이트웨이 운영 방식과 워크플로우 전환(포럼 티켓 기반 추적, hermes 역할 정의)을 문서로 다뤘습니다.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Pull request title clearly and concisely summarizes the main change: adding jing-bridge pipeline documentation post to okayJing content.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/okaying-post-jing-bridge

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
apps/web/content/okayJing/jing-bridge-pipeline.mdx (1)

1-108: ⚠️ Potential issue | 🔴 Critical | ⚡ Quick win

Prettier 포맷팅 오류를 수정해야 합니다.

CI 파이프라인에서 Prettier 검사가 실패했습니다. 파일 끝에 개행 문자가 누락된 것으로 보입니다.

다음 명령어로 수정할 수 있습니다:

prettier --write apps/web/content/okayJing/jing-bridge-pipeline.mdx
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/web/content/okayJing/jing-bridge-pipeline.mdx` around lines 1 - 108, The
Prettier CI failed because the MDX file jing-bridge-pipeline.mdx is missing a
trailing newline at EOF; fix by formatting the file so it ends with a newline —
either run the suggested command (prettier --write
apps/web/content/okayJing/jing-bridge-pipeline.mdx) or manually add a newline at
the end of the file (the file titled "채팅 없이 돌아가는 에이전트 — jing-bridge 파이프라인") and
recommit so Prettier check passes.
apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx (1)

1-123: ⚠️ Potential issue | 🔴 Critical | ⚡ Quick win

Prettier 포맷팅 오류를 수정해야 합니다.

CI 파이프라인에서 Prettier 검사가 실패했습니다. 파일 끝에 개행 문자가 누락된 것으로 보입니다.

다음 명령어로 수정할 수 있습니다:

prettier --write apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx` around lines 1 -
123, CI fails because Prettier reports a formatting error due to a missing
trailing newline at the end of the MDX file; open the MDX that ends with the
final </Paragraph> (after the last paragraph about following a ticket cycle) and
add a single newline at EOF or run the provided formatting command (prettier
--write apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx) to fix
whitespace so the file ends with a newline.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx`:
- Around line 14-21: The two docs present conflicting "today" changes (one shows
Discord gateway added in Subtitle/Paragraph and the other shows Discord removed
in jing-bridge-pipeline.mdx), so update this document to clarify the
relationship: in the intro (around the Subtitle level={2} "0. 오늘 바뀐 것" and the
following Paragraph) explicitly state whether the Hermes Discord gateway and the
jing-bridge pipeline are alternative workflows or are targeted to different
contexts, or replace "오늘" language with a purpose/tradeoffs description;
reference and link the other doc (jing-bridge-pipeline.mdx) and indicate for
which use-cases each approach (Discord gateway via Hermes vs non-Discord
jing-bridge pipeline) should be used to remove ambiguity.

In `@apps/web/content/okayJing/jing-bridge-pipeline.mdx`:
- Around line 14-28: The heading and language in Subtitle ("0. 오늘 바뀐 것") and the
Paragraph that states "<strong>Discord를 경유하지 않습니다.</strong>" are written as if
this is the default/only change; update the copy to present this as an
alternative/experimental directory-based pipeline: rename the subtitle to "대안적
구조" or "실험적 접근법", change declarative phrases (e.g., "오늘부터 구조가 바뀝니다") to
conditional/alternative wording (e.g., "디렉토리 기반 파이프라인 대안"), and add one short
paragraph explaining this approach is an alternative to the Discord workflow
(referencing the forum-tickets-hermes-gateway.mdx doc) plus 2–3 bullet/one-line
criteria when to use the directory-based pipeline vs the Discord gateway (e.g.,
reliable async tasks, reduced chat-dependency vs real-time interactive tasks).

---

Outside diff comments:
In `@apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx`:
- Around line 1-123: CI fails because Prettier reports a formatting error due to
a missing trailing newline at the end of the MDX file; open the MDX that ends
with the final </Paragraph> (after the last paragraph about following a ticket
cycle) and add a single newline at EOF or run the provided formatting command
(prettier --write apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx) to
fix whitespace so the file ends with a newline.

In `@apps/web/content/okayJing/jing-bridge-pipeline.mdx`:
- Around line 1-108: The Prettier CI failed because the MDX file
jing-bridge-pipeline.mdx is missing a trailing newline at EOF; fix by formatting
the file so it ends with a newline — either run the suggested command (prettier
--write apps/web/content/okayJing/jing-bridge-pipeline.mdx) or manually add a
newline at the end of the file (the file titled "채팅 없이 돌아가는 에이전트 — jing-bridge
파이프라인") and recommit so Prettier check passes.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: e212bb84-d8b3-495a-9550-49ed196f53e3

📥 Commits

Reviewing files that changed from the base of the PR and between 96aaec7 and fae2a29.

📒 Files selected for processing (3)
  • apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx
  • apps/web/content/okayJing/jing-bridge-pipeline.mdx
  • apps/web/content/okayJing/multi-agent-ticket-structure.mdx

Comment on lines +14 to +21
<Subtitle level={2}>0. 오늘 바뀐 것</Subtitle>

<Paragraph>
오늘 두 가지가 바뀌었습니다. 헤르메스의 Discord 게이트웨이 직접 연결, 그리고
작업 흐름이 채팅에서 포럼 티켓으로 넘어간 것입니다. 따로 보면 각각 작은
변경이지만, 묶어보면 방향이 있습니다. 에이전트 팀이 좀 더 독립적으로 돌아가는
구조를 향해 한 걸음씩 나아가고 있습니다.
</Paragraph>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚖️ Poor tradeoff

두 문서 간의 관계를 명확히 해야 합니다.

이 문서는 Discord 게이트웨이 연결과 포럼 티켓 도입을 "오늘 바뀐 것"으로 설명하는데, 같은 날짜로 작성된 jing-bridge-pipeline.mdx 문서는 "Discord를 경유하지 않는" 구조로의 전환을 설명합니다. 두 문서가 모두 "오늘부터"라는 표현을 사용하면서 상반된 방향(Discord 도입 vs Discord 제거)을 제시하여 혼란을 줄 수 있습니다.

스택 컨텍스트에서는 jing-bridge가 "대안" 파이프라인으로 명시되어 있으나, 문서 본문에서는 이러한 관계가 명확하지 않습니다.

다음 중 하나를 권장합니다:

  • 두 워크플로우가 대안적 접근법임을 도입부에 명시
  • 각각의 사용 컨텍스트나 적용 범위를 구분하여 설명
  • "오늘" 표현 대신 각 접근법의 목적과 트레이드오프를 중심으로 서술
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/web/content/okayJing/forum-tickets-hermes-gateway.mdx` around lines 14 -
21, The two docs present conflicting "today" changes (one shows Discord gateway
added in Subtitle/Paragraph and the other shows Discord removed in
jing-bridge-pipeline.mdx), so update this document to clarify the relationship:
in the intro (around the Subtitle level={2} "0. 오늘 바뀐 것" and the following
Paragraph) explicitly state whether the Hermes Discord gateway and the
jing-bridge pipeline are alternative workflows or are targeted to different
contexts, or replace "오늘" language with a purpose/tradeoffs description;
reference and link the other doc (jing-bridge-pipeline.mdx) and indicate for
which use-cases each approach (Discord gateway via Hermes vs non-Discord
jing-bridge pipeline) should be used to remove ambiguity.

Comment on lines +14 to +28
<Subtitle level={2}>0. 오늘 바뀐 것</Subtitle>

<Paragraph>
지금까지 헤르메스에게 작업을 위임하는 방식은 Discord를 경유했습니다. 오케이징이
프롬프트를 정리해서 Discord 헤르메스 봇 채널에 메시지를 보내면, 헤르메스가
그걸 받아 실행하는 구조입니다. 그런데 이 방식에는 묶임이 있었습니다. 에이전트
간 통신이 Discord 채널에 종속됩니다. 메시지가 오가지 않으면 작업도 없고,
채팅이 길어지면 어느 작업이 어느 상태인지 파악이 어려워집니다.
</Paragraph>

<Paragraph>
오늘부터 구조가 바뀝니다. <strong>Discord를 경유하지 않습니다.</strong> 오케이징이
task md 파일을 만들면 hermes-worker가 그걸 감지해서 실행하고, 완료되면 낫징이
자동으로 리뷰합니다. 채팅은 알림 채널로만 씁니다.
</Paragraph>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚖️ Poor tradeoff

문서 간 일관성 문제가 있습니다.

이 문서는 "오늘부터 구조가 바뀝니다. Discord를 경유하지 않습니다"라고 설명하는데, 같은 날짜의 forum-tickets-hermes-gateway.mdx는 "오늘부터 헤르메스가 Discord 게이트웨이에 직접 연결됐습니다"라고 설명합니다. 두 문서가 상반된 방향을 제시하여 실제로 어떤 구조가 현재 운영되는지 혼란을 줍니다.

스택 컨텍스트를 보면 이 파일은 "디렉토리 기반 파이프라인 대안"을 문서화하는 것으로 보이나, 본문에서는 이것이 대안임을 명시하지 않고 "오늘부터 바뀝니다"라는 단정적 표현을 사용합니다.

다음을 권장합니다:

  • 이 접근법이 Discord 기반 워크플로우의 대안임을 명시
  • "오늘 바뀐 것" 대신 "대안적 구조" 또는 "실험적 접근법"으로 프레이밍
  • 두 접근법의 선택 기준이나 사용 시나리오를 구분하여 설명
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/web/content/okayJing/jing-bridge-pipeline.mdx` around lines 14 - 28, The
heading and language in Subtitle ("0. 오늘 바뀐 것") and the Paragraph that states
"<strong>Discord를 경유하지 않습니다.</strong>" are written as if this is the
default/only change; update the copy to present this as an
alternative/experimental directory-based pipeline: rename the subtitle to "대안적
구조" or "실험적 접근법", change declarative phrases (e.g., "오늘부터 구조가 바뀝니다") to
conditional/alternative wording (e.g., "디렉토리 기반 파이프라인 대안"), and add one short
paragraph explaining this approach is an alternative to the Discord workflow
(referencing the forum-tickets-hermes-gateway.mdx doc) plus 2–3 bullet/one-line
criteria when to use the directory-based pipeline vs the Discord gateway (e.g.,
reliable async tasks, reduced chat-dependency vs real-time interactive tasks).

@seoJing seoJing merged commit 1c0fd89 into main May 13, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants