mindtickle-performance-tuning

v2026.09.24

Diagnose and improve a Mindtickle integration with measured latency, backlog, freshness, and reconciliation evidence. Use when reports or syncs miss objectives. Trigger with "tune Mindtickle performance".

GitHub
安装命令
npx skhub add jeremylongshore/mindtickle-performance-tuning
Markdown
SKILL.md

Evidence-Driven Mindtickle Integration Performance

Overview

Improve the customer-controlled integration path from a reproducible baseline while respecting tenant contracts, privacy, freshness, and correctness.

Prerequisites

  • A service-level objective, representative workload, current contract digest, and observation window
  • Metrics for latency, attempts, errors, retries, backlog age, throughput, freshness, and reconciliation
  • A non-production load path or approved canary with explicit abort thresholds

Tool Discipline

Use Read, Glob, and Grep to inspect traces and configuration, WebFetch for current authorized contracts, and Write or Edit for benchmarks, controlled changes, tests, and redacted receipts.

Current Contract

Performance spans the customer application, network, identity, adapter, tenant operations, and downstream systems. Mindtickle states support for scalable integrations but does not publish universal latency or quota targets, so customer objectives and tenant-specific evidence must remain separate.

Authentication

Benchmark with synthetic or aggregate data and a least-privilege non-production principal. Never use extra credentials to create artificial concurrency or include payload contents in traces.

Instructions

  1. Define the user or business symptom, objective, correctness invariant, workload, and baseline window.
  2. Break elapsed time into queue, customer processing, network, tenant response, downstream processing, and reconciliation.
  3. Segment by operation, page or batch, payload class, tenant, response class, and time without exposing personal data.
  4. Rank bottlenecks by measured contribution and distinguish latency from throttling, backlog, and data-quality delay.
  5. Propose one controlled change at a time: scheduling, bounded concurrency, pagination, batching, caching, indexing, or payload reduction only where the contract permits it.
  6. Define cache ownership, freshness, invalidation, privacy, and stale-data behavior before enabling a cache.
  7. Run the experiment within abort thresholds and compare p50, tail latency, errors, retries, backlog, freshness, and reconciliation.
  8. Retain the change only when the improvement is repeatable and correctness is unchanged; otherwise roll back.

Approval Boundaries

Do not load-test production, raise concurrency, retain learner data in a cache, or trade correctness for speed without explicit owners.

Output

Return the objective, baseline, bottleneck evidence, experiment, approvals, before-and-after metrics, correctness reconciliation, decision, and rollback receipt.

Error Handling

ConditionResponse
Metrics omit queue or retry timeRepair instrumentation before claiming improvement.
Vendor behavior changes during a testStop, preserve the window, and rerun after the contract is stable.
Faster run produces divergent dataRoll back immediately and investigate correctness first.

Example

objective=freshness-under-target; baseline=7d; bottleneck=customer-queue; change=schedule-partition; tail-latency=improved; reconciliation=exact

Resources

Next Steps

Observe the retained change for a full workload cycle and update the capacity policy with measured evidence.

发现
标签

此技能尚未发布标签。

版本
最新版本元数据

版本

v2026.09.24

发布时间

2026年9月24日

分类

未分类

许可证

MIT

源路径

skills/.curated/mindtickle-performance-tuning

默认分支

main

最新提交

e5a6c3b

Tree SHA

c2dc8e8