SKILL.md
381 tokens · o200k_base · 1,925 bytes
but CLI performance tests
Read performance framework documentation completely before answering questions or changing performance scenarios. Inspect nearby scenarios and current shared helpers as applicable; README is canonical source for framework behavior, commands, helper APIs, and debugging options.
Workflow for changes
- Confirm requested operation and timing boundary.
- Inspect closest existing scenarios plus
lib.shandrun.sh. - Add or update only scenario's
setup.shandtest.shunless shared behavior is genuinely required. - Prefer real, representative GitButler repository state over toy data.
- Keep setup, validation, and ID discovery outside timed operation.
- Reuse documented helpers instead of creating parallel fixture, state, output, or timing mechanisms.
- List every scenario in top-level performance README's included-scenario list, and update its entry when materially changing scenario.
- Run README's shell validation and short single-scenario benchmark.
For usage or debugging questions, answer from current README and scripts. Do not edit files unless user asks for changes.
Guardrails
- Keep changes inside
crates/but/tests/performance/unless task specifically requests related documentation or skill updates. - Preserve two-file scenario contract.
- Do not add custom timing/statistics code; Hyperfine owns measurement.
- Do not include fixture setup or compilation in measured command.
- Do not run all scenarios when user requests or changes only one.
- Report fixture/setup limitations and unavailable validation explicitly.
Discovery context
Discovered by repository scan. No exact path reference found in the snapshot’s root AGENTS.md.