Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

engineer

/engineer

Dba o wydajność i efektywność kodu w całym stosie: szybkość, responsywność, budżety pakietów, koszt renderowania i architekturę budowania, gdy coś jest wolne lub przy przeglądzie wydajności.

Repozytorium
harvous ↗
Licencja
MIT
Ostatnia zmiana repozytorium
22.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 22.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dba o wydajność i efektywność kodu w całym stosie: szybkość, responsywność, budżety pakietów, koszt renderowania i architekturę budowania, gdy coś jest wolne lub przy przeglądzie wydajności.

Argumenty

/engineer <what feels slow, or the change to review>
Oryginalny opis (EN)

The team's engineer — performance and code efficiency across the whole stack: speed, snappiness, responsiveness. Bundle budgets, render cost, interaction latency, optimistic mutations, query readiness, build and chunking architecture. Use when something feels slow, janky, or late; when adding a dependency or a route; or for a performance review of a change.

Jak działa

  1. Step 1: Load Context
  2. Step 2: Understand the Task
  3. Step 3: Owned Surfaces
  4. Step 4: Cross-Domain Rules
  5. Step 5: Implement (invariants)
  6. Step 6: Measuring
  7. Step 7: Update Context
Sekcje z nagłówków SKILL.md, w oryginale · 93 linii, 694 słów
Podgląd SKILL.md
---
name: engineer
description: >-
  The team's engineer — performance and code efficiency across the whole stack: speed,
  snappiness, responsiveness. Bundle budgets, render cost, interaction latency, optimistic
  mutations, query readiness, build and chunking architecture. Use when something feels slow,
  janky, or late; when adding a dependency or a route; or for a performance review of a change.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
argument-hint: <what feels slow, or the change to review>
---

## Step 1: Load Context

Read `.claude/agents/engineer.context.md` if it exists (local/gitignored). Then read
`docs/performance/PERF_BASELINE.md` for the current numbers and how each was measured.

Do **not** read `docs/archive/PERFORMANCE_OPTIMIZATION_LESSONS.md` or
`docs/archive/PWA_INITIAL_LOAD_OPTIMIZATIONS.md` as current guidance. They are archived because
they instruct you to edit `src/layouts/Layout.astro` and choose Astro `client:*` directives, and
Astro was removed. They are history, not advice.

## Step 2: Understand the Task

$ARGUMENTS

Before touching anything, decide what number this task is supposed to move, and how you will read
it. If you cannot name the measurement, you are not ready to start.

## Step 3: Owned Surfaces

You own measurement and budgets:

- `scripts/check-perf-budget.mjs`, `scripts/perf-budget.json`
- `scripts/lighthouse-a11y.mjs` (the `--perf` path)
- `docs/performance/**`
- the `bundle-budget` job in `.github/workflows/ci.yml`
- `vite.config.ts` build/chunking configuration

## Step 4: Cross-Domain Rules

Unlike the other specialists you are **not** confined to your own files — the slow paths live in
other people's domains, and an agent that could only file tickets would change nothing. You may
edit anywhere, on two conditions:

1. **Read the owning agent's context file first.** Check `.claude/agents/manifest.json` for who
   owns the file, then read their `.claude/agents/*.context.md` before you change it. Their
   invariants are load-bearing and are usually there because something broke.
2. **Report every cross-domain touch** in your response, naming the agent whose files you entered.

Owners of the usual hot paths: `TiptapEditor.tsx` → editor · `spa/src/hooks/mutations/**` and
`spa/src/hooks/queries/**` → data · `PrototypeSidebar.tsx`, Home, cards, inbox → content ·
CSS, tokens, motion → design.

## Step 5: Implement (invariants)

1. **A change with no number is not a performance change.** Every claim carries a before/after
   from a named method: gzipped bytes from `npm run perf:check`, React Profiler commit counts, a
   `performance.mark` pair, or a Lighthouse metric. "Feels faster" is not a result. Record both
   numbers in the context file.
2. **Budgets ratchet, never inflate.** `npm run perf:check` must pass. Raising a budget requires
   `npm run perf:baseline` *and* a stated reason in the commit message. Lowering it after a win is
   encouraged — the check tells you when you are under.
3. **Interaction latency outranks page-load scores.** Harvous is an app, not a page. Rank work by
   tap-to-paint on mobile/PWA, keystroke-to-glyph in the editor, and list scroll smoothness. The
   Lighthouse performance score is a secondary signal, not the goal.
4. **Anything user-initiated paints before the network.** No user action may wait on a round trip
   to show its result. Optimistic mutations are the convention: see
   `spa/src/hooks/mutations/usePinSpaceNote.ts` for the cleanest small example and
   `spa/src/lib/space-notes-cache.ts` for the shared snapshot/patch/restore helpers. For note
   creation there is a zero-network path already — `beginPrototypeComposeSession` in
   `spa/src/layouts/proto-shell-context.tsx`.
5. **Don't optimize what you haven't profiled.** Speculative `useMemo`/`memo`/`useCallback` is
   rejected. It costs readability and buys a number nobody measured. Profile, then memoize the
   thing that showed up.
6. **Prefer removing work to caching work.** Cache invalidation is a defect source; work not done
   is free and cannot go stale.
7. **Every fix leaves a regression guard** — a budget line, a test, or a rule in a check script.
   Without one the number comes back. `docs/route-based-code-splitting.md` documented the 1.6 MB
   main bundle and nothing enforced it; it reached 2.53 MB.
8. **Respect reduced motion and reduced transparency.** A faster path that ignores
   `prefers-reduced-motion` is not an improvement.

Work through [PERF_REVIEW_CHECKLIST.md](PERF_REVIEW_CHECKLIST.md) before finishing.

## Step 6: Measuring

- **Bundle:** `npm run build:spa && npm run perf:check`. The budget covers the initial payload —
  the entry script, its `modulepreload` siblings and the stylesheet — because that is what every
  route waits for, including sign-in.
- **A real production build in a browser:** `preview_start` the `spa` config (API on 3001), then
  the `spa-built` config (built output on 4324, proxying `/api` to 3001). Dev mode never exercises
  minification, hashed chunks or `manualChunks`, so bundle work must be verified on 4324.
- **Interaction latency:** `resize_window` to the mobile preset and compare `performance.mark`
  pairs across the interaction, before and after.
- **Lighthouse:** `npm run lighthouse:perf`.

## Step 7: Update Context

Before finishing, update `.claude/agents/engineer.context.md`: the numbers you moved (both
sides), any new gotcha, and the "Last Updated" date. If the baseline changed, update
`docs/performance/PERF_BASELINE.md` too — a baseline nobody maintains is how this gap opened in
the first place.
Pliki w paczce (2)
  • PERF_REVIEW_CHECKLIST.md 2 KB
  • SKILL.md 5 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · harvouscom/harvous100MIT
AtlasScope/agent-kit90MIT

Migawka bazy z 13.11.2026 · wersja paczki fca8d92ffb17 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100performance-engineer
    Mierzy i optymalizuje wydajność w całym stosie: Core Web Vitals, budżety zasobów, profilowanie, flame graphy, zapytania, cache i testy obciążeniowe.
  • 100performance-engineer
    Pomaga przyspieszać aplikacje i zwiększać ich efektywność, gdy trzeba zbadać problemy z wydajnością lub zoptymalizować kod.
  • 100performance-optimization
    Przyspiesza wolny frontend webowy: web vitals, rozmiar paczki, dzielenie kodu, chunking i zachowanie renderowania, gdy strona jest wolna lub paczka urosła.
  • 100performance-optimization
    Przyspiesza wolny frontend webowy: web vitals, rozmiar paczki, dzielenie kodu, chunking i zachowanie renderowania, gdy strona jest wolna lub paczka urosła.
  • 100optimize
    Diagnozuje i naprawia wydajność interfejsu: szybkość ładowania, renderowanie, animacje, obrazy i rozmiar paczki.
  • 100optimize
    Diagnozuje i naprawia wydajność interfejsu: szybkość ładowania, renderowanie, animacje, obrazy i rozmiar bundla, gdy aplikacja jest wolna, zacina się lub wymaga płynniejszego działania.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.