mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-06-11 02:33:10 +08:00

Files

konstapukarifastnetfi 8b24f63ede fix: refresh stale technical content in agents, rules, and skills (#2168 )

Several published examples contained APIs that no longer exist, code that
does not run, or model versions that drifted from reality:

- agents/performance-optimizer.md used the web-vitals v3 API
  (getCLS/getFID/getLCP/getFCP/getTTFB) and reported FID. web-vitals v4
  renamed the imports to onCLS/onINP/onLCP/onFCP/onTTFB and FID was
  replaced by INP (target < 200ms)
- rules/common/performance.md pinned stale model versions in the
  model-selection guidance; refresh to the versions the repo itself uses
  (agent.yaml pins claude-opus-4-6) and add the PowerShell variant for
  MAX_THINKING_TOKENS next to the bash export
- skills/python-patterns/SKILL.md: both get_value examples referenced
  default_value without declaring the parameter (NameError); add
  default_value: Any = None to the EAFP and LBYL signatures
- skills/frontend-patterns/SKILL.md: the custom useQuery example rebuilt
  refetch whenever callers passed inline fetchers/options, re-triggering
  the effect after every state update (infinite fetch loop). Keep the
  latest fetcher/options in refs so refetch stays referentially stable.
  The PASS-labelled useMemo example mutated its input with in-place sort;
  copy before sorting
- skills/coding-standards/SKILL.md repeated the same PASS-labelled
  in-place-sort-in-useMemo example; same fix
- rules/typescript/security.md used a vendor-specific OPENAI_API_KEY in
  generic guidance; switch to a neutral API_KEY

Every hand-maintained copy of the affected content is synced in the same
change: locale mirrors (ja-JP, ko-KR, pt-BR, tr, zh-CN, zh-TW - each only
where it carries the affected file) and the .agents/.kiro/.cursor harness
mirrors. Two structural divergences are left alone and noted here:
.kiro/steering/performance.md has no extended-thinking control list to
carry the PowerShell variant, and docs/zh-TW/rules/performance.md keeps an
older condensed thinking section without the budget-cap line.
rules/zh/performance.md is intentionally untouched - the rules/zh tree is
being retired in a separate change

2026-06-07 13:26:01 +08:00

1.6 KiB

Raw Blame History

Performance Optimization

Model Selection Strategy

Haiku 4.5 (90% of Sonnet capability, 3x cost savings):

Lightweight agents with frequent invocation
Pair programming and code generation
Worker agents in multi-agent systems

Sonnet 4.6 (Best coding model):

Main development work
Orchestrating multi-agent workflows
Complex coding tasks

Opus 4.6 (Deepest reasoning):

Complex architectural decisions
Maximum reasoning requirements
Research and analysis tasks

Context Window Management

Avoid last 20% of context window for:

Large-scale refactoring
Feature implementation spanning multiple files
Debugging complex interactions

Lower context sensitivity tasks:

Single-file edits
Independent utility creation
Documentation updates
Simple bug fixes

Extended Thinking + Plan Mode

Extended thinking is enabled by default, reserving up to 31,999 tokens for internal reasoning.

Control extended thinking via:

Toggle: Option+T (macOS) / Alt+T (Windows/Linux)
Config: Set alwaysThinkingEnabled in ~/.claude/settings.json
Budget cap: export MAX_THINKING_TOKENS=10000 (bash) or $env:MAX_THINKING_TOKENS = "10000" (PowerShell)
Verbose mode: Ctrl+O to see thinking output

For complex tasks requiring deep reasoning:

Ensure extended thinking is enabled (on by default)
Enable Plan Mode for structured approach
Use multiple critique rounds for thorough analysis
Use split role sub-agents for diverse perspectives

Build Troubleshooting

If build fails:

Use build-error-resolver agent
Analyze error messages
Fix incrementally
Verify after each fix

1.6 KiB Raw Blame History