agentic-sop-to-work

Loop Engineering(루프 엔지니어링)— 느낌(vibes)이 아닌 결정론적 메커니즘을 통해 에이전트의 루프가 검증 가능한 진전을 생성하고, 정직함을 유지하며, 경계 내에 머물도록 만듭니다. agentic-sop-kit

이는 참조용 툴킷(toolkit)입니다: 인간의 SOP(표준 운영 절차)를 일회성 스크립트가 아닌 제어된 루프로 전환합니다 — 조작(fabrication)이나 "mega-agent"의 퇴화가 없습니다. Loop Engineering(루프 엔지니어링)— 결정론적 메커니즘(vibes가 아닌)을 사용하여 에이전트의 루프가 매 반복마다 검증 가능한 진전을 생성하고, 자기 기만(self-deception)을 하지 않으며, 통제력을 잃지 않도록 합니다. agentic-sop-kit

이는 참조용 툴킷(toolkit)입니다: 인간의 SOP를 제어된 루프로 변환합니다 — 조작(fabrication)이나 mega-agent로의 퇴화가 없습니다.

/plugin marketplace add s0912758806p/agentic-sop-to-work
/plugin install agentic-sop-kit@agentic-sop-to-work
/reload-plugins

Human SOP → 단일 도구 기술(single-tool skills) → 오케스트레이션 흐름(orchestrated flow) (게이트(gated) · 분기(branch) · 맵(map)) → 초안(DRAFT) → 인간 승인; Stop-hook 회귀 게이트(regression gate)가 모든 변경 사항을 보호합니다.

정적 다이어그램 / static diagram

flowchart LR
SOP["📄 Human SOP"]
SK["🔧 single-tool skills<br/>one tool · I/O contract"]
...

agentic-sop-kit는

루프를 제어된(controlled) 루프로 만듭니다 — 제어/파괴적 경계에서 인간이 소유하는 세 가지 결정론적 불변량(deterministic invariants)을 제공합니다:

유계 종료(Bounded termination)— 예산(count) + 정체(stall, progress): 재시도 횟수가 소진되었을 때뿐만 아니라, 반복이 검증 가능한 진전을 생성하지 못할 때 중단합니다.
관찰 가능한 상태(Observable health)— 커버리지(coverage) 저하는 강력한 게이트(hard-gates) 역할을 하며, 속도 저하/불안정한(flaky) 표면은 권고 사항으로 처리됩니다.
유계 상태(Bounded state)— 회귀 로그(regression log)는 자동 순환(auto-rotates)되며, 실행 디렉토리(run dirs)는 요청 시(인간의 승인 하에) 정리(prune)됩니다.

"Human SOP → 워크플로우(workflow)"는 이 루프의 한 가지 응용 사례입니다; 동일한 루프 제어(loop-control)가 모든 에이전트 루프에 적용됩니다.

무엇인가(What). agentic-sop-kit은

Loop Engineering(루프 엔지니어링) 툴킷입니다: 당신이 수동으로 수행하는 프로세스("Human SOP")를 LLM이 안전하고 반복 가능하게 실행할 수 있는 **제어된 에이전트 루프(controlled agentic loop)**로 전환합니다 — 유계 종료(bounded termination), 관찰 가능한 상태(observable health), 유계 상태(bounded state)를 갖춘 형태입니다. 챗봇이 아닌 방법론(methodology) + 휴대 가능한 툴킷(portable toolkit)입니다. 규제 대상 / 고위험 / 반드시 정확해야 하는 작업을 위해 구축되었습니다.

안전한 이유(Why it's safe) — 예측 가능한 LLM의 실패를 차단합니다:

만드는 과정 (Fabrication) → 사실은 오직 입력에서만 나옴; 누락된 부분은 【待補】로 표시되며, 절대로 지어내지 않음.가짜 자율성 (Fake autonomy) → 코드 내의 결정론적 작업; 하드 게이트는 폐쇄적이며 LLM과 무관함 (자가 평가만 자문용, 제한됨).책임 소재 불분명한 출력 (Unaccountable output) → 모든 출력은 **초안(DRAFT)임; 통제되거나 고위험 호출은 인간이 소유함.메가 에이전트 부패 (Mega-agent rot) → 감사 기능 + 중지 후크(Stop-hook)를 통해 변경될 때마다 재검증하는 회귀 게이트(regression gate).

얻게 되는 것 (What you get)

3가지 기술 (의도에 따라 자동 트리거) |
six-rung-ladder — 최소주의적인

.Capped auto fix-loop— 게이트 실패 시, /sop-flow가 자동 수정 및 재실행 (run.py --max-fix-retries)

; 실행(run-id)별로 코드로 강제되며, SOPKIT_MAX_FIX_RETRIES(기본값 3 — Stop-hook 회귀 루프와 동일한 노브)에 의해 제한됩니다; 한도 초과 시 → 인간의 개입을 위해 중단; 통과를 위해 출력을 패치(patch)하지는 않습니다. Loop control(루프 엔지니어링, kit/lib/loop/ 내 위치) — 루프를 경계 내로 유지하고, 관찰하며, 상태를 제한합니다:
stall: 검증 가능한 진전이 없을 경우 중단 (SOPKIT_STALL_WINDOW);
health: 커버리지 저하를 엄격하게 차단(hard-gate)하고 속도 저하/불안정성(flaky)을 플래그로 표시(권고 사항);
state: 실행 로그를 자동 회전(auto-rotate)하고 요청 시 실행 디렉토리를 정리 (run.py --prune). 모두 결정론적(deterministic)입니다.

Iron rules — 입력값으로부터의 사실만 사용 (【待補】는 공백용) · 코드 내에서 결정론적으로 작동하며, 게이트는 격리되어 있고 LLM을 사용하지 않음 · 초안(DRAFT) + 인간의 승인 · 게이트는 키워드가 아닌 진실을 확인합니다. 실질적인 강제 집행은 산문(prose)이 아니라 Stop-hook입니다.

Install — Claude Code(Claude Desktop의 Code 탭 포함)에서:

/plugin marketplace add s0912758806p/agentic-sop-to-work
/plugin install agentic-sop-kit@agentic-sop-to-work
/reload-plugins # 또는 세션 재시작

python3로서 **Python 3.8+**가 필요합니다
(macOS/Linux는 즉시 사용 가능; Windows에서는 python3가 해결되는지 확인하십시오). 확인 방법: /help에 /agentic-sop-kit:sop-flow가 목록에 있는지 확인하십시오.

Build your own flow — 키트를 채택하십시오: python3 <plugin>/kit/bootstrap.py --project <dir>
→ 단계(step) 스캐폴딩: new_skill.py --name <x> (DEPS / run() 작성)
→ workflow/flow.json 연결
→ 대화로 트리거 가능하게 만들기: export_claude_skill.py --skill <x>.
상세 내용: kit/SOP.md.

Layout

agentic-sop-to-work/
├── .claude-plugin/marketplace.json
└── plugins/agentic-sop-kit/
...

License — MIT (LICENSE · NOTICE); 단일 파일을 포함한 복사본에도 저작권/라이선스 고지를 유지하십시오. 업데이트: git push → 사용자가 /plugin marketplace update agentic-sop-to-work 실행; 의미 있는 변경 시마다 plugin.json의 version을 올리십시오.

是什麼。 agentic-sop-kit

무엇인가. agentic-sop-kit

이는 Loop Engineering (루프 엔지니어링) 도구 모음입니다. 당신이 수동으로 수행하던 프로세스(Human SOP)를 LLM이 안전하고(safe), 반복 가능하게(repeatable) 실행할 수 있는 **제어된 agentic 루프(controlled agentic loop)**로 엔지니어링합니다. 즉, 유계 종료(bounded termination) + 관측 가능한 상태(observable health) + 유계 상태(bounded state)를 갖춘 시스템입니다. 이는 챗봇이 아니라, 방법론(methodology)과 휴대 가능한 도구 모음(toolkit)입니다. 규제가 엄격하거나, 고위험군이거나, 오류가 허용되지 않는 업무를 위해 탄생했습니다.

왜 신뢰할 수 있는가 — LLM의 예측 가능한 실패 요인들을 하나씩 차단합니다:

환각 (Hallucination) → 사실은 오직 입력값에서만 가져옵니다. 누락된 정보는 【待補】 (보충 필요)로 표시하며, 절대 지어내지 않습니다. 가짜 자율성 (Pseudo-autonomy) → 결정론적인 작업은 프로그램으로 처리합니다. 엄격한 게이트(hermetic gates)를 적용하며, LLM의 개입을 제로화합니다 (LLM의 자기 평가는 오직 권고(advisory) 용도로만 제한됩니다). 책임 없는 결과물 (Unaccountable output) → 모든 결과물은 DRAFT (초안) 상태입니다. 제어/고위험 판단 권한은 항상 인간이 보유합니다. mega-agent 퇴화 (Degradation) → 감사 스킬(audit skill)과 **Stop-hook (중단 훅)**을 통한 **회귀 게이트(regression gate)**를 적용하여, 매 변경 시마다 재검증합니다.

제공되는 기능

3가지 Skills (의도에 따라 자동 트리거) |
six-rung-ladder — 「정말로 해야 하는가」를 판단하는 초간결 필터링 망 (decide) · agentic-sop — 방법론 및 진입점 + 지능형 의도 분기 (build) · agentic-workflow-audit — 읽기 전용(read-only) mega-agent 감사자 (audit) |
명령어 /agentic-sop-kit:sop-flow |
동작 kit의 오케스트레이션 실행 및 DRAFT 결과 보고 |
Hooks (프로젝트 범위) |
SessionStart 의존성 검사 · Stop 회귀 게이트 — kit가 도입되지 않은 프로젝트에서는 일괄적으로 no-op(동작 안 함) 처리 |
휴대 가능한 kit kit/ |
어떤 프로젝트로든 복사하여 즉시 사용할 수 있는 방법론 + 실행 가능한 예제 |
Plugin alcoa-guard |
ALCOA+ 데이터 무결성 linter — 결정론적 검사 수행: Attributable(귀속성)／Contemporaneous(동시성)／Complete(완전성)／Accurate(정확성)／Consistent(일관성); 인간의 판단이 필요한 부분은 【待補】 체크리스트로 표시; 순수 stdlib 사용; 결과물은 DRAFT로 생성 |
Plugin plugin-forge |
Claude Code 플러그인 linter + scaffolder — lint 명령으로 house grammar에 따라 단일 플러그인 또는 전체 마켓플레이스(manifest/frontmatter 검사를 포함하는 엄격한 상위 집합 + stdlib-only, hook-protocol, test-harness 불변량)를 검증; scaffold 명령으로 grammar에 부합하는 플러그인 골격 생성; 자기 호스팅(self-hosting); 순수 stdlib 사용 |

엔진 (run.py) — 결정론적이며, 프로그램에 의해 결정되고, 부가적인 방식입니다:

단계별 엄격한 게이트 (fail 즉시 중단, LLM 개입 제로): cmd_gate · schema_gate · trace_gate (환각 방지) · recompute_gate (화이트리스트 기반; 환경을 변경하는 작업은 cmd 단계에서 --allow-mutations 필요) · 드라이 런(dry-run, 각 단계를 나열하고 정적 검증 수행) --plan (forward-only) · branch (항목별) — 제어 흐름(control flow)은 프로그램이 결정하며, 모델에 맡기지 않습니다. map_over

예제 — 의존성 없는 FE／BE／DB／AI 프로세스: kit/workflow/examples/

상한선이 있는 자동 수정 fix-loop — 게이트 실패 시 /sop-flow가 자동으로 수정 후 재실행합니다 (run.py --max-fix-retries 사용, run-id에 따라 프로그램이 강제하는 상한선 적용; Stop-hook 회귀와 동일한 SOPKIT_MAX_FIX_RETRIES 공유, 기본값 3). 상한에 도달하면 중단하고 인간에게 전달합니다. 통과를 위해 출력을 조작하지 않습니다.

루프 제어 (Loop Engineering, kit/lib/loop/ 위치) — 루프를 **유계(bounded), 관측 가능(observable), 상태 유계(bounded state)**로 유지합니다: stall (검증 가능한 진전이 없을 때 조기 종료, SOPKIT_STALL_WINDOW) · health (커버리지 축소 시 차단, 속도 저하/flaky 발생 시 권고(advisory) 제공) · state (run log 자동 순환, 필요 시 run.py --prune으로 run 디렉토리 정리). 모든 과정은 완전 결정론적입니다.

철칙 — 사실은 오직 입력에서만 가져온다 (【待補】 표시) · 결정론적인 작업은 프로그램으로, 게이트는 엄격하게(hermetic), LLM 개입 제로 · DRAFT 생성 + 인간의 승인 · 게이트는 키워드가 아닌 진실을 검증한다. 진정한 강제력은 산문(prose)이 아니라 Stop-hook에 있다.

설치 — Claude Code (Claude Desktop의 Code 탭 포함)에서:

/plugin marketplace add s0912758806p/agentic-sop-to-work
/plugin install agentic-sop-kit@agentic-sop-to-work
/reload-plugins # 또는 세션 재시작

Python 3.8+ 가 필요하며, python3 명령어로 실행 가능해야 합니다.

호출 (macOS/Linux는 즉시 사용 가능; Windows는 python3가 실행 가능한지 확인하세요).
검증: /help를 입력했을 때 /agentic-sop-kit:sop-flow가 보여야 합니다.

자신만의 워크플로우 구축 — kit 도입: python3 <plugin>/kit/bootstrap.py --project <dir>
→ 스캐폴딩 (scaffold) 단계: new_skill.py --name <x>
(DEPS 및 run() 작성) → workflow/flow.json에서 연결 → 대화로 트리거할 수 있도록 내보내기: export_claude_skill.py --skill <x>.
자세한 내용은 kit/SOP.md를 참조하세요.

구조

agentic-sop-to-work/
├── .claude-plugin/marketplace.json
└── plugins/agentic-sop-kit/
...

라이선스 — MIT (LICENSE · NOTICE); 복제본은 단일 파일이라도 저작권/라이선스 고지를 유지해야 합니다.
업데이트: git push → 사용자가 /plugin marketplace update agentic-sop-to-work 실행; 의미 있는 변경이 있을 때마다 plugin.json의 version을 높이세요.