メニュー
Activate documentation freshness checks during refactoring. Use when renaming files, moving code between files, splitting/merging files, restructuring subsystems, deleting referenced files, or any work that changes file organization.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
MANDATORY - Load before writing tests. Covers fakes over mocks, golden files, goleak, httptest, fuzzing, parallel tests, synctest, race detection, test coverage, table-driven tests. Enforces project test conventions.
File and directory naming conventions for this project. Covers directory structure, file naming patterns, test file organization, package layout, subpackage decisions. Load when creating new files, packages, or directories.
MANDATORY - All logging must use slog with structured JSON fields. Covers log/slog setup, structured logging, log levels, request logging, log message style, field naming. Load before writing any slog, log, or fmt.Print logging code.
MANDATORY - Check dependency licenses before importing. Covers license compatibility (MIT, Apache, BSD, GPL), adding dependencies, bundled assets, writing original code, copyright. Triggers on go get, import, add dependency, license check, copy code.
HTTP handler patterns for Go 1.22+. Covers ServeMux method routing, path parameters, middleware, ResponseWriter wrapping, request context, graceful shutdown, error responses, handler naming conventions.
Error handling patterns for Go 1.20+. Covers errors.Is, errors.As, errors.Join, sentinel errors, error wrapping, multi-error, slog error logging, defer cleanup, error types vs sentinels, performance traps.
| name | refactor-check |
| description | Activate documentation freshness checks during refactoring. Use when renaming files, moving code between files, splitting/merging files, restructuring subsystems, deleting referenced files, or any work that changes file organization. |
| hooks | {"PostToolUse":[{"matcher":"Edit|Write","hooks":[{"type":"command","command":"$CLAUDE_SKILL_DIR/scripts/check-doc-proximity.sh"}]}],"Stop":[{"hooks":[{"type":"command","command":"$CLAUDE_SKILL_DIR/scripts/doc-check-on-stop.sh"}]}]} |
Refactoring mode active. Two on-demand hooks are now running:
PostToolUse — after editing structural files (server, config, cache, render, etc.) near a CLAUDE.md, a reminder is injected to check if the CLAUDE.md needs updating.
Stop — before finishing a response, checks if Go files were modified near a CLAUDE.md that wasn't also modified. Blocks until verified.
The hook lists specific CLAUDE.md files. For each one: read it, verify file references and key types are still accurate, and update if needed. If the CLAUDE.md is already correct, make a no-op edit (e.g., fix whitespace) so the hook passes.
