docs: update AGENT.md references to .agents/AGENT.md

This commit is contained in:
2026-06-26 21:33:26 +09:00
parent 57d8f6c2ff
commit 698ea09b27
3 changed files with 35 additions and 31 deletions
+17 -15
View File
@@ -10,21 +10,23 @@
본 프로젝트를 새로운 환경에 복제(Clone)한 후, 핵심 구성 요소들의 위치와 역할을 먼저 파악해야 합니다. 본 프로젝트를 새로운 환경에 복제(Clone)한 후, 핵심 구성 요소들의 위치와 역할을 먼저 파악해야 합니다.
* `.agents/skills/`: 멀티 에이전트 구동 및 비동기 잡 처리를 수행하는 셸 스크립트 모음 * `.agents/`: 오케스트레이션 및 에이전트 커스텀 스킬 디렉터리
* `lib.sh`: 오케스트레이션의 핵심 셸 함수 및 가상환경(venv) 자동 연동 라이브러리 * `AGENT.md`: 에이전트 간의 역할 분담(PM, Worker, Reviewer) 및 이벤트 발행 규약 정의
* `multi-agent-mux-create/`: 격리된 tmux 에이전트 세션을 시작하는 스크립트 * `AGENT.ko.md`: 에이전트 간의 역할 분담(PM, Worker, Reviewer) 및 이벤트 발행 규약 정의 (한국어)
* `multi-agent-mux-stop/`: 세션을 정상적으로 중지하고 상태를 업데이트하는 스크립트 * `skills/`: 멀티 에이전트 구동 및 비동기 잡 처리를 수행하는 스크립트 모음
* `multi-agent-mux-resume/`: 중지된 에이전트 세션을 이전 대화 상태 그대로 복원하는 스크립트 * `lib.sh`: 오케스트레이션의 핵심 셸 함수 및 가상환경(venv) 자동 연동 라이브러리
* `multi-agent-mux-status/`: 전체 에이전트 세션의 현재 구동 상태를 조회하는 스크립트 * `multi-agent-mux-create/`: 격리된 tmux 에이전트 세션을 시작하는 스크립트
* `multi-agent-mux-monitor/`: tmux 상태와 레지스트리 상태를 동기화하는 모니터 스크립트 * `multi-agent-mux-stop/`: 세션을 정상적으로 중지하고 상태를 업데이트하는 스크립트
* `multi-agent-mux-delegate-job/`: 비동기 잡 분할 실행 모듈 * `multi-agent-mux-resume/`: 중지된 에이전트 세션을 이전 대화 상태 그대로 복원하는 스크립트
* `requirements.txt`: Python 의존성 목록 (paho-mqtt, pyyaml) * `multi-agent-mux-status/`: 전체 에이전트 세션의 현재 구동 상태를 조회하는 스크립트
* `scripts/`: 핵심 비즈니스 로직을 구동하는 Python 스크립트 디렉터리 * `multi-agent-mux-monitor/`: tmux 상태와 레지스트리 상태를 동기화하는 모니터 스크립트
* `registry.py`: 잡의 등록, 클레임 및 원자적 파일 락 제어 (CLI 지원) * `multi-agent-mux-delegate-job/`: 비동기 잡 분할 실행 모듈
* `job_subscriber.py`: 백그라운드 이벤트 구독기 및 오디팅 로그 생성기 * `requirements.txt`: Python 의존성 목록 (paho-mqtt, pyyaml)
* `publish_event.py`: 실행 상태 및 에러 트랩 시 이벤트 퍼블리셔 * `scripts/`: 핵심 비즈니스 로직을 구동하는 Python 스크립트 디렉터리
* `mqtt_common.py`: 공통 MQTT 브로커 연결 유틸리티 * `registry.py`: 잡의 등록, 클레임 및 원자적 파일 락 제어 (CLI 지원)
* `AGENT.md`: 에이전트 간의 역할 분담(PM, Worker, Reviewer) 및 이벤트 발행 규약 정의 * `job_subscriber.py`: 백그라운드 이벤트 구독기 및 오디팅 로그 생성기
* `publish_event.py`: 실행 상태 및 에러 트랩 시 이벤트 퍼블리셔
* `mqtt_common.py`: 공통 MQTT 브로커 연결 유틸리티
* `MESSAGING.md`: 에이전트 간 주고받는 MQTT 메시지 와이어 스킴 가이드라인 * `MESSAGING.md`: 에이전트 간 주고받는 MQTT 메시지 와이어 스킴 가이드라인
--- ---
+17 -15
View File
@@ -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: 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. * `.agents/`: Orchestration and custom agent skills root.
* `lib.sh`: The core orchestration shell functions and virtual environment (venv) auto-loading library. * `AGENT.md`: Definition of agent roles (PM, Worker, Reviewer) and event publication rules.
* `multi-agent-mux-create/`: Script to launch isolated tmux agent sessions. * `AGENT.ko.md`: Definition of agent roles (PM, Worker, Reviewer) and event publication rules (Korean).
* `multi-agent-mux-stop/`: Script to gracefully stop agent sessions and update states. * `skills/`: A collection of shell scripts that execute multi-agent coordination and asynchronous job processing.
* `multi-agent-mux-resume/`: Script to restore stopped agent sessions back to their previous conversation state. * `lib.sh`: The core orchestration shell functions and virtual environment (venv) auto-loading library.
* `multi-agent-mux-status/`: Script to query the current running state of all agent sessions. * `multi-agent-mux-create/`: Script to launch isolated tmux agent sessions.
* `multi-agent-mux-monitor/`: Monitor script to sync tmux states with the registry. * `multi-agent-mux-stop/`: Script to gracefully stop agent sessions and update states.
* `multi-agent-mux-delegate-job/`: Asynchronous job splitting and delegation module. * `multi-agent-mux-resume/`: Script to restore stopped agent sessions back to their previous conversation state.
* `requirements.txt`: Python dependency list (`paho-mqtt`, `pyyaml`). * `multi-agent-mux-status/`: Script to query the current running state of all agent sessions.
* `scripts/`: Python scripts running the core business logic. * `multi-agent-mux-monitor/`: Monitor script to sync tmux states with the registry.
* `registry.py`: Job registration, claiming, and atomic file lock control (CLI supported). * `multi-agent-mux-delegate-job/`: Asynchronous job splitting and delegation module.
* `job_subscriber.py`: Background event subscriber and audit log generator. * `requirements.txt`: Python dependency list (`paho-mqtt`, `pyyaml`).
* `publish_event.py`: Event publisher for runtime states and error traps. * `scripts/`: Python scripts running the core business logic.
* `mqtt_common.py`: Common utility for connecting to the MQTT broker. * `registry.py`: Job registration, claiming, and atomic file lock control (CLI supported).
* `AGENT.md`: Definition of agent roles (PM, Worker, Reviewer) and event publication rules. * `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. * `MESSAGING.md`: Messaging scheme and wire protocol guidelines for MQTT communication between agents.
--- ---
+1 -1
View File
@@ -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. **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. Read .agents/AGENT.md first before working and follow the instructions for orchestration.