@apexops/cli 0.10.0-next.5 → 0.11.0-next.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/capability-packs/registry.v1.json +1 -62
- package/assets/client-projection-metadata/copilot-cli-agent-tools.json +12 -0
- package/assets/client-projections/github-copilot-cli/.github/copilot/settings.json +13 -0
- package/assets/client-projections/github-copilot-cli/.github/instructions/apex-prompt-authoring.instructions.md +1 -1
- package/assets/client-projections/github-copilot-cli/.github/workflows/governance-policy-baseline.yml +101 -0
- package/assets/client-projections/github-copilot-cli/tools/schemas/governance-baseline.schema.json +118 -0
- package/assets/client-projections/github-copilot-cli/tools/scripts/collect-governance-baseline.ps1 +817 -0
- package/assets/config/capability-packs.v1.json +1 -32
- package/assets/config/governance-reference.v1.json +26379 -0
- package/assets/config/recipe-packs.v1.json +1 -26
- package/assets/config/runtime-bundle.v1.json +7 -7
- package/assets/config/toolchain.v1.json +35 -33
- package/assets/config/workflow.v1.json +103 -72
- package/assets/customizations/.github/agents/apex-codegen.agent.md +8 -22
- package/assets/customizations/.github/agents/apex-validator.agent.md +14 -20
- package/assets/customizations/.github/agents/apex.agent.md +108 -75
- package/assets/customizations/.github/copilot/settings.json +13 -0
- package/assets/customizations/.github/instructions/apex-prompt-authoring.instructions.md +1 -1
- package/assets/customizations/.github/skills/apex-architecture/SKILL.md +62 -18
- package/assets/customizations/.github/skills/apex-artifacts/SKILL.md +28 -6
- package/assets/customizations/.github/skills/apex-azure-adr/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-cloud-migrate/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-compliance/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-compute/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-cost-optimization/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-defaults/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-defaults/references/governance-effects.md +5 -3
- package/assets/customizations/.github/skills/apex-azure-deploy/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-diagnostics/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-governance/SKILL.md +19 -3
- package/assets/customizations/.github/skills/apex-azure-governance/references/evidence-interpretation.md +38 -3
- package/assets/customizations/.github/skills/apex-azure-kusto/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-prepare/SKILL.md +5 -3
- package/assets/customizations/.github/skills/apex-azure-quotas/SKILL.md +6 -2
- package/assets/customizations/.github/skills/apex-azure-quotas/references/capacity-decision-rules.md +4 -3
- package/assets/customizations/.github/skills/apex-azure-quotas/references/operational-checklist.md +3 -2
- package/assets/customizations/.github/skills/apex-azure-rbac/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-resources/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-storage/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-validate/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-bicep-patterns/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-codegen/SKILL.md +6 -2
- package/assets/customizations/.github/skills/apex-entra-app-registration/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-mermaid/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-microsoft-docs/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-next/SKILL.md +99 -0
- package/assets/customizations/.github/skills/apex-operations/SKILL.md +46 -16
- package/assets/customizations/.github/skills/apex-planning/SKILL.md +48 -19
- package/assets/customizations/.github/skills/apex-requirements/SKILL.md +61 -26
- package/assets/customizations/.github/skills/apex-terraform-import/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-terraform-patterns/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-terraform-test/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-unslop/LICENSE.txt +21 -0
- package/assets/customizations/.github/skills/apex-unslop/SKILL.md +94 -0
- package/assets/customizations/.github/skills/apex-workflow/SKILL.md +15 -5
- package/assets/customizations/.github/workflows/governance-policy-baseline.yml +101 -0
- package/assets/customizations/README.md +8 -9
- package/assets/customizations/manifest.json +167 -209
- package/assets/customizations/tools/schemas/governance-baseline.schema.json +118 -0
- package/assets/customizations/tools/scripts/collect-governance-baseline.ps1 +817 -0
- package/assets/manifest.json +423 -4241
- package/assets/schemas/governance-baseline.schema.json +118 -0
- package/dist/assets.d.ts +18 -2
- package/dist/assets.js +115 -35
- package/dist/bootstrap-wizard.d.ts +37 -0
- package/dist/bootstrap-wizard.js +259 -0
- package/dist/cli.d.ts +17 -2
- package/dist/cli.js +180 -63
- package/dist/dependency-revision.js +8 -0
- package/dist/errors.d.ts +6 -1
- package/dist/errors.js +55 -0
- package/dist/host-profile.d.ts +47 -0
- package/dist/host-profile.js +269 -0
- package/dist/mcp-output-schemas.d.ts +43 -0
- package/dist/mcp-output-schemas.js +279 -0
- package/dist/mcp-tool-effects.d.ts +101 -0
- package/dist/mcp-tool-effects.js +66 -0
- package/dist/mcp.d.ts +50 -3
- package/dist/mcp.js +800 -87
- package/dist/runtime-binding.d.ts +37 -0
- package/dist/runtime-binding.js +131 -0
- package/dist/service.d.ts +643 -38
- package/dist/service.js +4937 -662
- package/dist/state-transfer.js +21 -1
- package/dist/target-scope.d.ts +4 -0
- package/dist/target-scope.js +9 -0
- package/dist/version.d.ts +3 -1
- package/dist/version.js +19 -1
- package/dist/workflow-validators.d.ts +20 -3
- package/dist/workflow-validators.js +408 -67
- package/dist/workspace-root.d.ts +7 -0
- package/dist/workspace-root.js +67 -0
- package/package.json +11 -12
- package/assets/capability-packs/azure-governance-discovery/source/scripts/discover.py +0 -1189
- package/assets/capability-packs/azure-governance-discovery/source/scripts/render_governance.py +0 -676
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-architect.agent.md +0 -91
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-operator.agent.md +0 -75
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-planner.agent.md +0 -88
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-requirements.agent.md +0 -99
- package/assets/client-projections/github-copilot-cli/.github/agents/apex.agent.md +0 -88
- package/assets/client-projections/github-copilot-cli/.github/mcp.json +0 -65
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-architecture/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/SKILL.md +0 -65
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/references/presentation-conventions.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/references/reference-only-outlines.md +0 -78
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/architecture-assessment.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/cost-estimate.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/deployment-summary.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/governance-constraints.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/implementation-plan.md +0 -43
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/operations-runbook.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/requirements.md +0 -42
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/resource-inventory.md +0 -29
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-examples.md +0 -38
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-guardrails.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-quality.md +0 -21
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-record-fields.md +0 -57
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/SKILL.md +0 -55
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/lambda-to-functions-assessment.md +0 -29
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/migration-readiness.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/staged-validation-handoff.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/workload-mapping.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compliance/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compliance/references/compliance-finding-criteria.md +0 -63
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compliance/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/references/compute-selection.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/references/pricing-evidence.md +0 -11
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/references/recommendation-and-scale-rules.md +0 -44
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cost-optimization/SKILL.md +0 -61
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cost-optimization/references/cost-assessment-criteria.md +0 -61
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cost-optimization/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/SKILL.md +0 -59
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/avm-binding-guidance.md +0 -29
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/baseline-fallbacks.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/cost-monitoring.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/decision-boundaries.md +0 -19
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/governance-effects.md +0 -28
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/naming.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/network-planning.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/security-baseline.md +0 -40
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/service-selection.md +0 -51
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/tag-precedence.md +0 -31
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-deploy/SKILL.md +0 -50
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-deploy/references/operational-checklist.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-deploy/references/preview-recovery-verification.md +0 -48
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-diagnostics/SKILL.md +0 -60
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-diagnostics/references/diagnostic-interpretation.md +0 -42
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-diagnostics/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-governance/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-governance/references/evidence-interpretation.md +0 -58
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-governance/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-kusto/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-kusto/references/kql-evidence-interpretation.md +0 -41
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-kusto/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-prepare/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-prepare/references/functions-recipe-pack.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-prepare/references/preparation-lineage.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-quotas/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-quotas/references/capacity-decision-rules.md +0 -48
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-quotas/references/operational-checklist.md +0 -23
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-rbac/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-rbac/references/assignment-intent.md +0 -39
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-rbac/references/least-privilege-selection.md +0 -50
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-resources/SKILL.md +0 -54
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-resources/references/inventory-query-patterns.md +0 -49
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-resources/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/SKILL.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/references/security-and-governance.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/references/service-auth-and-sdk-boundary.md +0 -33
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/references/storage-selection.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-validate/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-validate/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-validate/references/preflight-evidence.md +0 -43
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/SKILL.md +0 -41
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/avm-and-codegen-acceptance.md +0 -11
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/codegen-acceptance-checklist.md +0 -46
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/compiler-and-provider-gotchas.md +0 -74
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/module-interfaces-and-parameters.md +0 -56
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/network-and-observability.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-codegen/SKILL.md +0 -32
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/capability-receipts.md +0 -21
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/design-and-diagnostics.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/oauth-registration-model.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/permissions-and-credentials.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-mermaid/SKILL.md +0 -44
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-mermaid/references/styling.md +0 -33
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-mermaid/references/syntax.md +0 -99
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-microsoft-docs/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-microsoft-docs/references/research-method.md +0 -91
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-operations/SKILL.md +0 -34
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-planning/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-requirements/SKILL.md +0 -46
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/SKILL.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/adoption-attestation.md +0 -10
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/import-assessment.md +0 -14
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/import-mapping.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/mapping-and-adoption-attestation.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/module-composition-and-refactor.md +0 -20
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/module-composition-and-state-boundaries.md +0 -11
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/module-locks-and-codegen-acceptance.md +0 -14
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/network-and-observability.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/plan-and-change-assessment.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/evidence-acceptance.md +0 -10
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/plan-mode-and-mock-design.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/plan-mode-test-design.md +0 -23
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/test-design.md +0 -13
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-workflow/SKILL.md +0 -37
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-architect.agent.md +0 -100
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-codegen.agent.md +0 -62
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-operator.agent.md +0 -79
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-planner.agent.md +0 -98
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-requirements.agent.md +0 -108
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-reviewer.agent.md +0 -63
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-validator.agent.md +0 -61
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex.agent.md +0 -107
- package/assets/client-projections/github-copilot-vscode/.github/copilot-instructions.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-agent-authoring.instructions.md +0 -14
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-artifact-contracts.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-automation.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-azure-yaml.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-bicep.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-code-quality.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-context.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-documentation.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-governance.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-instruction-authoring.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-javascript.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-json.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-markdown.instructions.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-powershell.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-prompt-authoring.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-python.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-file-edits.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-shell.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-shell.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-skill-authoring.instructions.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-terraform.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-architecture/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/SKILL.md +0 -65
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/references/presentation-conventions.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/references/reference-only-outlines.md +0 -78
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/architecture-assessment.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/cost-estimate.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/deployment-summary.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/governance-constraints.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/implementation-plan.md +0 -43
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/operations-runbook.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/requirements.md +0 -42
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/resource-inventory.md +0 -29
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-examples.md +0 -38
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-guardrails.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-quality.md +0 -21
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-record-fields.md +0 -57
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/SKILL.md +0 -55
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/lambda-to-functions-assessment.md +0 -29
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/migration-readiness.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/staged-validation-handoff.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/workload-mapping.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compliance/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compliance/references/compliance-finding-criteria.md +0 -63
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compliance/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/references/compute-selection.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/references/pricing-evidence.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/references/recommendation-and-scale-rules.md +0 -44
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cost-optimization/SKILL.md +0 -61
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cost-optimization/references/cost-assessment-criteria.md +0 -61
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cost-optimization/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/SKILL.md +0 -59
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/avm-binding-guidance.md +0 -29
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/baseline-fallbacks.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/cost-monitoring.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/decision-boundaries.md +0 -19
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/governance-effects.md +0 -28
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/naming.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/network-planning.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/security-baseline.md +0 -40
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/service-selection.md +0 -51
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/tag-precedence.md +0 -31
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/SKILL.md +0 -50
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/references/operational-checklist.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/references/preview-recovery-verification.md +0 -48
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-diagnostics/SKILL.md +0 -60
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-diagnostics/references/diagnostic-interpretation.md +0 -42
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-diagnostics/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-governance/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-governance/references/evidence-interpretation.md +0 -58
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-governance/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/references/kql-evidence-interpretation.md +0 -41
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-prepare/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-prepare/references/functions-recipe-pack.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-prepare/references/preparation-lineage.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-quotas/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-quotas/references/capacity-decision-rules.md +0 -48
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-quotas/references/operational-checklist.md +0 -23
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-rbac/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-rbac/references/assignment-intent.md +0 -39
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-rbac/references/least-privilege-selection.md +0 -50
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-resources/SKILL.md +0 -54
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-resources/references/inventory-query-patterns.md +0 -49
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-resources/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/SKILL.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/references/security-and-governance.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/references/service-auth-and-sdk-boundary.md +0 -33
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/references/storage-selection.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/references/preflight-evidence.md +0 -43
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/SKILL.md +0 -41
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/avm-and-codegen-acceptance.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/codegen-acceptance-checklist.md +0 -46
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/compiler-and-provider-gotchas.md +0 -74
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/module-interfaces-and-parameters.md +0 -56
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/network-and-observability.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-codegen/SKILL.md +0 -32
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/capability-receipts.md +0 -21
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/design-and-diagnostics.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/oauth-registration-model.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/permissions-and-credentials.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-mermaid/SKILL.md +0 -44
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-mermaid/references/styling.md +0 -33
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-mermaid/references/syntax.md +0 -99
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-microsoft-docs/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-microsoft-docs/references/research-method.md +0 -91
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-operations/SKILL.md +0 -34
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-planning/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-requirements/SKILL.md +0 -46
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/SKILL.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/adoption-attestation.md +0 -10
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/import-assessment.md +0 -14
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/import-mapping.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/mapping-and-adoption-attestation.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/module-composition-and-refactor.md +0 -20
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/module-composition-and-state-boundaries.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/module-locks-and-codegen-acceptance.md +0 -14
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/network-and-observability.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/plan-and-change-assessment.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/evidence-acceptance.md +0 -10
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/plan-mode-and-mock-design.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/plan-mode-test-design.md +0 -23
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/test-design.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-workflow/SKILL.md +0 -37
- package/assets/client-projections/github-copilot-vscode/.vscode/mcp.json +0 -29
- package/assets/customizations/.github/agents/apex-architect.agent.md +0 -93
- package/assets/customizations/.github/agents/apex-operator.agent.md +0 -72
- package/assets/customizations/.github/agents/apex-planner.agent.md +0 -91
- package/assets/customizations/.github/agents/apex-requirements.agent.md +0 -101
- package/assets/customizations/.github/agents/apex-reviewer.agent.md +0 -60
- package/assets/customizations/.github/mcp.json +0 -65
- package/assets/customizations/.github/skills/apex-azure-prepare/references/functions-recipe-pack.md +0 -27
- package/assets/customizations/.vscode/mcp.json +0 -29
- package/dist/azure-mcp-environment.d.ts +0 -2
- package/dist/azure-mcp-environment.js +0 -7
- package/dist/azure-mcp.d.ts +0 -2
- package/dist/azure-mcp.js +0 -21
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
# Service Selection And WAF Criteria
|
|
2
|
-
|
|
3
|
-
Use service classes as candidates, not predetermined recommendations. Select services only when requirements, accepted
|
|
4
|
-
cost/availability evidence, governance, and architecture decisions support them.
|
|
5
|
-
|
|
6
|
-
## Elicit Before Selecting
|
|
7
|
-
|
|
8
|
-
Capture workload pattern, application layers, availability and recovery objectives, compute model, relational and
|
|
9
|
-
non-relational data needs, storage semantics, messaging, ingress, observability, compliance, team capability, and known
|
|
10
|
-
SKU or commitment preferences. Treat "no preference" as permission to evaluate, not permission to pick from memory.
|
|
11
|
-
|
|
12
|
-
Do not infer compliance solely from industry, choose an enterprise tier solely from company size, or recommend
|
|
13
|
-
Kubernetes when operational requirements do not justify it.
|
|
14
|
-
|
|
15
|
-
## Candidate Evaluation
|
|
16
|
-
|
|
17
|
-
For each service candidate, compare:
|
|
18
|
-
|
|
19
|
-
- Requirement coverage and workload fit
|
|
20
|
-
- Security and identity model
|
|
21
|
-
- Network and data residency constraints
|
|
22
|
-
- Availability, recovery, and scalability objectives
|
|
23
|
-
- Accepted regional availability, quota, lifecycle, and cost evidence
|
|
24
|
-
- Operational burden, ownership, support model, and migration constraints
|
|
25
|
-
- Module/provider support and implementation constraints
|
|
26
|
-
|
|
27
|
-
Keep at least one viable alternative when the decision is material. Reject candidates with a reason tied to a
|
|
28
|
-
requirement, policy, lifecycle limitation, or WAF consequence.
|
|
29
|
-
|
|
30
|
-
## Well-Architected Questions
|
|
31
|
-
|
|
32
|
-
| Pillar | Decision prompt |
|
|
33
|
-
| --- | --- |
|
|
34
|
-
| Security | Does the candidate support the required identity, encryption, private access, and data controls? |
|
|
35
|
-
| Reliability | Can it meet accepted availability, RTO, RPO, and backup objectives? |
|
|
36
|
-
| Performance | Can it meet projected throughput, latency, and growth needs? |
|
|
37
|
-
| Cost | Is the selected SKU/quantity supported by accepted pricing evidence? |
|
|
38
|
-
| Operations | Can it provide required diagnostics, health, ownership, and maintenance behavior? |
|
|
39
|
-
|
|
40
|
-
## Lifecycle And SKU Rules
|
|
41
|
-
|
|
42
|
-
- Use accepted current evidence for service availability, runtime support, SKU features, quotas, and retirement status.
|
|
43
|
-
- Prefer supported GA/LTS versions for durable workloads and avoid deprecated or classic services for greenfield use.
|
|
44
|
-
- Treat access tier, redundancy, orchestration mode, hosting plan, and commitment as separate decisions when applicable.
|
|
45
|
-
- Do not convert an advisory workload matrix into a locked SKU or price.
|
|
46
|
-
- Return a blocker when no candidate satisfies a mandatory requirement or evidence is missing.
|
|
47
|
-
|
|
48
|
-
## Output
|
|
49
|
-
|
|
50
|
-
Record selected and rejected candidates with evidence hashes, requirement IDs, WAF consequences, and unresolved
|
|
51
|
-
assumptions. Do not turn an advisory service matrix into an automatic SKU decision.
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
# Tag And Governance Precedence
|
|
2
|
-
|
|
3
|
-
Accepted governance constraints are the current authority for required tag keys, casing, values, inheritance, and
|
|
4
|
-
exceptions. Baseline tags are only a fallback when the task context explicitly establishes that no policy contract
|
|
5
|
-
exists.
|
|
6
|
-
|
|
7
|
-
## Decision Order
|
|
8
|
-
|
|
9
|
-
1. Confirm governance discovery is complete for inherited and target scopes.
|
|
10
|
-
2. Apply required keys, casing, values, exclusions, inheritance, and enforcement behavior from accepted constraints.
|
|
11
|
-
3. Resolve values only from projected workload, environment, ownership, finance, and operations inputs.
|
|
12
|
-
4. If accepted evidence explicitly reports no applicable tag policy, apply the authorized fallback from
|
|
13
|
-
`baseline-fallbacks.md` and record that source.
|
|
14
|
-
5. Return a blocker when a required owner, cost center, contact, or restricted value is unresolved.
|
|
15
|
-
|
|
16
|
-
## Casing And Inheritance
|
|
17
|
-
|
|
18
|
-
- Use one casing for each logical key. Do not emit case variants such as `owner` and `Owner` together.
|
|
19
|
-
- Distinguish tags required on the resource group from tags required on child resources.
|
|
20
|
-
- Model `Modify` inheritance as expected behavior, but do not rely on it when a `Deny` requires the tag at creation.
|
|
21
|
-
- Preserve exemptions with scope and expiry. An exemption does not remove the requirement outside its scope.
|
|
22
|
-
|
|
23
|
-
## Existing Workloads
|
|
24
|
-
|
|
25
|
-
Preserve deployed casing and keys when drift evidence shows they are intentional and an accepted compatibility decision
|
|
26
|
-
requires them. Do not propagate a legacy convention to new resources merely because an older workload used it.
|
|
27
|
-
|
|
28
|
-
## Output Constraint
|
|
29
|
-
|
|
30
|
-
Place tag intent, value source, propagation behavior, exception, and governance evidence identifier in the architecture
|
|
31
|
-
or binding decision. Do not query policy, create policy assignments, or write tags directly from this skill.
|
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/SKILL.md
DELETED
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-azure-deploy
|
|
3
|
-
description: "Explain approved APEX Azure deployment previews and lifecycle outcomes. Use for approved changes, recovery, verification, and trusted CLI handoff."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Azure Deployment Guidance
|
|
8
|
-
|
|
9
|
-
Use this skill only for an active operator or deployment task. It explains the exact kernel-provided approved preview,
|
|
10
|
-
its lifecycle position, recovery state, and verification evidence. Deployment itself is reserved to trusted CLI
|
|
11
|
-
ceremonies and kernel authorization.
|
|
12
|
-
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- `apex/taskContext` identifies the active operation, target, authorization state, and validated evidence references.
|
|
16
|
-
- `apex/preview` provides the current, unexpired preview created for that active operation.
|
|
17
|
-
- The preview and validation evidence match the target and artifact revision selected by the kernel. A missing,
|
|
18
|
-
mismatched, expired, or partial preview is a blocker.
|
|
19
|
-
|
|
20
|
-
## Workflow
|
|
21
|
-
|
|
22
|
-
1. Read the current kernel-created preview only. Explain its semantic changes, target, expiry, destructive actions,
|
|
23
|
-
ignored or unevaluated items, dependencies, and uncertainty without adding inferred changes.
|
|
24
|
-
2. State the lifecycle condition exactly as projected: awaiting decision, authorized, executing, succeeded, failed, or
|
|
25
|
-
indeterminate. Do not infer completion from files, portal state, or chat history.
|
|
26
|
-
3. Explain the recovery path returned by the kernel. For an indeterminate operation, direct reconciliation through the
|
|
27
|
-
trusted lifecycle rather than retrying the side effect.
|
|
28
|
-
4. Explain verification evidence, including the observations required to establish the expected post-operation state.
|
|
29
|
-
5. Direct the operator to the trusted `apex gate decide` and `apex deploy` CLI ceremonies when the kernel marks them as
|
|
30
|
-
the next action. Do not expose deployment commands, substitute another tool, or invoke a deployment operation.
|
|
31
|
-
|
|
32
|
-
## Boundaries
|
|
33
|
-
|
|
34
|
-
- Do not run or provide direct AZD, Azure CLI, Bicep, Terraform, ARM, portal, or SDK deployment instructions.
|
|
35
|
-
- Do not create, alter, approve, refresh, or extend previews; do not choose a target or grant authorization.
|
|
36
|
-
- Do not independently retry, roll back, or reconcile an operation. Provider behavior is not assumed transactional.
|
|
37
|
-
- Transform a direct deployment request into an explanation of the exact approved preview and the kernel-provided
|
|
38
|
-
trusted CLI ceremony. A request never bypasses validation, approval, expiry, writer-epoch, or authorization checks.
|
|
39
|
-
|
|
40
|
-
## References
|
|
41
|
-
|
|
42
|
-
- [Preview, recovery, and verification](references/preview-recovery-verification.md) - explanation rules and outcome
|
|
43
|
-
semantics.
|
|
44
|
-
- [Operational checklist](references/operational-checklist.md) -
|
|
45
|
-
preconditions, circuit-breaker routing, drift, and verification limits.
|
|
46
|
-
|
|
47
|
-
## Output
|
|
48
|
-
|
|
49
|
-
Return the operation ID, target, lifecycle state, preview expiry, evidence references, blockers, and kernel-provided next
|
|
50
|
-
action. Describe only facts supplied by the active task and preview itself.
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
# Deployment Operational Checklist
|
|
2
|
-
|
|
3
|
-
## Preconditions
|
|
4
|
-
|
|
5
|
-
- Confirm the active operation, validated evidence, target, artifact revision,
|
|
6
|
-
and unexpired approved preview all match before explaining a deployment.
|
|
7
|
-
- Explain destructive actions, dependencies, ignored items, and uncertainty as
|
|
8
|
-
returned by the preview. A preview does not authorize a different target.
|
|
9
|
-
- Treat absent or mismatched validation proof as a blocker and return to the
|
|
10
|
-
trusted validation lifecycle.
|
|
11
|
-
|
|
12
|
-
## Recovery And Circuit Breaking
|
|
13
|
-
|
|
14
|
-
- For policy, governance, budget, build, validation, authentication, timeout,
|
|
15
|
-
or provider failures, preserve the reported evidence and stop at the trusted
|
|
16
|
-
recovery boundary rather than retrying or reconciling independently.
|
|
17
|
-
- Use the kernel-provided circuit-breaker and retry decision. Escalate repeated
|
|
18
|
-
failure or an indeterminate provider outcome instead of assuming rollback.
|
|
19
|
-
- Route governance drift to renewed accepted evidence and a new authorized
|
|
20
|
-
preview; drift is not a reason to amend the current operation in place.
|
|
21
|
-
|
|
22
|
-
## Verification
|
|
23
|
-
|
|
24
|
-
Explain only returned verification observations and their coverage. Endpoint
|
|
25
|
-
reachability alone does not establish policy, security, data, or operational
|
|
26
|
-
acceptance. Direct provider mutation remains a trusted CLI ceremony.
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
# Preview, Recovery, and Verification
|
|
2
|
-
|
|
3
|
-
## Explain the Approved Preview
|
|
4
|
-
|
|
5
|
-
An approved preview is an operation-specific description of planned provider changes. Explain only the preview returned
|
|
6
|
-
for the active operation and include its target, expiry, semantic changes, destructive actions, dependencies,
|
|
7
|
-
unevaluated items, and uncertainty. The preview is not a command, a general deployment plan, or authorization outside
|
|
8
|
-
its stated lifecycle conditions.
|
|
9
|
-
|
|
10
|
-
Do not fill in omitted operations from repository files, provider conventions, or expected resource topology. Omitted or
|
|
11
|
-
unevaluated items are evidence limits and must remain visible to the operator.
|
|
12
|
-
|
|
13
|
-
## Lifecycle and Recovery
|
|
14
|
-
|
|
15
|
-
| State | Meaning | Permitted Guidance |
|
|
16
|
-
| --- | --- | --- |
|
|
17
|
-
| Awaiting decision | Preview exists but no authorization is recorded | Explain the preview and kernel-provided next action |
|
|
18
|
-
| Authorized | Kernel has accepted the required decision | Direct to the trusted CLI ceremony only |
|
|
19
|
-
| Executing | A trusted ceremony has started the provider operation | Report kernel status; do not duplicate it |
|
|
20
|
-
| Succeeded | Kernel recorded a completed operation | Explain required verification evidence |
|
|
21
|
-
| Failed | Kernel recorded a terminal failure | Explain the reported failure and recovery route |
|
|
22
|
-
| Indeterminate | Provider outcome cannot be established | Direct reconciliation; never retry independently |
|
|
23
|
-
|
|
24
|
-
Recovery is an authorized lifecycle transition, not a guessed rollback. Preserve the provider and kernel evidence,
|
|
25
|
-
including partial state. The trusted lifecycle determines whether reconciliation, a new preview, a controlled retry, or
|
|
26
|
-
another recovery action is appropriate.
|
|
27
|
-
|
|
28
|
-
## Delivery Safeguards
|
|
29
|
-
|
|
30
|
-
Explain only safeguards present in the accepted preview and evidence:
|
|
31
|
-
|
|
32
|
-
- A deployment strategy is a risk-control decision, not permission to select a target, run a command, or change a
|
|
33
|
-
rollout.
|
|
34
|
-
- Stop and route to the trusted lifecycle when a circuit-breaker condition, policy precheck failure, validation
|
|
35
|
-
blocker, or drift signal is reported.
|
|
36
|
-
- Treat drift as a reconciliation input. Do not overwrite observed state, infer a baseline, or propose a corrective
|
|
37
|
-
action without a new kernel-authorized preview.
|
|
38
|
-
- Keep policy effects, region availability, and known provider limitations visible as blockers or uncertainty. They do
|
|
39
|
-
not become resolved because a deployment reached a terminal state.
|
|
40
|
-
|
|
41
|
-
Direct commands, recipes, SDK examples, CI definitions, and provider-specific recovery steps remain outside this
|
|
42
|
-
guidance. The trusted CLI and provider lifecycle own those executable paths.
|
|
43
|
-
|
|
44
|
-
## Verification Evidence
|
|
45
|
-
|
|
46
|
-
Verification confirms the expected post-operation state against the active operation. Explain only observations returned
|
|
47
|
-
by the kernel or trusted verification capability, their scope, time, outcome, and limitations. An endpoint being
|
|
48
|
-
reachable, for example, does not establish every security, policy, data, or operational acceptance condition.
|
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-azure-diagnostics
|
|
3
|
-
description: "Interpret APEX diagnostic evidence for Azure service symptoms. Use for health, logs, metrics, failed requests, cold starts, image pulls, and probe analysis."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Azure Diagnostics
|
|
8
|
-
|
|
9
|
-
Use this skill for an active APEX task that interprets capability-produced
|
|
10
|
-
diagnostic evidence. It supports evidence-based triage; it does not run
|
|
11
|
-
diagnostics, alter service state, or establish a root cause without proof.
|
|
12
|
-
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- `apex/taskContext` identifies the affected target, symptom, time window,
|
|
16
|
-
environment, customer impact, and sensitivity boundary.
|
|
17
|
-
- Accepted evidence records the producing capability, evidence hash, target
|
|
18
|
-
scope, query intent, observation time, freshness, completeness, and
|
|
19
|
-
redactions.
|
|
20
|
-
- The requested time window is sufficient to compare an incident interval with
|
|
21
|
-
a baseline. Otherwise, retain a single-window interpretation as uncertain.
|
|
22
|
-
|
|
23
|
-
## Workflow
|
|
24
|
-
|
|
25
|
-
1. Define the symptom as an observable failure, degradation, or anomaly and
|
|
26
|
-
verify that the evidence window and target match it.
|
|
27
|
-
2. Evaluate health, activity, logs, metrics, dependencies, and change evidence
|
|
28
|
-
as separate signals. Absence in one signal is not proof of health.
|
|
29
|
-
3. Use [diagnostic interpretation](references/diagnostic-interpretation.md) to
|
|
30
|
-
classify correlations, confidence, and diagnostic gaps.
|
|
31
|
-
4. Distinguish observed facts, likely contributors, and untested hypotheses.
|
|
32
|
-
Do not label a correlation as root cause without causal evidence.
|
|
33
|
-
5. Return the impact summary, evidence-backed findings, uncertainty, and a
|
|
34
|
-
kernel-provided escalation or next-investigation decision.
|
|
35
|
-
|
|
36
|
-
## Boundaries
|
|
37
|
-
|
|
38
|
-
- Do not invoke external diagnostics, run queries, access logs, inspect live
|
|
39
|
-
service state, or attempt mitigation. Treat all observations as scoped
|
|
40
|
-
capability-produced evidence.
|
|
41
|
-
- Do not expose request payloads, credentials, tokens, personal data, or stack
|
|
42
|
-
traces beyond approved redaction boundaries.
|
|
43
|
-
- Escalate confirmed or suspected security exposure to the appropriate security
|
|
44
|
-
assessment. Route deployment readiness and spending questions to their owning
|
|
45
|
-
assessments.
|
|
46
|
-
- A diagnostic conclusion never authorizes a configuration change, rollback,
|
|
47
|
-
scaling operation, or deployment.
|
|
48
|
-
|
|
49
|
-
## Output
|
|
50
|
-
|
|
51
|
-
Return the symptom, target and time scope, evidence hashes and freshness,
|
|
52
|
-
observed facts, hypotheses with confidence, coverage limits, impact, escalation
|
|
53
|
-
boundary, and kernel-provided next action.
|
|
54
|
-
|
|
55
|
-
## References
|
|
56
|
-
|
|
57
|
-
- [Diagnostic interpretation](references/diagnostic-interpretation.md) -
|
|
58
|
-
evidence sequence, KQL result meaning, service signals, and uncertainty.
|
|
59
|
-
- [Operational checklist](references/operational-checklist.md) -
|
|
60
|
-
symptom framing, signal correlation, and escalation boundaries.
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
## Evidence Sequence
|
|
2
|
-
|
|
3
|
-
Interpret diagnostic evidence in this order: target identity and health,
|
|
4
|
-
incident-window logs, request and dependency outcomes, performance metrics,
|
|
5
|
-
then change correlation. Each signal must retain its query intent or collection
|
|
6
|
-
purpose, evidence hash, time range, completeness, freshness, and redactions.
|
|
7
|
-
|
|
8
|
-
Use a baseline window when available. A spike is meaningful only relative to a
|
|
9
|
-
comparable normal period and can still reflect traffic mix, sampling, retention,
|
|
10
|
-
or instrumentation changes.
|
|
11
|
-
|
|
12
|
-
## Query Result Meaning
|
|
13
|
-
|
|
14
|
-
| Signal | Supports | Does not prove |
|
|
15
|
-
| --- | --- | --- |
|
|
16
|
-
| Recent exceptions | Errors occurred in the observed window | The error caused the customer symptom |
|
|
17
|
-
| Failed requests | Failure rate and affected operation patterns | A backend, network, or code root cause |
|
|
18
|
-
| Slow requests | Latency distribution or slow operations | Capacity exhaustion or the causal dependency |
|
|
19
|
-
| Failed dependencies | Downstream failure correlation | Ownership or origin of the failure |
|
|
20
|
-
| Health or activity events | Control-plane or service-health context | Complete application health |
|
|
21
|
-
|
|
22
|
-
Time bounds, result limits, sampling, missing diagnostics, and redacted fields
|
|
23
|
-
are material uncertainty. Empty results mean only that the scoped evidence did
|
|
24
|
-
not observe a match; they do not establish absence.
|
|
25
|
-
|
|
26
|
-
## Service Signals
|
|
27
|
-
|
|
28
|
-
For containerized services, image acquisition, startup delay, probe failures,
|
|
29
|
-
port mismatch, and revision transitions are distinct hypotheses. For functions,
|
|
30
|
-
invocation failures, timeout patterns, binding failures, cold starts, and
|
|
31
|
-
missing configuration signals likewise need separate evidence. Preserve this
|
|
32
|
-
separation in the finding set so a common symptom is not mistaken for one cause.
|
|
33
|
-
|
|
34
|
-
## Confidence And Escalation
|
|
35
|
-
|
|
36
|
-
Use `observed` for directly evidenced facts, `correlated` for aligned signals,
|
|
37
|
-
and `hypothesis` for plausible but untested explanations. Increase confidence
|
|
38
|
-
only when independent evidence sources agree on target and time window.
|
|
39
|
-
|
|
40
|
-
Escalate when impact is broad, customer-facing, security-sensitive, or evidence
|
|
41
|
-
is too incomplete to bound the risk. The handoff identifies the unanswered
|
|
42
|
-
question and needed scoped evidence; it does not prescribe a live action.
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
# Diagnostics Operational Checklist
|
|
2
|
-
|
|
3
|
-
## Frame The Investigation
|
|
4
|
-
|
|
5
|
-
- State the affected target, observable symptom, environment, impact, and
|
|
6
|
-
investigation window. A single window may establish correlation only.
|
|
7
|
-
- Compare incident evidence with a compatible baseline when one exists; keep
|
|
8
|
-
the absence of a signal distinct from proof of health.
|
|
9
|
-
- Keep health, activity, logs, metrics, dependencies, and change evidence as
|
|
10
|
-
separate signals before drawing a conclusion.
|
|
11
|
-
|
|
12
|
-
## Interpret Safely
|
|
13
|
-
|
|
14
|
-
- Classify statements as observed fact, supported contributor, or untested
|
|
15
|
-
hypothesis. Root-cause claims require causal evidence, not timing alone.
|
|
16
|
-
- For image pulls, cold starts, probes, and request failures, preserve the
|
|
17
|
-
service-specific evidence and the tested configuration boundary.
|
|
18
|
-
- Redact request bodies, credentials, tokens, personal data, and unapproved
|
|
19
|
-
stack details; do not reconstruct redacted values by correlation.
|
|
20
|
-
|
|
21
|
-
## Escalation
|
|
22
|
-
|
|
23
|
-
Return impact, evidence hashes, uncertainty, and the authorized next
|
|
24
|
-
investigation. Diagnostics never authorizes scaling, rollback, or mitigation.
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-azure-governance
|
|
3
|
-
description: "Guide APEX planning from accepted Azure governance evidence. Use for policy constraints and blockers."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Azure Governance Guidance
|
|
8
|
-
|
|
9
|
-
Use this skill for an active APEX planning, architecture, or validation task
|
|
10
|
-
that needs Azure Policy constraints. Only capability-produced, accepted
|
|
11
|
-
governance evidence in `apex/taskContext` is authoritative.
|
|
12
|
-
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- The task context identifies the target subscription and applicable
|
|
16
|
-
management-group ancestry.
|
|
17
|
-
- Accepted governance evidence includes its discovery status, discovery time,
|
|
18
|
-
freshness limit, completeness signature, and scope.
|
|
19
|
-
|
|
20
|
-
Return a blocker when evidence is missing, partial, failed, stale, unsigned,
|
|
21
|
-
or scoped to a different subscription or management-group ancestry. Do not
|
|
22
|
-
infer policy state from model memory, templates, or a prior task.
|
|
23
|
-
|
|
24
|
-
## Workflow
|
|
25
|
-
|
|
26
|
-
1. Confirm the evidence has a `COMPLETE` status and covers the task scope.
|
|
27
|
-
2. Compare the discovery time with its declared freshness limit; route stale
|
|
28
|
-
evidence to the governance discovery capability.
|
|
29
|
-
3. Treat `Deny` findings as blockers unless an accepted exemption records
|
|
30
|
-
them as informational.
|
|
31
|
-
4. Account for `DeployIfNotExists` and `Modify` findings as deployment-time
|
|
32
|
-
conditions rather than silently assuming the desired result.
|
|
33
|
-
5. Carry required tags, allowed locations, and relevant property-path
|
|
34
|
-
constraints into the typed planning or architecture decision.
|
|
35
|
-
6. Record the evidence identifier, scope, completeness signature, and any
|
|
36
|
-
unresolved constraint in the staged artifact.
|
|
37
|
-
|
|
38
|
-
## Boundaries
|
|
39
|
-
|
|
40
|
-
- This skill is advisory. It does not discover policy state, query Azure,
|
|
41
|
-
refresh evidence, or modify resources, files, or task state.
|
|
42
|
-
- Governance evidence constrains a design; it does not grant an exemption or
|
|
43
|
-
override an unresolved policy.
|
|
44
|
-
- Send deployment and remediation decisions to their authorized capability
|
|
45
|
-
and gate, not to this skill.
|
|
46
|
-
|
|
47
|
-
## References
|
|
48
|
-
|
|
49
|
-
- [Evidence interpretation](references/evidence-interpretation.md) -
|
|
50
|
-
envelope checks, classification, exemptions, and blocker routing.
|
|
51
|
-
- [Operational checklist](references/operational-checklist.md) -
|
|
52
|
-
resume conditions, effect handling, and evidence handoff.
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
# Governance Evidence Interpretation
|
|
2
|
-
|
|
3
|
-
Use this reference after accepted governance evidence is available in the
|
|
4
|
-
active task context. The evidence is a point-in-time attestation, not a
|
|
5
|
-
standing authorization.
|
|
6
|
-
|
|
7
|
-
## Acceptance Checks
|
|
8
|
-
|
|
9
|
-
Treat the evidence as usable only when all of the following hold:
|
|
10
|
-
|
|
11
|
-
- Discovery status is `COMPLETE`.
|
|
12
|
-
- Discovery time is within the evidence freshness limit.
|
|
13
|
-
- Subscription and management-group ancestry match the intended task scope.
|
|
14
|
-
- A completeness signature is present and matches the accepted evidence
|
|
15
|
-
record.
|
|
16
|
-
- A nonempty discovery result is consistent with the evidence metadata.
|
|
17
|
-
|
|
18
|
-
Any failed check is a blocker. State which check failed and route the task to
|
|
19
|
-
the governance discovery capability; do not continue with a guessed baseline.
|
|
20
|
-
|
|
21
|
-
## Classification Rules
|
|
22
|
-
|
|
23
|
-
| Policy effect | Planning interpretation |
|
|
24
|
-
| --- | --- |
|
|
25
|
-
| `Deny` | Block the incompatible design unless an accepted exemption applies. |
|
|
26
|
-
| `DeployIfNotExists` | Model it as a deployment-time condition that the plan must accommodate. |
|
|
27
|
-
| `Modify` | Model it as a deployment-time mutation that may change the final resource state. |
|
|
28
|
-
| `Audit` or `AuditIfNotExists` | Preserve as informational context when present in accepted evidence. |
|
|
29
|
-
| `Disabled` | Do not treat as a live constraint. |
|
|
30
|
-
|
|
31
|
-
An accepted exemption retains the original policy effect but changes its
|
|
32
|
-
planning classification to informational. Record its category, expiry, scope,
|
|
33
|
-
and rationale. An expired, missing, or scope-mismatched exemption is not an
|
|
34
|
-
override.
|
|
35
|
-
|
|
36
|
-
## Planning Handoff
|
|
37
|
-
|
|
38
|
-
Project only applicable constraints into the typed decision:
|
|
39
|
-
|
|
40
|
-
- Required tag keys and values.
|
|
41
|
-
- Allowed locations.
|
|
42
|
-
- Resource-property constraints with resolvable target paths.
|
|
43
|
-
- Policy identifiers, classifications, exemptions, and evidence provenance.
|
|
44
|
-
|
|
45
|
-
Leave an unresolved property path explicit rather than inventing an IaC
|
|
46
|
-
mapping. Authorized planning and delivery capabilities own any later
|
|
47
|
-
translation or remediation.
|
|
48
|
-
|
|
49
|
-
## Resume And Reconciliation
|
|
50
|
-
|
|
51
|
-
On resume, repeat the acceptance checks against the current task scope and freshness limit. A prior `COMPLETE` result
|
|
52
|
-
does not survive a changed subscription, management-group ancestry, evidence signature, or expiry window. When
|
|
53
|
-
delivery reports policy drift or an indeterminate provider outcome, preserve the observed result and route it to the
|
|
54
|
-
authorized reconciliation lifecycle. Do not rerun discovery, apply an override, or synthesize a corrected policy
|
|
55
|
-
baseline from this guidance.
|
|
56
|
-
|
|
57
|
-
Discovery scripts, pack execution, and terminal commands remain outside this skill until a separately qualified typed
|
|
58
|
-
capability owns them.
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# Governance Operational Checklist
|
|
2
|
-
|
|
3
|
-
## Evidence Resume
|
|
4
|
-
|
|
5
|
-
- Reuse governance evidence only when its scope, management-group ancestry,
|
|
6
|
-
completeness signature, and freshness policy still match the active task.
|
|
7
|
-
- Treat a changed target, expired freshness, missing signature, `PARTIAL`, or
|
|
8
|
-
`FAILED` discovery result as a blocker requiring a new authorized discovery.
|
|
9
|
-
- Preserve unresolved property paths as unresolved. Do not manufacture an IaC
|
|
10
|
-
equivalent from a policy display name or remembered convention.
|
|
11
|
-
|
|
12
|
-
## Effect Handling
|
|
13
|
-
|
|
14
|
-
- Treat `Deny` as a design blocker unless an accepted, in-scope exemption is
|
|
15
|
-
current and recorded with its rationale.
|
|
16
|
-
- Model `Modify` and `DeployIfNotExists` as delivery-time conditions that can
|
|
17
|
-
alter the observed result; they are not evidence that remediation completed.
|
|
18
|
-
- Keep `Audit`, `AuditIfNotExists`, and `Disabled` findings distinct from
|
|
19
|
-
blocking constraints and retain their evidence provenance.
|
|
20
|
-
|
|
21
|
-
## Handoff
|
|
22
|
-
|
|
23
|
-
Record the evidence identifier, accepted scope, constraints, exemptions, and
|
|
24
|
-
unknowns in the decision. A governance result constrains later work; it never
|
|
25
|
-
grants an exemption, provider access, or remediation authority.
|
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/SKILL.md
DELETED
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-azure-kusto
|
|
3
|
-
description: "Interpret APEX Azure Data Explorer evidence and KQL analysis. Use for Kusto, ADX, KQL, schema, aggregation, time-series, correlation, and anomaly findings."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Azure Data Explorer Analysis
|
|
8
|
-
|
|
9
|
-
Use this skill for an active APEX task that interprets accepted Azure Data
|
|
10
|
-
Explorer evidence and KQL analysis results. It does not discover schemas,
|
|
11
|
-
execute queries, export data, or mutate clusters.
|
|
12
|
-
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- `apex/taskContext` identifies the cluster and database boundary, approved
|
|
16
|
-
table scope, analytic question, time range, result limit, and data handling
|
|
17
|
-
constraints.
|
|
18
|
-
- Capability-produced evidence carries its producer, query intent or pattern,
|
|
19
|
-
evidence hash, target scope, observation time, freshness, completeness,
|
|
20
|
-
sampling or truncation status, and redaction boundary.
|
|
21
|
-
- Schema evidence is accepted for the same target and sufficiently fresh for
|
|
22
|
-
the query interpretation. Do not infer columns or semantics from table names.
|
|
23
|
-
|
|
24
|
-
## Workflow
|
|
25
|
-
|
|
26
|
-
1. Confirm the analytic question and select the applicable interpretation
|
|
27
|
-
pattern in [KQL evidence interpretation](references/kql-evidence-interpretation.md).
|
|
28
|
-
2. Verify that time bounds, filters, projections, joins, and aggregation grain
|
|
29
|
-
answer that question without silently excluding relevant records.
|
|
30
|
-
3. Distinguish record retrieval, aggregate trend, correlated event, and anomaly
|
|
31
|
-
evidence. State what the pattern establishes and what it cannot establish.
|
|
32
|
-
4. Carry evidence hash, target scope, time window, result completeness,
|
|
33
|
-
redactions, and uncertainty into the result.
|
|
34
|
-
5. Return observations and an authorized next-assessment request when evidence
|
|
35
|
-
is insufficient. Route operational incidents to diagnostics and cost
|
|
36
|
-
questions to cost assessment.
|
|
37
|
-
|
|
38
|
-
## Boundaries
|
|
39
|
-
|
|
40
|
-
- Do not invoke external queries, inspect schemas, retrieve data, or export
|
|
41
|
-
results. All inputs are scoped capability-produced evidence.
|
|
42
|
-
- Do not treat sampled, limited, partial, or stale results as population-wide
|
|
43
|
-
truth. Do not recover redacted values through correlation or inference.
|
|
44
|
-
- Do not create mutation, retention, access, or cluster-management decisions.
|
|
45
|
-
Escalate such requests to the kernel-selected owner.
|
|
46
|
-
|
|
47
|
-
## Output
|
|
48
|
-
|
|
49
|
-
Return the question, target scope, query-pattern intent, evidence hashes,
|
|
50
|
-
freshness, redaction and completeness limits, observations, uncertainty, and
|
|
51
|
-
kernel-provided next action. Use `indeterminate` for incomplete support.
|
|
52
|
-
|
|
53
|
-
## References
|
|
54
|
-
|
|
55
|
-
- [KQL evidence interpretation](references/kql-evidence-interpretation.md) -
|
|
56
|
-
query pattern meaning, quality checks, and analytic limits.
|
|
57
|
-
- [Operational checklist](references/operational-checklist.md) -
|
|
58
|
-
schema, query-shape, result-limit, and redaction checks.
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
## Interpretation Patterns
|
|
2
|
-
|
|
3
|
-
| Pattern | Useful for | Required limits to report |
|
|
4
|
-
| --- | --- | --- |
|
|
5
|
-
| Retrieval | Inspecting bounded recent records | Time range, filter, projection, result limit |
|
|
6
|
-
| Aggregation | Counts, distributions, and top contributors | Grouping dimensions, time bucket, omitted values |
|
|
7
|
-
| Time series | Trend, latency, volume, and anomaly signals | Baseline, bucket size, sampling, seasonality |
|
|
8
|
-
| Correlation | Events aligned by a declared key and interval | Join type, unmatched records, key quality |
|
|
9
|
-
| Schema evidence | Understanding available fields and types | Schema freshness, permissions, partial visibility |
|
|
10
|
-
|
|
11
|
-
Every interpretation begins with the question, target, and time range. A
|
|
12
|
-
time-series result needs a bounded time filter; an exploratory result needs a
|
|
13
|
-
declared limit. A pattern that is not present in evidence cannot be assumed.
|
|
14
|
-
|
|
15
|
-
## Quality Checks
|
|
16
|
-
|
|
17
|
-
- Confirm filters were applied before broad correlation or aggregation where
|
|
18
|
-
the evidence's query intent requires a constrained population.
|
|
19
|
-
- Confirm projected fields contain only approved, redacted data and that
|
|
20
|
-
aggregations do not disclose protected values through small groups.
|
|
21
|
-
- Confirm `bin`-style bucketing matches the decision horizon; a coarse bucket
|
|
22
|
-
can hide bursts and a fine bucket can create noise.
|
|
23
|
-
- Treat joins as a relationship claim only when the correlation key, time
|
|
24
|
-
alignment, and unmatched-record behavior are documented.
|
|
25
|
-
- Compare anomaly or percentile claims to an accepted baseline. A single high
|
|
26
|
-
percentile or spike does not establish a persistent trend.
|
|
27
|
-
|
|
28
|
-
## Limits And Escalation
|
|
29
|
-
|
|
30
|
-
Result limits, sampling, retention, late-arriving events, schema drift,
|
|
31
|
-
permission-based partial visibility, and redaction can all bias a conclusion.
|
|
32
|
-
State these limits with the evidence hash and freshness rather than compensating
|
|
33
|
-
with assumptions. When a conclusion needs wider scope, unredacted data, a
|
|
34
|
-
different time window, or causal service evidence, return `indeterminate` and
|
|
35
|
-
ask the kernel to obtain the needed scoped capability evidence.
|
|
36
|
-
|
|
37
|
-
## Query Capability Boundary
|
|
38
|
-
|
|
39
|
-
Schema discovery, KQL execution, CLI or REST fallback, and data export are provider-backed operations. Preserve their
|
|
40
|
-
query intent, scope, limits, and failure state in an evidence request, but defer execution until a qualified capability
|
|
41
|
-
exists. Do not replace an unavailable query result with model-generated records or inferred schema.
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# Kusto Evidence Operational Checklist
|
|
2
|
-
|
|
3
|
-
## Query Shape
|
|
4
|
-
|
|
5
|
-
- Confirm accepted schema evidence for the same cluster, database, table, and
|
|
6
|
-
freshness policy before interpreting a query result.
|
|
7
|
-
- Bound time-series questions by time range and result size. Filter and project
|
|
8
|
-
early, and keep joins and aggregation grain aligned with the stated question.
|
|
9
|
-
- Distinguish record retrieval, aggregate trends, correlations, and anomaly
|
|
10
|
-
signals; each has different limits on the conclusions it can support.
|
|
11
|
-
|
|
12
|
-
## Result Quality
|
|
13
|
-
|
|
14
|
-
- Preserve query intent, target scope, time window, sampling, truncation,
|
|
15
|
-
redaction, and evidence hash with the result.
|
|
16
|
-
- Treat a schema mismatch, unbounded question, partial result, or stale data as
|
|
17
|
-
indeterminate. Do not infer columns or semantics from names alone.
|
|
18
|
-
- Do not recover redacted values, export data, or turn query findings into
|
|
19
|
-
retention, access, or cluster-management decisions.
|
|
20
|
-
|
|
21
|
-
## Routing
|
|
22
|
-
|
|
23
|
-
Route operational symptoms to diagnostics and spend questions to cost
|
|
24
|
-
assessment. Request an authorized collection only when accepted evidence is
|
|
25
|
-
insufficient.
|