Skip to content

feat: rules/ を現行モデル観点でスリム化(#117、v0.67.0)#132

Merged
okash1n merged 1 commit into
mainfrom
issue/117-rules-slim
Jun 12, 2026
Merged

feat: rules/ を現行モデル観点でスリム化(#117、v0.67.0)#132
okash1n merged 1 commit into
mainfrom
issue/117-rules-slim

Conversation

@okash1n

@okash1n okash1n commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

概要

LLM 性能監査計画 #121 の P4-11(#117)。常時注入される rules/ から、現行モデルに情報量のない行(harness 標準動作・デフォルト挙動の再記述、ルール作者向けメタ指示、開発規約の漏出)を削除する。10 → 8 ファイル。

変更内容

  • patterns.md 廃止: 「既存パターン踏襲」は harness 標準と重複、「詳細例は skills へ」はルール作者向けメタ指示の誤配置。有効な 2 行(抽象化の閾値・構造化パーサ優先)は coding-style.md へ統合
  • hooks.md 廃止: hook 作成時にしか意味のないリファレンスの常時注入。要点はリポジトリ CLAUDE.md の Hook Fragment Assembly 節へ移設(SessionStart/SessionEnd 用途限定行はキット自身の利用実態と矛盾するため削除)
  • agents.md: 8 領域列挙(agents/*.md description と完全重複・委譲バイアスの原因)を「Delegate to a subagent only when the task is large enough to amortize the overhead, or benefits from isolation or parallelism」に書換。反証検証で「残す」と判定された出力照合行(L6)は維持
  • 行単位削除: anti-patterns の「Load only task-relevant files…」(小コンテキスト時代の遺物)、coding-style の immutability 選好(JS テンプレ由来の越境・skills/coding-standards がオンデマンドでカバー)+ デフォルト挙動再掲 3 行、permissions-guide の回帰テスト義務(キット開発規約 — リポジトリ CLAUDE.md の Adding a New Feature 文脈へ移設)
  • 既存配備分(~/.claude/rules/patterns.md, hooks.md)は update の retired 掃除で自動除去(rules ツリーは managed tree のため追加実装不要 — レビューで確認済み)

検証

  • unit 342/342 / scenarios 44 Pass + 1 Skip / shellcheck green
  • 内部レビュー(code-reviewer agent): 指摘ゼロ(参照残・update 経路・README 整合・CHANGELOG 整合すべて確認済み)

Closes #117

- patterns.md 廃止(有効 2 行は coding-style.md へ統合)、hooks.md 廃止(要点は CLAUDE.md へ移設)
- agents.md を委譲閾値 + 出力照合の 2 行に書換
- anti-patterns / coding-style / permissions-guide から harness 標準・デフォルト挙動の再記述を削除
- README の rules 数を 10→8 に追随

Closes #117
Copilot AI review requested due to automatic review settings June 12, 2026 03:20
@okash1n okash1n merged commit 1dce317 into main Jun 12, 2026
11 checks passed
@okash1n okash1n deleted the issue/117-rules-slim branch June 12, 2026 03:22

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR reduces the always-injected rules/ footprint by removing low-signal or harness-duplicate guidance and relocating hook-authoring guidance to repository documentation, aligning the starter kit’s global rules with “current model” expectations.

Changes:

  • Retired rules/patterns.md and rules/hooks.md, consolidating the two useful “patterns” bullets into rules/coding-style.md and moving hook-authoring guidance into CLAUDE.md.
  • Slimmed always-loaded rules by deleting duplicated/default-behavior lines in rules/anti-patterns.md, rules/agents.md, rules/coding-style.md, and rules/permissions-guide.md.
  • Updated documentation and release notes to reflect the new “8 rules” set and added a 0.67.0 changelog entry.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file
File Description
rules/permissions-guide.md Removes regression-test instruction from always-loaded rules.
rules/patterns.md Retired; patterns guidance removed from global rules set.
rules/hooks.md Retired; hook-authoring guidance removed from global rules set.
rules/coding-style.md Slimmed and absorbs the two retained “patterns” bullets.
rules/anti-patterns.md Removes a low-signal context-discipline line.
rules/agents.md Replaces agent-use enumeration with a delegation threshold rule; keeps reconciliation guardrail.
README.md Updates rule count to 8 in directory structure overview.
README.en.md Updates rules list/count to 8 in features + directory structure.
CLAUDE.md Adds hook-authoring conventions and regression-test note as repo-level guidance.
CHANGELOG.md Adds 0.67.0 entry documenting rule slimming and retirements.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[P4-11] rules/ の現行モデル観点スリム化(情報量ゼロの常時注入行の削除)

2 participants