$npx -y skills add adobe/skills --skill performance-tuningOptimize performance of the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration for AEM 6.5 / AMS workflows only, with AMS-specific baseline and runtime verification.
| 1 | # Dispatcher Performance Tuning (AMS) |
| 2 | |
| 3 | Improve cache efficiency, latency, and throughput for AMS deployments that use the Adobe Dispatcher Apache HTTP Server module and related HTTPD configuration. |
| 4 | |
| 5 | ## Variant Scope |
| 6 | |
| 7 | - This skill is AMS-only. |
| 8 | - Scope is fixed by this skill directory; do not ask the user to choose deployment variant. |
| 9 | |
| 10 | ## MCP Tool Contract |
| 11 | |
| 12 | Use only these Dispatcher MCP tools: |
| 13 | |
| 14 | - `validate` |
| 15 | - `lint` |
| 16 | - `sdk` |
| 17 | - `trace_request` |
| 18 | - `inspect_cache` |
| 19 | - `monitor_metrics` |
| 20 | - `tail_logs` |
| 21 | |
| 22 | ## Workflow |
| 23 | |
| 24 | 1. Capture baseline metrics and cache evidence. |
| 25 | 2. Apply AMS 6.5 guardrails (tier boundaries, variable-driven config, flush ACL safety) to candidate optimizations. |
| 26 | 3. Prioritize low-risk/high-impact changes. |
| 27 | 4. Apply minimal edits. |
| 28 | 5. Verify with `validate`, `lint`, and `sdk`. |
| 29 | 6. Compare before/after runtime evidence. |
| 30 | |
| 31 | ## Verification Scope Selection |
| 32 | |
| 33 | Use shared references to select optimization evidence depth: |
| 34 | |
| 35 | - [mode-specific-verification-matrix.md](./references/dispatcher-foundation/mode-specific-verification-matrix.md) |
| 36 | - [test-case-catalog.md](./references/dispatcher-foundation/test-case-catalog.md) |
| 37 | |
| 38 | ## Output Contract |
| 39 | |
| 40 | Always return: |
| 41 | |
| 42 | - baseline metrics snapshot |
| 43 | - prioritized optimization list with impact/risk |
| 44 | - changed files and intent |
| 45 | - executed checks + before/after evidence |
| 46 | - selected test IDs and outcomes |
| 47 | - rollback plan and open risks |
| 48 | |
| 49 | ## Guardrails |
| 50 | |
| 51 | - Do not claim improvement without measurable comparison. |
| 52 | - Keep high-risk tuning opt-in unless user explicitly requests it. |
| 53 | - Keep AMS assumptions explicit for each recommendation batch. |
| 54 | |
| 55 | ## References |
| 56 | |
| 57 | - [optimization-patterns.md](./references/performance-tuning/optimization-patterns.md) |
| 58 | - [performance-scenario-playbooks.md](./references/performance-tuning/performance-scenario-playbooks.md) – scenario-driven tuning flows adapted from broader MCP prompt surfaces |
| 59 | - [load-testing-guidance.md](./references/performance-tuning/load-testing-guidance.md) |
| 60 | - [performance-monitoring-setup.md](./references/performance-tuning/performance-monitoring-setup.md) |
| 61 | - [quick-start-execution-path.md](./references/dispatcher-foundation/quick-start-execution-path.md) – fast entry path for optimization requests |
| 62 | - [repo-layout-workflows.md](./references/dispatcher-foundation/repo-layout-workflows.md) – map performance findings to cache, farm, vhost, rewrite, and variable file families |
| 63 | - [playbook-command-linkage.md](./references/dispatcher-foundation/playbook-command-linkage.md) – exact MCP command chains for tuning playbooks |
| 64 | - [ams-6-5-guardrails.md](./references/dispatcher-foundation/ams-6-5-guardrails.md) |
| 65 | - [mode-specific-verification-matrix.md](./references/dispatcher-foundation/mode-specific-verification-matrix.md) |
| 66 | - [test-case-catalog.md](./references/dispatcher-foundation/test-case-catalog.md) |
| 67 | - [change-risk-and-rollback-template.md](./references/dispatcher-foundation/change-risk-and-rollback-template.md) |
| 68 | - [public-docs-index.md](./references/dispatcher-foundation/public-docs-index.md) |
| 69 | - [public-doc-citation-rules.md](./references/dispatcher-foundation/public-doc-citation-rules.md) |
| 70 | - [core-7-tools-reference.md](./references/dispatcher-foundation/core-7-tools-reference.md) |