Skip to content

chore: tune .claude/ for speed without sacrificing quality#2459

Merged
aalemayhu merged 1 commit into
mainfrom
chore/claude-setup-speed-tune
May 19, 2026
Merged

chore: tune .claude/ for speed without sacrificing quality#2459
aalemayhu merged 1 commit into
mainfrom
chore/claude-setup-speed-tune

Conversation

@aalemayhu
Copy link
Copy Markdown
Contributor

@aalemayhu aalemayhu commented May 19, 2026

Summary

Audit of .claude/ config focused on response speed and cost without trading output quality. Three high-impact, low-risk changes applied — the rest of the audit (CLAUDE.md consolidation, pm WebFetch removal, effort: low frontmatter on mechanical agents) is held for a follow-up.

Changes

  1. designer agent: opus → sonnet. Designer work in this repo is dominated by checklist evaluation (review-scoring order, banned-words sweep, action-hierarchy check). Sonnet handles this without measurable quality cost. Paid on every trio fan-out.

  2. trio_check.sh: narrow the heuristic. The hook injected a <trio_required> reminder on any product-keyword match. Adding a tooling/CI/dependency/.claude/ exclusion ahead of the keyword check — every false positive previously cost a full trio (opus + opus + sonnet, full prompts each), so the asymmetry favors a tighter guard.

  3. Cut duplicated sections from engineer.md, pm.md, _trio.md. Removed ~61 lines of content already loaded via CLAUDE.md imports or covered by slash commands:

    • engineer.md: "Reviewing PRs" (lives in /review-pr), "Security guardrails (from CLAUDE.md)" (literal duplicate of .claude/rules/security.md), most of "Framework-specific patterns" (kept the non-obvious gotchas: ErrorHandler signature, React 19 forwardRef, REACT_APP_* env prefix, Jest-vs-Vitest, create_deck/ JSON contract).
    • pm.md: "Technical landscape" (duplicates CLAUDE.md tech stack).
    • _trio.md: ship-ready gate collapsed from a bullet list to one paragraph.

What was deliberately left for a follow-up

  • CLAUDE.md "Trio review policy" / "Spec lifecycle" consolidation — flagged as "minor changes, confirm direction" in the audit.
  • Remove WebFetch from pm's tool list (forces gh issue view consistency).
  • Add effort: low to dead-code-auditor, dependabot-triage, /check, /pr-checks (no-op if the runtime doesn't honor effort:).
  • worktree.sparsePaths for test-writer and batch-tasks/dependabot (no-op if unsupported).

Test plan

  • Spawn the designer subagent on a small UX-review task and confirm the output quality is consistent with prior runs.
  • Send a prompt about .claude/ config and confirm the trio reminder no longer fires.
  • Send a normal product prompt ("add a button to the upload page") and confirm the trio reminder still fires.
  • Spawn engineer on a standard implementation task and confirm it still picks up framework gotchas (Express 5 `ErrorHandler` signature, React 19 `forwardRef`, Jest-vs-Vitest) via the trimmed prompt + the `.claude/rules/` imports.

🤖 Generated with Claude Code


View in Codesmith
Need help on this PR? Tag @codesmith with what you need.

  • Let Codesmith autofix CI failures and bot reviews

- designer agent: opus → sonnet (checklist-driven work, no measurable quality cost)
- trio_check.sh: skip the reminder on internal tooling, hooks, rules, dependency, and .claude/ prompts (false-positives wasted a full trio fan-out per fire)
- engineer.md: drop sections duplicated from CLAUDE.md / .claude/rules/ / /review-pr (security guardrails, framework-specific patterns, contributor-PR review flow)
- pm.md: drop "Technical landscape" — CLAUDE.md already carries the tech stack
- _trio.md: collapse the ship-ready gate into one paragraph

Net: ~61 lines off the per-fork hot path; designer routed through sonnet; meta-tooling prompts no longer auto-trigger the trio.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented May 19, 2026

Deploy Preview for notion2anki ready!

Name Link
🔨 Latest commit 97b83b7
🔍 Latest deploy log https://app.netlify.com/projects/notion2anki/deploys/6a0c7cfbfe66f800083aaa37
😎 Deploy Preview https://deploy-preview-2459--notion2anki.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@sonarqubecloud
Copy link
Copy Markdown

@aalemayhu aalemayhu marked this pull request as ready for review May 19, 2026 15:11
@aalemayhu aalemayhu merged commit ece8e40 into main May 19, 2026
11 checks passed
@aalemayhu aalemayhu deleted the chore/claude-setup-speed-tune branch May 19, 2026 15:12
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.

1 participant