vkc-perf-budget

name: vkc-perf-budget description: Performance and bundle-size budget workflow for VKC (perf:collect, perf:compare, perf:gate, bundle size, shared first load js). Use when changes may affect build output size or performance. (키워드= 성능, 번들 사이즈, 퍼포먼스, perf:gate, shared first load js, 빌드 메트릭) metadata: short-description: Perf budget + gate

VKC Performance Budget

When to use

• You add a new dependency or a large UI surface.
• You touch layout/shell components used on many routes.
• You suspect "shared first load js" or route entry sizes may change.

Commands (this repo)

• Collect: npm run perf:collect
  • Writes: docs/perf/latest-bundle-report.json
• Compare: npm run perf:compare
  • Writes: docs/perf/latest-bundle-diff.json
• Gate (collect + compare w/ fail): npm run perf:gate

Canonical references

• Collector: scripts/perf/collect-build-metrics.mjs
• Comparator: scripts/perf/compare-build-metrics.mjs
• Scripts: package.json (perf:*)

References

• Budget runbook: .codex/skills/vkc-perf-budget/references/perf-budget.md