From 0fd17ace7e97acc2992b27732547299d7e0421d0 Mon Sep 17 00:00:00 2001 From: toki Date: Sun, 24 May 2026 11:02:20 +0900 Subject: [PATCH] =?UTF-8?q?=EB=AC=B8=EC=84=9C:=20=EC=9E=91=EC=97=85=20?= =?UTF-8?q?=EC=99=84=EB=A3=8C=20=EB=B2=84=EC=A0=84=20=EA=B7=9C=EC=B9=99?= =?UTF-8?q?=EC=9D=84=20=EC=A0=95=EB=A6=AC=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 +++- agent-ops/.version | 2 +- agent-ops/rules/common/rules.md | 7 ++++--- 3 files changed, 8 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index d5a1949..cb54d69 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ AI 에이전트가 매 작업마다 필요한 컨텍스트만 읽도록 `agent-o 이 저장소는 `agent-ops/` 공통 파일의 원본 저장소입니다. 루트의 `.agent-ops-source` 마커가 있으므로 공통 규칙, 공통 스킬, 동기화 스크립트는 이 저장소에서 수정하고 다른 프로젝트로 배포합니다. -현재 프레임워크 버전은 `agent-ops/.version`에 기록되며, 이 README를 갱신한 시점의 버전은 `1.1.31`입니다. 이 저장소는 애플리케이션 런타임이 아니라 문서와 셸 스크립트 중심의 프레임워크라서 별도의 빌드나 테스트 설정 파일은 없습니다. +현재 프레임워크 버전은 `agent-ops/.version`에 기록되며, 이 README를 갱신한 시점의 버전은 `1.1.39`입니다. 이 저장소는 애플리케이션 런타임이 아니라 문서와 셸 스크립트 중심의 프레임워크라서 별도의 빌드나 테스트 설정 파일은 없습니다. ## 빠른 시작 @@ -36,6 +36,7 @@ agent-ops/skills/common/init-agent-ops/SKILL.md 를 읽고 실행해줘. | 대상 프로젝트에서 framework로 변경 올리기 | `agent-ops/bin/sync.sh agentic-framework` | 일반 프로젝트에서 실행 | | framework에서 대상 프로젝트로 내려받기 | `agent-ops/bin/sync.sh --pull agentic-framework` | 일반 프로젝트에서 실행 | | 버전 patch 증가 계산 | `agent-ops/bin/bump-version.sh ` | 결과 버전만 stdout으로 출력 | +| 작업 완료 버전 증가 | `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` | 이 프로젝트에서 작업을 하나 완료할 때마다 실행 | ## 구조 @@ -180,6 +181,7 @@ push 대상은 `agent-ops/.version`, `agent-ops/bin`, `agent-ops/rules/common`, - 대상 프로젝트에서는 `rules/project/`, `rules/private/`, `skills/project/`를 프로젝트에 맞게 수정합니다. - `agent-ops/rules/common/`, `agent-ops/skills/common/`, `agent-ops/bin/`은 공통 관리 영역입니다. - 공통 파일 변경 후에는 `agent-ops/.version`을 함께 관리하고 동기화합니다. +- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`로 `agent-ops/.version`을 한 단계 올립니다. - `agent-ops/rules/private/`는 개인 규칙 영역이며 대상 프로젝트의 `.gitignore`에 추가됩니다. ## 작업 맥락 diff --git a/agent-ops/.version b/agent-ops/.version index 36638c8..1b507d1 100644 --- a/agent-ops/.version +++ b/agent-ops/.version @@ -1 +1 @@ -1.1.37 +1.1.39 diff --git a/agent-ops/rules/common/rules.md b/agent-ops/rules/common/rules.md index 372acf4..c936dfa 100644 --- a/agent-ops/rules/common/rules.md +++ b/agent-ops/rules/common/rules.md @@ -1,12 +1,11 @@ # 공통 규칙 +- 현재 문서를 반드시 끝까지 읽고 작업한다. - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. - 불확실하면 단정하지 말고 후보를 제시한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. -- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다. - 예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version` 세션 최초 1회 아래 파일을 순서대로 읽는다. 파일이나 디렉터리가 없는 항목은 건너뛴다. @@ -14,13 +13,15 @@ 2. `agent-ops/rules/private/rules.md` 3. `agent-ops/roadmap/` 디렉터리가 있으면 `agent-ops/rules/common/rules-roadmap.md` +# 스킬 규칙 + 아래 성격의 요청은 사용자가 명시적으로 요청한 경우에만 `agent-ops/skills/common/router.md`를 작업 최초 1회 읽고 수행한다. 자동으로 수행하지 않는다. - agent-ops 초기화 - domain rule 생성 - skill 생성 - README 생성 - 로드맵/마일스톤 생성·갱신 -- 현재 작업 지점/남은 작업 분석 +- 현재 작업 지점 / 남은 작업 분석 - 계획 작성 / plan 생성 - 코드 리뷰 / review 진행 - git commit / push