Skip to content

chore(claude): optimize config for agentic coding#606

Merged
Chemaclass merged 9 commits intomainfrom
chore/improve-agentic-config
Mar 14, 2026
Merged

chore(claude): optimize config for agentic coding#606
Chemaclass merged 9 commits intomainfrom
chore/improve-agentic-config

Conversation

@Chemaclass
Copy link
Copy Markdown
Member

Background

Optimize the .claude/ configuration for better agentic performance with Claude Opus. Rules and skills were bloated with generic knowledge that Opus already has, wasting context window on every conversation.

Changes

  • Trim rules from ~1,268 to ~230 lines and skills from ~1,490 to ~310 lines by removing generic Bash/TDD knowledge
  • Add PostToolUse hook for instant shellcheck feedback after .sh file edits
  • Align PR template with /pr skill format, add .shellcheckrc, fix false pre-push hook docs
  • Remove always-on @ includes from CLAUDE.md — rules now auto-load via path-scoped frontmatter

Rules reduced from ~1,268 to ~230 lines. Opus doesn't need verbose
examples of generic Bash/TDD knowledge — only project-specific
conventions and constraints.
Skills reduced from ~1,490 to ~310 lines total. Removed generic
instructions Opus already knows, verbose example blocks, and dead
@AGENTS.md references.
Auto-runs shellcheck on .sh files after Edit/Write tool calls,
catching issues immediately instead of waiting for commit-time.
Sync the GitHub PR template structure (Background + Changes) with
what the /pr skill generates, ensuring consistency.
Codifies source-path and external-sources settings so shellcheck
behaves consistently across CLI, hooks, and CI.
Task files add friction for small fixes. Now recommended for
non-trivial changes only, skippable for single-test bug fixes.
No pre-push hook exists — the pre-commit hook handles quality
checks. Updated docs to reflect actual hook setup.
Rules have paths: frontmatter that auto-loads them when editing
matching files. The @ references in CLAUDE.md force-loaded all
rules in every conversation, wasting context.
@Chemaclass Chemaclass added the refactoring Refactoring or cleaning related label Mar 14, 2026
@Chemaclass Chemaclass self-assigned this Mar 14, 2026
@Chemaclass Chemaclass added the refactoring Refactoring or cleaning related label Mar 14, 2026
@github-actions
Copy link
Copy Markdown
Contributor

✅ Contributor Report

User: @Chemaclass
Status: Trusted contributor (whitelisted)

This user is on the trusted contributors list and was automatically approved.

@Chemaclass Chemaclass merged commit 0d4faac into main Mar 14, 2026
27 checks passed
@Chemaclass Chemaclass deleted the chore/improve-agentic-config branch March 14, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

refactoring Refactoring or cleaning related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant