@hobeenkim/agmo-opencode-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# AGMO OpenCode Plugin
+
+목표: OpenCode에서 `/agmo`를 실행하면 몇 가지 값을 입력받고, 워크스페이스 루트에 `AGENTS.md`를 생성/덮어쓰기.
+
+이 레포는 두 가지 방식 모두 지원합니다.
+
+1) 로컬 설정으로 바로 쓰기: `.opencode/`
+2) npm 패키지로 배포/설치해서 쓰기: `@hobeenkim/agmo-opencode-plugin`
+
+## npm 배포용(이 레포 루트)
+
+- 플러그인 엔트리: `src/index.ts` (빌드 결과: `dist/`)
+- 커맨드 템플릿: `templates/commands/agmo.md`
+
+### 설치/사용
+
+1. npm에 배포한 뒤, 프로젝트의 `opencode.json`에 플러그인을 추가합니다.
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@hobeenkim/agmo-opencode-plugin"]
+}
+```
+
+2. 커맨드 파일을 프로젝트에 추가합니다.
+
+- `templates/commands/agmo.md`를 `.opencode/commands/agmo.md`로 복사
+
+3. OpenCode에서 `/agmo` 실행
+
+## 로컬 설정(개발/테스트용)
+
+- `.opencode/plugins/agmo.js`: tool `agmo_generate_agents_md` 등록
+- `.opencode/commands/agmo.md`: `/agmo` 커맨드
+- `.opencode/package.json`: 로컬 플러그인 의존성
+
+## 빌드
+
+```bash
+npm install
+npm run build
+```
+
+## npm 배포
+
+이 레포는 npm 2FA/토큰 정책 때문에, 퍼블리시용 인증이 필요합니다.
+
+1) 2FA(OTP)로 퍼블리시
+
+```bash
+npm publish --access public --otp=123456
+```
+
+2) Granular token(2FA bypass)로 퍼블리시
+
+```bash
+export NPM_TOKEN=YOUR_TOKEN
+npm run publish:public
+```
+
+배포 확인:
+
+```bash
+npm view @hobeenkim/agmo-opencode-plugin version
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const AgmoPlugin: Plugin;
+export default AgmoPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD,eAAO,MAAM,UAAU,EAAE,MA6BxB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { renderAgentsMd } from "./renderAgentsMd.js";
+export const AgmoPlugin = async () => {
+    return {
+        tool: {
+            agmo_generate_agents_md: tool({
+                description: "Generate/overwrite AGENTS.md in the current worktree",
+                args: {
+                    repoType: tool.schema.enum(["backend", "frontend", "custom"]),
+                    targetFolder: tool.schema.string(),
+                    language: tool.schema.enum(["ko", "en"]),
+                    issueFile: tool.schema.string(),
+                    extraRules: tool.schema.string().optional(),
+                },
+                async execute(args, context) {
+                    const root = context.worktree || context.directory;
+                    const outPath = path.join(root, "AGENTS.md");
+                    const content = renderAgentsMd({
+                        repoType: args.repoType,
+                        targetFolder: args.targetFolder,
+                        language: args.language,
+                        issueFile: args.issueFile,
+                        extraRules: args.extraRules,
+                    });
+                    await fs.writeFile(outPath, content, "utf-8");
+                    return `AGENTS.md created/updated at ${outPath}`;
+                },
+            }),
+        },
+    };
+};
+export default AgmoPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,UAAU,GAAW,KAAK,IAAI,EAAE;IAC3C,OAAO;QACL,IAAI,EAAE;YACJ,uBAAuB,EAAE,IAAI,CAAC;gBAC5B,WAAW,EAAE,sDAAsD;gBACnE,IAAI,EAAE;oBACJ,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;oBAC7D,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBAClC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACxC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBAC/B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC5C;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO;oBACzB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;oBACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;oBAC7C,MAAM,OAAO,GAAG,cAAc,CAAC;wBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;wBAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,CAAC,CAAC;oBAEH,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC9C,OAAO,gCAAgC,OAAO,EAAE,CAAC;gBACnD,CAAC;aACF,CAAC;SACH;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/renderAgentsMd.d.ts

@@ -0,0 +1,9 @@
+export type AgmoInputs = {
+    repoType: "backend" | "frontend" | "custom";
+    targetFolder: string;
+    language: "ko" | "en";
+    issueFile: string;
+    extraRules?: string;
+};
+export declare function renderAgentsMd(v: AgmoInputs): string;
+//# sourceMappingURL=renderAgentsMd.d.ts.map

package/dist/renderAgentsMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderAgentsMd.d.ts","sourceRoot":"","sources":["../src/renderAgentsMd.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,UAmC3C"}

package/dist/renderAgentsMd.js

@@ -0,0 +1,32 @@
+export function renderAgentsMd(v) {
+    const title = v.repoType === "backend"
+        ? "sdm-backend"
+        : v.repoType === "frontend"
+            ? "sdm-frontend"
+            : "custom-repo";
+    const langLine = v.language === "ko" ? "한국어로 답변한다." : "Answer in English.";
+    const extraRules = v.extraRules?.trim() ? v.extraRules.trim() : "- (none)";
+    return `# AGENTS.md
+
+This repo is **${title}**. This file is the working agreement for humans and automation (CI, bots, AI agents).
+
+## Instructions
+- ${langLine}
+- 작업 중인 GitHub Issue에 대한 실행 과제는 \`${v.issueFile}\`에 적는다.
+- 자동화/에이전트가 생성하는 리소스 기본 경로: \`${v.targetFolder}\`
+
+## 새로운 Issue 시작
+1. GitHub에서 이슈번호로 Issue를 읽고 \`${v.issueFile}\`에 작성한다. 기존 내용은 무시한다.
+2. Issue의 type에 따라 필요한 문서/코드 변경을 수행한다.
+3. 커밋 메시지는 변경 요약 + 이슈 번호를 포함한다.
+
+## 코드 변경 규칙
+- 작은 단위로 커밋한다.
+- 테스트/빌드가 필요한 경우 반드시 수행한다.
+- 문서 변경이 필요한 경우 README/관련 문서를 함께 갱신한다.
+
+## 추가 규칙
+${extraRules}
+`;
+}
+//# sourceMappingURL=renderAgentsMd.js.map

package/dist/renderAgentsMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderAgentsMd.js","sourceRoot":"","sources":["../src/renderAgentsMd.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,cAAc,CAAC,CAAa;IAC1C,MAAM,KAAK,GACT,CAAC,CAAC,QAAQ,KAAK,SAAS;QACtB,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU;YACzB,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,aAAa,CAAC;IAEtB,MAAM,QAAQ,GACZ,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAE5D,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAE3E,OAAO;;iBAEQ,KAAK;;;IAGlB,QAAQ;oCACwB,CAAC,CAAC,SAAS;gCACf,CAAC,CAAC,YAAY;;;gCAGd,CAAC,CAAC,SAAS;;;;;;;;;;EAUzC,UAAU;CACX,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@hobeenkim/agmo-opencode-plugin",
+  "version": "0.1.0",
+  "description": "OpenCode plugin that provides a tool to generate AGENTS.md (used by /agmo command template)",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepack": "npm run clean && npm run build",
+    "publish:public": "NPM_CONFIG_USERCONFIG=.npmrc.publish npm publish --access public",
+    "verify:registry": "npm view @hobeenkim/agmo-opencode-plugin version"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.53"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.9",
+    "typescript": "^5.5.4"
+  }
+}

package/templates/commands/agmo.md

@@ -0,0 +1,24 @@
+---
+description: Generate AGENTS.md (AGMO)
+agent: build
+---
+
+워크스페이스 루트에 `AGENTS.md`를 생성/덮어씁니다.
+
+아래 입력값을 질문해서 받습니다. (제가 "default"라고 답하면 기본값 사용)
+
+1) `repoType`: `backend`, `frontend`, `custom` 중 하나 (기본값: `backend`)
+2) `targetFolder`: 기본값 `.agents`
+3) `language`: `ko` 또는 `en` (기본값: `ko`)
+4) `issueFile`: 기본값 `TODO-Issue.md`
+5) `extraRules`: 옵션, 여러 줄 가능 (기본값: 빈 문자열)
+
+값을 모두 받으면 tool `agmo_generate_agents_md`를 아래 인자로 호출합니다.
+
+- repoType
+- targetFolder
+- language
+- issueFile
+- extraRules
+
+마지막에 `AGENTS.md`가 생성/업데이트되었는지 확인 메시지를 출력합니다.