agentic-sop-to-work

Loop Engineering — make an agent's loop produce verifiable progress, stay honest, and stay bounded, by deterministic mechanism rather than vibes. agentic-sop-kit is the reference toolkit: it turns a human SOP into a controlled loop, not a one-shot script — no fabrication, no "mega-agent" rot. Loop Engineering — 用確定性機制(不是 vibes)讓 agent 的迴圈每次迭代產生可驗證進度、不自我欺騙、不失控。agentic-sop-kit 是它的參考工具包:把人工 SOP 變成一條受控迴圈——不臆造、不退化成 mega agent。

⭘→◉ Graph Engineering — when one loop isn't enough. Loop Engineering makes one loop trustworthy; Graph Engineering composes trustworthy loops into a bounded graph: named nodes, typed handoff edges, field-level state ownership, and bounded back-edges. The loop invariants descend to nodes and edges — same determinism, one rung up. ⭘→◉ Graph Engineering — 一個迴圈不夠用時。 Loop Engineering 讓一個迴圈可信；Graph Engineering 把可信的迴圈接成一張有界的圖:具名節點、有型別的交接邊、欄位級的狀態所有權、有界退回邊。三個不變量下降到節點與邊的粒度——確定性不變,只是上了一階。

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

🌐 English ・ 繁體中文

🗺️ At a glance · 運作一覽

Human SOP → single-tool skills → orchestrated flow (gated · branch · map) → DRAFT → human approval; a Stop-hook regression gate guards every change.Human SOP → 單一工具 skill → 編排流程（閘門・分支・map）→ DRAFT → 人核准；Stop-hook 回歸閘門守住每次變更。

靜態圖 / static diagram

flowchart LR
    SOP["📄 Human SOP"]
    SK["🔧 single-tool skillsone tool · I/O contract"]
    RUN["⚙️ run.pysteps · branch · back-edge · map · --plan"]
    G{{"🚦 per-step gatecmd · schema · trace · recompute · residual"}}
    DR["📝 DRAFT"]
    OK(["✋ human approval"])
    STOPN["✗ stop & fix"]
    REG[["🔁 Stop-hook regressionchange → tests → block & fix"]]

    SOP -- decompose --> SK
    SK -- orchestrate --> RUN
    RUN --> G
    G -- pass --> DR
    DR --> OK
    G -- fail --> STOPN
    G -. bounded back-edge .-> RUN
    REG -. guards every change .-> SK

    style OK fill:#E8F5E9,stroke:#2E7D32,color:#1B5E20
    style G fill:#FFF8E1,stroke:#F9A825
    style REG fill:#FFEBEE,stroke:#C62828,color:#B71C1C

🔁 The loop, engineered · 受控迴圈的三不變量

agentic-sop-kit makes the loop a controlled one — three deterministic invariants, human-owned at the controlled/destructive edges:

• Bounded termination · 有界終止 — budget (count) + stall (progress): stop when iterations stop producing verifiable progress, not only when retries run out.
• Observable health · 可觀測健康 — a coverage drop hard-gates; slowdown / flaky surface as advisory.
• Bounded state · 有界狀態 — the regression log auto-rotates; run dirs prune on demand (human-authorized).

"Human SOP → workflow" is one application of this loop; the same loop-control applies to any agent loop.

◉ The graph, engineered · 把迴圈接成一張有界的圖

A linear pipeline cannot express "the reviewer sent it back". A graph can — without giving up determinism: 一條線性管線無法表達「審查把它退回去了」。圖可以——而且不必放棄確定性: