메뉴
Enforce this repository's real Agent/Client foundation, TypeSpec-to-proto codegen, Next.js Client boundaries, and OpenSpec rules while editing code, docs, or tooling.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Generate JSON wireframe with HTML preview
Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.
Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.
Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.
Premium UI/UX design audit and refinement skill. Use for design review, UI audit, visual polish, hierarchy, spacing, typography, color, responsive behavior, accessibility, consistency, and implementation-ready design plans. Purely visual; does not change product functionality or backend behavior.
| name | coding-guardian |
| description | Enforce this repository's real Agent/Client foundation, TypeSpec-to-proto codegen, Next.js Client boundaries, and OpenSpec rules while editing code, docs, or tooling. |
この skill は、このリポジトリで実際に fail する規約と検証フローから外れないようにガードします。
AGENTS.md に従うCODING_STANDARDS.md と enforcement entrypoint を読むpackages/agent/src/typespec/main.tsp で、OpenAPI ではなく proto3/RPC descriptors を生成するpackages/agent/proto/**、packages/agent/src/generated/rpc/**、packages/client/src/generated/agent-rpc/** は command-ownedpackages/agent/** が Cloudflare Agents SDK / Durable Object / Connect RPC Worker、packages/client/** が Next.js on Cloudflare Workers management Clientpnpm lint には OpenSpec validate、Scenario coverage check、supply-chain policy check が含まれる最初に次を読む。
AGENTS.mdCODING_STANDARDS.mdCONTRIBUTING.md.opencode/skills/coding-guardian/references/repo-entrypoints.md特に重要な enforcement entrypoint:
package.json, .github/workflows/ci.yml, .husky/pre-commit, .husky/commit-msg, .lintstagedrc.json, commitlint.config.js, eslint.config.jspackages/agent/package.json, packages/agent/wrangler.toml, packages/agent/src/index.ts, packages/agent/src/AIAgent.ts, packages/agent/src/rpc/**, packages/agent/src/storage/schema/agent-storage.tspackages/agent/src/typespec/main.tsp, packages/agent/src/typespec/tspconfig.yaml, packages/agent/buf.yaml, packages/agent/buf.gen.yaml, scripts/codegen/check-agent-codegen-drift.mjspackages/client/package.json, packages/client/wrangler.toml, packages/client/next.config.ts, packages/client/open-next.config.ts, packages/client/app/**, packages/client/src/server/**scripts/governance/verify-agent-surface.mjs, scripts/governance/verify-package-boundaries.mjs, scripts/security/verify-pnpm-supply-chain.mjs, scripts/openspec/verify-scenario-coverage.mjsscripts/openspec/verify-change-intent.mjs, scripts/openspec/verify-scenario-coverage.mjs, scripts/openspec/verify-change-task-scope.mjs, scripts/openspec/verify-wireframe-previews.mjspackages/agent/src/typespec/**, packages/agent/proto/**, packages/agent/src/generated/rpc/**, packages/client/src/generated/agent-rpc/**, scripts/codegen/**packages/agent/src/**, excluding generated RPC outputpackages/client/app/**, packages/client/src/server/**, packages/client/src/tests/**, excluding generated Agent RPC outputscripts/governance/**, scripts/security/**, scripts/openspec/**, .opencode/**.opencode/**固定の依存方向:
packages/agent/src must not import packages/client/src; packages/client/src may import generated Agent RPC code from packages/client/src/generated/agent-rpc/** and Connect runtime packages, but must not import packages/agent/src/**packages/agent/src/typespec -> packages/agent/proto -> packages/agent/src/generated/rpc and packages/client/src/generated/agent-rpcpackages/agent/src/typespec/** を直し、pnpm gen:agent:proto、pnpm gen:agent:rpc、pnpm check:codegen で整合を取る。packages/agent/proto/** と packages/**/src/generated/** は手で直さないagent_id; command requests keep idempotency_key; Event publish requests keep non-empty NFC-normalized thread_key of at most 512 UTF-8 bytespackages/agent/wrangler.toml は AI_AGENT Durable Object binding と Agent-owned blob storage を持ち、D1、CLIENT_DB、Cloudflare Queues producer/consumer bindings を持たないpackages/client/wrangler.toml は CLIENT_DB と credential secret references を持ち、AI_AGENT と Agent-owned storage bindings を持たない/api/client/*、/api/agent*、Agent REST proxy、arbitrary RPC forwarding route を追加しない。Server Actions / Server Components は UI 内部境界として扱うpackages/client は Agent domain snapshots を Client D1 に保存しない。Client D1 は managed Agent records と credential references だけを所有する.opencode guidance を更新するときは packages/agent/** と packages/client/** を implementation/review scope として認識させ、generated RPC output の hand edit permission を追加しないpackages/**/src/**/*.{ts,tsx} の export は、生成物とテストを除き TSDoc を付けるopenspec/specs/**/spec.md の Scenario ID とテストタイトルの参照を崩さない変更内容に応じて、少なくとも次を実行する。
pnpm gen:agent:proto -> pnpm gen:agent:rpc -> pnpm check:codegenpnpm lintpnpm lintpnpm lint -> pnpm test:runpnpm test:clientpnpm test:agentpnpm buildpython3 .opencode/skills/opencode-skills-devkit/scripts/validate_skills.py --root .Changed-file 向けの軽量チェック:
.opencode/skills/coding-guardian/scripts/check_changed.sh [base]CLIENT_DB、Cloudflare Queues binding 追加AI_AGENT binding 追加packages/agent/src と packages/client/src の runtime-source import coupling.opencode guidance が古い demo template path だけを実装基準にすること