メニュー
Use when checking whether two supposedly decoupled services share hidden semantic coupling — detecting shared domain vocabulary (OrderState, PaymentIntent, FulfillmentStatus) that no import statement reveals.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/mhenke/actionable-philosophy-book-club --skill vocabulary-auditコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Compress PDF, MP4, PPTX, and image files to minimize repository size. Every asset is compressed unconditionally — no size gate, no confirmation.
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
| name | vocabulary-audit |
| description | Use when checking whether two supposedly decoupled services share hidden semantic coupling — detecting shared domain vocabulary (OrderState, PaymentIntent, FulfillmentStatus) that no import statement reveals. |
Detect hidden semantic coupling between two service directories. Based on the Bavota et al. coupling research — when two services share domain terminology but have no explicit import dependency, they have a hidden "ley line" that will eventually cause integration pain.
python3 scripts/vocab_audit.py <serviceA_dir> <serviceB_dir> [options]
| Flag | Description |
|---|---|
--min-freq N | Minimum combined frequency for a term (default: 1) |
--top N | Show only the top N shared terms |
--ext LIST | Comma-separated extensions to scan (overrides defaults) |
--threshold F | Jaccard score threshold (0.0–1.0, default: 0.10) |
--json | Machine-readable JSON output (CI-friendly) |
| Code | Meaning |
|---|---|
0 | Clean — no hidden coupling detected |
1 | Hidden semantic coupling detected (CI failure) |
2 | Usage error (bad args, missing directory) |
The report shows:
hidden (high overlap, no import), explicit (overlap + import), or noneIf hidden coupling is detected, formalize the shared vocabulary into an explicit, versioned schema:
The format matters less than making it visible and versioned.
# Audit two microservice directories
python3 scripts/vocab_audit.py services/order-service services/invoice-service
# CI-friendly JSON output with custom threshold
python3 scripts/vocab_audit.py services/a services/b --json --threshold 0.15