메뉴
Agent Bridge 운영의 단일 진입점(목차/체크리스트). admin·static·dynamic·cron 세션이 "이 상황엔 어느 절차/문서를 따르나"를 한 곳에서 찾도록 한다. 본문은 복사하지 않고 각 canon(SSOT)을 가리킨다. 세션 시작 직후, 그리고 태스크 처리· 업그레이드·릴리즈·handoff·메모리·에스컬레이션을 시작하기 전에 참조한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Scaffold new internal or external agent workdirs and starter files. Use when an operator needs a repeatable starting point for a new long-lived or disposable agent role.
Call the admin repair role from shell automation and route the result back into queue or channel delivery. Use when cron or another runtime helper needs patch to inspect or repair the bridge.
Use when an injected line matching `[Agent Bridge] event=...` arrives in context, or when wording like "inbox notification", "queue event", "external push", "pushed task", "pending-attention flush", or "nudge from daemon" shows up. Encodes the 7-step external-push routine the receiving Claude/Codex session must follow for daemon-delivered work items. Steps: parse whichever metadata fields are present (`event` is required; `agent`/`count`/`top`/`priority`/`title`/`from` are optional and event-kind-dependent) → `agb show <id>` → decide inline-handle vs delegate (delegate by default) → compose a subagent prompt in own words with explicit acceptance criteria → dispatch via the `Task` tool → verify the subagent's JSON return against those criteria → close with `agb done`, or surface `user_message`, or re-dispatch on failure. Source of truth for the subagent return schema (`files_changed`, `checks_run`, `acceptance_met`, `blockers`, `user_review_needed`, `user_message`).
Create, inspect, update, and delete Agent Bridge native cron jobs with `agb cron`.
Use when a daemon-filed `[picker]` queue task arrives (an agent stuck on an interactive picker screen the no-LLM detector would not auto-key), or when wording like "stuck picker", "unknown picker", "classify this pane", "extend the picker catalog", or "picker auto-resolve escalation" shows up. Encodes the admin classify→resolve→extend-catalog loop for the
Ship multiple GitHub issues or tracks **in parallel** as 2-4-PR waves. Use whenever the user has multiple open issues/PRs to process, mentions "wave", "Track A/B/C/D", "parallel fixer", "ship these issues", asks to dispatch issue-fix agents, wants codex code review on a complex PR, or describes a backlog they want batched into focused PRs rather than one bundled change. **Parallelism is the default, not the exception** — independent fixers are dispatched in one message with multiple Agent tool calls so they fan out via run_in_background. Captures the field-tested orchestration pattern (brief writing → issue-fixer dispatch into isolated worktrees → codex-rescue review for >300-LOC specialized work or direct orchestrator review for mid-size → squash-merge with structured notes) that has landed 15+ PRs per session with zero regressions on the Agent Bridge repo. Bundles a project-agnostic `issue-fixer` agent and a `general-purpose` fallback dispatch shape so the workflow is portable across Claude Code installs. I
| name | agent-bridge-operating-manual |
| description | Agent Bridge 운영의 단일 진입점(목차/체크리스트). admin·static·dynamic·cron 세션이 "이 상황엔 어느 절차/문서를 따르나"를 한 곳에서 찾도록 한다. 본문은 복사하지 않고 각 canon(SSOT)을 가리킨다. 세션 시작 직후, 그리고 태스크 처리· 업그레이드·릴리즈·handoff·메모리·에스컬레이션을 시작하기 전에 참조한다. |
이 스킬은 목차 + 강제 체크리스트다. 실제 규칙 본문은 각 canon 문서가 SSOT이고,
여기서는 "어느 상황에 무엇을 보는지"만 가리킨다. 충돌 시 우선순위는
SOUL.md → 에이전트 CLAUDE.md → 공통 canon(아래) 순이다.
| 상황 | 따라야 할 SSOT |
|---|---|
| 세션 시작 | 에이전트 CLAUDE.md의 "매 세션 시작 시" 순서 (SOUL→CLAUDE→SESSION-TYPE→NEXT-SESSION→wiki→MEMORY-SCHEMA→USER.md→MEMORY→COMMON-INSTRUCTIONS/CHANGE-POLICY→TOOLS) |
| 태스크 수신·처리 | COMMON-INSTRUCTIONS.md "Task Processing Protocol" (claim→처리→결과 전달→done) |
| 큐 조작 | agb inbox|show|claim|done, durable A2A는 agent-bridge task create|urgent|handoff, artifact 동반이면 bundle create |
| 2+ 이슈/PR/트랙 동시 | wave-orchestration 스킬 평가(disjoint면 병렬 fan-out, 동일파일 충돌은 직렬) |
| 코드 변경·PR | 페어 프로그래밍 루프: <admin>-dev(codex)에 plan→plan-ok→implement→review→implement-ok→merge. 다른 에이전트 브랜치 미접촉 |
| 릴리즈 | 운영자 명시 go 필수. release PR=VERSION+CHANGELOG only, tag 후 README/docs 동기화 별도 PR (admin 전용) |
| handoff / 세션 인계 | ~/.agent-bridge/docs/agent-runtime/handoff-protocol.md. 표준 파일명 <agent-home>/NEXT-SESSION.md 하나만 hook이 인지 |
| 메모리 | MEMORY-SCHEMA.md. 팀 공유=agent-bridge knowledge, 개인=agent-bridge memory, 사용자별=users/<id>/ |
외부 push ([Agent Bridge] event=…) | external-push-handling 스킬 |
| cron 생성·수정 | agent-bridge cron … (직접 crontab 금지) |
| 사용량/주간 한도 경고·429 쿼터·토큰 로테이션·fleet 크레덴셜 동기화 | Claude OAT 풀은 agent-bridge auth claude-token list|activate|auto-rotate|mark-quota|recover-due, codex fleet-sync는 agent-bridge auth codex-cred …. 운영 런북=OPERATIONS.md "Claude setup-token registry and rotation", 설계 SSOT=docs/design/fleet-credential-design.md |
| 변경 분류(upstream/downstream) | CHANGE-POLICY.md |
| upstream issue/PR | 운영자 승인 없이 생성·propose --yes 금지 |
| 인프라 장애 | agent-bridge urgent <admin> |
비즈니스/human-decision-required | 사람 채널로 escalate (페어 dev 범위 아님) |
| 같은 질문 2회째 | 다시 묻기 전 agent-bridge escalate question --agent <self> … |
| 15분+ blocked | agb update <id> --status blocked --note "사유" |
| iso v2 권한 거부 | 직접 fs 대신 agb verb. agb agent show <a>의 iso_boundary_quickref |
--note 없이 done 치지 않는다queued/claimed/blocked만. 시작 표시는 claim--yes 금지, 운영자 승인 먼저git checkout/commit/amend/reset/worktree prune 금지agb/agent-bridge CLI 우선[cron-followup] needs_human_followup=true → 사람 채널 전달 후 done운영 본문은 전부 아래에 있고, 이 스킬은 그 사본이 아니다. 업그레이드 때 이 문서들이
shared/ 렌더 + 에이전트 심링크 + CLAUDE.md managed-block으로 전 에이전트에 동기화된다.
공유 canon은 ~/.agent-bridge/shared/ 경로로 적는다(iso 홈 렌더러가 BRIDGE_HOME으로 재작성).
일부 설치에서는 ADMIN-PROTOCOL.md가 workdir에 심링크되지 않으므로 bare 파일명으로 가리키지 않는다.
에이전트별 MEMORY-SCHEMA.md는 home/workdir에 실파일로 보장되므로 bare 파일명을 유지한다.
~/.agent-bridge/shared/COMMON-INSTRUCTIONS.md — 전 에이전트 공통 운영 SSOT (queue, task, autonomy, channel)~/.agent-bridge/shared/ADMIN-PROTOCOL.md — admin 전용 (first-run, upgrade, static/dynamic 경계, release)~/.agent-bridge/shared/CHANGE-POLICY.md — 변경 upstream/downstream 분류~/.agent-bridge/shared/TOOLS.md — bridge-native 런타임 레퍼런스MEMORY-SCHEMA.md — 메모리 위키 유지 규칙~/.agent-bridge/docs/agent-runtime/handoff-protocol.md — handoff/NEXT-SESSION 계약~/.agent-bridge/docs/agent-runtime/ — 심화 문서 (role-architecture, wiki-*, user-preference-injection 등)~/.agent-bridge/shared/wiki/index.md — 팀 공유 지식