From 698ea09b279d4c3fb73a9e87927454efd87237fc Mon Sep 17 00:00:00 2001 From: Godopu Date: Fri, 26 Jun 2026 21:33:26 +0900 Subject: [PATCH] docs: update AGENT.md references to .agents/AGENT.md --- BOOTSTRAP.ko.md | 32 +++++++++++++++++--------------- BOOTSTRAP.md | 32 +++++++++++++++++--------------- INSTRUCTION.md | 2 +- 3 files changed, 35 insertions(+), 31 deletions(-) diff --git a/BOOTSTRAP.ko.md b/BOOTSTRAP.ko.md index e3ffda2..cc6c3f4 100644 --- a/BOOTSTRAP.ko.md +++ b/BOOTSTRAP.ko.md @@ -10,21 +10,23 @@ 본 프로젝트를 새로운 환경에 복제(Clone)한 후, 핵심 구성 요소들의 위치와 역할을 먼저 파악해야 합니다. -* `.agents/skills/`: 멀티 에이전트 구동 및 비동기 잡 처리를 수행하는 셸 스크립트 모음 - * `lib.sh`: 오케스트레이션의 핵심 셸 함수 및 가상환경(venv) 자동 연동 라이브러리 - * `multi-agent-mux-create/`: 격리된 tmux 에이전트 세션을 시작하는 스크립트 - * `multi-agent-mux-stop/`: 세션을 정상적으로 중지하고 상태를 업데이트하는 스크립트 - * `multi-agent-mux-resume/`: 중지된 에이전트 세션을 이전 대화 상태 그대로 복원하는 스크립트 - * `multi-agent-mux-status/`: 전체 에이전트 세션의 현재 구동 상태를 조회하는 스크립트 - * `multi-agent-mux-monitor/`: tmux 상태와 레지스트리 상태를 동기화하는 모니터 스크립트 - * `multi-agent-mux-delegate-job/`: 비동기 잡 분할 실행 모듈 - * `requirements.txt`: Python 의존성 목록 (paho-mqtt, pyyaml) - * `scripts/`: 핵심 비즈니스 로직을 구동하는 Python 스크립트 디렉터리 - * `registry.py`: 잡의 등록, 클레임 및 원자적 파일 락 제어 (CLI 지원) - * `job_subscriber.py`: 백그라운드 이벤트 구독기 및 오디팅 로그 생성기 - * `publish_event.py`: 실행 상태 및 에러 트랩 시 이벤트 퍼블리셔 - * `mqtt_common.py`: 공통 MQTT 브로커 연결 유틸리티 -* `AGENT.md`: 에이전트 간의 역할 분담(PM, Worker, Reviewer) 및 이벤트 발행 규약 정의 +* `.agents/`: 오케스트레이션 및 에이전트 커스텀 스킬 디렉터리 + * `AGENT.md`: 에이전트 간의 역할 분담(PM, Worker, Reviewer) 및 이벤트 발행 규약 정의 + * `AGENT.ko.md`: 에이전트 간의 역할 분담(PM, Worker, Reviewer) 및 이벤트 발행 규약 정의 (한국어) + * `skills/`: 멀티 에이전트 구동 및 비동기 잡 처리를 수행하는 셸 스크립트 모음 + * `lib.sh`: 오케스트레이션의 핵심 셸 함수 및 가상환경(venv) 자동 연동 라이브러리 + * `multi-agent-mux-create/`: 격리된 tmux 에이전트 세션을 시작하는 스크립트 + * `multi-agent-mux-stop/`: 세션을 정상적으로 중지하고 상태를 업데이트하는 스크립트 + * `multi-agent-mux-resume/`: 중지된 에이전트 세션을 이전 대화 상태 그대로 복원하는 스크립트 + * `multi-agent-mux-status/`: 전체 에이전트 세션의 현재 구동 상태를 조회하는 스크립트 + * `multi-agent-mux-monitor/`: tmux 상태와 레지스트리 상태를 동기화하는 모니터 스크립트 + * `multi-agent-mux-delegate-job/`: 비동기 잡 분할 실행 모듈 + * `requirements.txt`: Python 의존성 목록 (paho-mqtt, pyyaml) + * `scripts/`: 핵심 비즈니스 로직을 구동하는 Python 스크립트 디렉터리 + * `registry.py`: 잡의 등록, 클레임 및 원자적 파일 락 제어 (CLI 지원) + * `job_subscriber.py`: 백그라운드 이벤트 구독기 및 오디팅 로그 생성기 + * `publish_event.py`: 실행 상태 및 에러 트랩 시 이벤트 퍼블리셔 + * `mqtt_common.py`: 공통 MQTT 브로커 연결 유틸리티 * `MESSAGING.md`: 에이전트 간 주고받는 MQTT 메시지 와이어 스킴 가이드라인 --- diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index 28c8bc3..4c7bede 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -10,21 +10,23 @@ A new agent can follow the steps in this guide sequentially to establish a stabl Before cloning this project into a new environment, you must first understand the locations and roles of its core components: -* `.agents/skills/`: A collection of shell scripts that execute multi-agent coordination and asynchronous job processing. - * `lib.sh`: The core orchestration shell functions and virtual environment (venv) auto-loading library. - * `multi-agent-mux-create/`: Script to launch isolated tmux agent sessions. - * `multi-agent-mux-stop/`: Script to gracefully stop agent sessions and update states. - * `multi-agent-mux-resume/`: Script to restore stopped agent sessions back to their previous conversation state. - * `multi-agent-mux-status/`: Script to query the current running state of all agent sessions. - * `multi-agent-mux-monitor/`: Monitor script to sync tmux states with the registry. - * `multi-agent-mux-delegate-job/`: Asynchronous job splitting and delegation module. - * `requirements.txt`: Python dependency list (`paho-mqtt`, `pyyaml`). - * `scripts/`: Python scripts running the core business logic. - * `registry.py`: Job registration, claiming, and atomic file lock control (CLI supported). - * `job_subscriber.py`: Background event subscriber and audit log generator. - * `publish_event.py`: Event publisher for runtime states and error traps. - * `mqtt_common.py`: Common utility for connecting to the MQTT broker. -* `AGENT.md`: Definition of agent roles (PM, Worker, Reviewer) and event publication rules. +* `.agents/`: Orchestration and custom agent skills root. + * `AGENT.md`: Definition of agent roles (PM, Worker, Reviewer) and event publication rules. + * `AGENT.ko.md`: Definition of agent roles (PM, Worker, Reviewer) and event publication rules (Korean). + * `skills/`: A collection of shell scripts that execute multi-agent coordination and asynchronous job processing. + * `lib.sh`: The core orchestration shell functions and virtual environment (venv) auto-loading library. + * `multi-agent-mux-create/`: Script to launch isolated tmux agent sessions. + * `multi-agent-mux-stop/`: Script to gracefully stop agent sessions and update states. + * `multi-agent-mux-resume/`: Script to restore stopped agent sessions back to their previous conversation state. + * `multi-agent-mux-status/`: Script to query the current running state of all agent sessions. + * `multi-agent-mux-monitor/`: Monitor script to sync tmux states with the registry. + * `multi-agent-mux-delegate-job/`: Asynchronous job splitting and delegation module. + * `requirements.txt`: Python dependency list (`paho-mqtt`, `pyyaml`). + * `scripts/`: Python scripts running the core business logic. + * `registry.py`: Job registration, claiming, and atomic file lock control (CLI supported). + * `job_subscriber.py`: Background event subscriber and audit log generator. + * `publish_event.py`: Event publisher for runtime states and error traps. + * `mqtt_common.py`: Common utility for connecting to the MQTT broker. * `MESSAGING.md`: Messaging scheme and wire protocol guidelines for MQTT communication between agents. --- diff --git a/INSTRUCTION.md b/INSTRUCTION.md index a54fc07..87269c7 100644 --- a/INSTRUCTION.md +++ b/INSTRUCTION.md @@ -64,4 +64,4 @@ Strong success criteria let you loop independently. Weak criteria ("make it work **These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes. -Read AGENT.md first before working and follow the instructions for orchestration. \ No newline at end of file +Read .agents/AGENT.md first before working and follow the instructions for orchestration. \ No newline at end of file