@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,52 +0,0 @@
|
|
|
1
|
-
# Network And Observability
|
|
2
|
-
|
|
3
|
-
Read this reference when a Bicep binding includes hub-spoke networking, private connectivity, or resource diagnostics.
|
|
4
|
-
|
|
5
|
-
## Hub-Spoke Composition
|
|
6
|
-
|
|
7
|
-
Use hub-spoke topology only when shared connectivity, inspection, DNS, or platform services are accepted architectural
|
|
8
|
-
requirements. Bind peering, routing, subnet, and network-security intent explicitly; do not imply those choices from a
|
|
9
|
-
resource name or a module default.
|
|
10
|
-
|
|
11
|
-
The hub owns accepted shared services. Spokes peer to the hub and do not peer directly unless the architecture records
|
|
12
|
-
a specific exception. Pass the hub resource ID through module outputs rather than reconstructing it. Apply network
|
|
13
|
-
security at the subnet boundary, and verify address spaces and service CIDRs do not overlap before generation.
|
|
14
|
-
|
|
15
|
-
## Private Endpoint And DNS
|
|
16
|
-
|
|
17
|
-
Private endpoint intent includes the target subresource, approved subnet, private DNS zone, and DNS zone group. A
|
|
18
|
-
private endpoint without its DNS and network dependencies is incomplete. Public access exceptions require an accepted
|
|
19
|
-
risk and policy-compatible boundary.
|
|
20
|
-
|
|
21
|
-
When shared private DNS is not provided by the platform, the owning binding must create the zone, link it to the
|
|
22
|
-
accepted VNet, and pass the created zone resource ID to the endpoint. Do not construct an ID for a zone that no binding
|
|
23
|
-
creates or accepts as existing evidence.
|
|
24
|
-
|
|
25
|
-
Common service subresources and zones include:
|
|
26
|
-
|
|
27
|
-
| Service | Subresource | Private DNS zone |
|
|
28
|
-
| --- | --- | --- |
|
|
29
|
-
| Blob storage | `blob` | `privatelink.blob.core.windows.net` |
|
|
30
|
-
| Table storage | `table` | `privatelink.table.core.windows.net` |
|
|
31
|
-
| Key Vault | `vault` | `privatelink.vaultcore.azure.net` |
|
|
32
|
-
| Azure SQL | `sqlServer` | `privatelink.database.windows.net` |
|
|
33
|
-
| Cosmos DB for NoSQL | `Sql` | `privatelink.documents.azure.com` |
|
|
34
|
-
| App Service | `sites` | `privatelink.azurewebsites.net` |
|
|
35
|
-
| Event Hubs | `namespace` | `privatelink.servicebus.windows.net` |
|
|
36
|
-
| Container Registry | `registry` | `privatelink.azurecr.io` |
|
|
37
|
-
|
|
38
|
-
Treat this table as a pattern aid, not live service-availability evidence. Confirm the exact target resource contract
|
|
39
|
-
when accepting a binding.
|
|
40
|
-
|
|
41
|
-
## Diagnostics And Dependencies
|
|
42
|
-
|
|
43
|
-
Every governed resource should have diagnostics and metrics mapped to the accepted monitoring destination. Category
|
|
44
|
-
selection, retention, cost, and ownership remain typed planning decisions; generated settings and deployment success
|
|
45
|
-
require validator and operation receipts.
|
|
46
|
-
|
|
47
|
-
Prefer supported category groups when they satisfy the accepted requirement; otherwise bind explicit categories from
|
|
48
|
-
current provider evidence. Include metrics only when the resource supports them.
|
|
49
|
-
|
|
50
|
-
An `existing` resource reference does not create an implicit dependency on a module that creates that resource in the
|
|
51
|
-
same deployment. Extension resources such as diagnostics and private DNS zone groups need explicit ordering when their
|
|
52
|
-
parent is created by another module.
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-codegen
|
|
3
|
-
description: "Provides hidden-worker guidance for one bounded APEX IaC generation task with approved intent and binding."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## APEX Code Generation
|
|
8
|
-
|
|
9
|
-
Use this skill only inside the hidden CodeGen worker.
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
- `apex/taskContext` supplies approved intent, one selected-track binding, policy obligations, output paths, and limits.
|
|
14
|
-
- The task identifies a single dependency-sized generation batch.
|
|
15
|
-
|
|
16
|
-
## Workflow
|
|
17
|
-
|
|
18
|
-
1. Call `apex/generateIac` once for the issued task ID, accepted intent, and selected-track binding.
|
|
19
|
-
2. Preserve exact module, provider, API, security, naming, ownership, and environment-input obligations.
|
|
20
|
-
3. Keep secret values out of generated content; use only typed references supplied by the kernel. Use `apex/stageFile`
|
|
21
|
-
only for additional assigned files before completion.
|
|
22
|
-
4. Complete the issued task with the generated output. After completion, return the kernel receipt and perform no
|
|
23
|
-
follow-up staging, generation, validation, delegation, or repository work.
|
|
24
|
-
5. Return `needs_input` when a required binding or value is absent.
|
|
25
|
-
|
|
26
|
-
## Boundaries
|
|
27
|
-
|
|
28
|
-
Do not execute, format, validate, preview, deploy, write directly to repository paths, or delegate work.
|
|
29
|
-
|
|
30
|
-
## Output
|
|
31
|
-
|
|
32
|
-
Return the typed completion or `needs_input` result with affected field IDs.
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-entra-app-registration
|
|
3
|
-
description: "Model Microsoft Entra application registration and OAuth design intent in APEX. Use for application type, flow, API permission, redirect URI, credential, and consent trade-offs."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Entra App Registration Guidance
|
|
8
|
-
|
|
9
|
-
Use this skill only for an active architecture, planning, or approved implementation-binding task. The kernel owns
|
|
10
|
-
task state, evidence freshness, authorization, artifact acceptance, and all state-changing work.
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
- `apex/taskContext` identifies the active task, allowed outputs, applicable requirements, and evidence references.
|
|
15
|
-
- The workload purpose, client type, tenant boundary, target APIs, and user-interaction model are known; otherwise
|
|
16
|
-
return `needs_input`.
|
|
17
|
-
- An identity operation is available only through a kernel-authorized capability. A request alone is not authority to
|
|
18
|
-
create or alter an application registration.
|
|
19
|
-
|
|
20
|
-
## Workflow
|
|
21
|
-
|
|
22
|
-
1. Model the application type, audience, tenant model, redirect-URI class, and OAuth interaction.
|
|
23
|
-
Record the selected flow and rationale without protocol requests or application configuration.
|
|
24
|
-
2. Map each business operation to the minimum delegated or application permission requirement.
|
|
25
|
-
Record consent ownership, scope, and unresolved permission evidence; do not infer or approve consent.
|
|
26
|
-
3. Select a credential posture: public clients hold no credential; Azure-hosted workloads prefer managed identity.
|
|
27
|
-
Confidential workloads prefer federation or certificates over secrets; record lifecycle ownership, never a value.
|
|
28
|
-
4. Submit typed identity intent only through the kernel-authorized capability named in the task envelope.
|
|
29
|
-
Preserve its receipt or blocker in the architecture, plan, or binding artifact.
|
|
30
|
-
5. Handoff approved identity intent to the authorized implementation, validation, or operations capability.
|
|
31
|
-
Do not claim that registration, permissions, credentials, or consent exist without an accepted receipt.
|
|
32
|
-
6. Classify observed identity failures with [Identity design and diagnostic rules](references/design-and-diagnostics.md).
|
|
33
|
-
Return the responsible owner and evidence gap without attempting remediation.
|
|
34
|
-
|
|
35
|
-
## Boundaries
|
|
36
|
-
|
|
37
|
-
Do not use portal, CLI, Microsoft Graph, SDK, HTTP, IaC, repository, source-scanning, or file-mutation actions. Do
|
|
38
|
-
not create registrations, configure redirect URIs, grant consent, assign permissions, create or handle credentials,
|
|
39
|
-
expose identifiers or secret material, test authentication, or deploy. Direct operational requests must be converted
|
|
40
|
-
into bounded intent and an authorized capability handoff.
|
|
41
|
-
|
|
42
|
-
## References
|
|
43
|
-
|
|
44
|
-
- [OAuth and registration model](references/oauth-registration-model.md) - client, audience, flow, and redirect-URI decisions.
|
|
45
|
-
- [Permissions and credential posture](references/permissions-and-credentials.md) - least privilege and credential trade-offs.
|
|
46
|
-
- [Capability receipt and handoff](references/capability-receipts.md) - required evidence, blockers, and next-task rules.
|
|
47
|
-
- [Identity design and diagnostic rules](references/design-and-diagnostics.md) - source-derived flow, permission, and
|
|
48
|
-
troubleshooting rules without configuration or protocol operations.
|
|
49
|
-
|
|
50
|
-
## Output
|
|
51
|
-
|
|
52
|
-
Return typed identity design intent, requirement traces, authorized capability receipt references, explicit blockers,
|
|
53
|
-
and the next kernel-controlled task.
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# Capability Receipts And Handoff
|
|
2
|
-
|
|
3
|
-
An identity decision becomes operational only after an authorized capability returns an accepted receipt. Intent is not
|
|
4
|
-
evidence that an application registration, permission, consent, redirect URI, or credential exists.
|
|
5
|
-
|
|
6
|
-
## Required Intent Fields
|
|
7
|
-
|
|
8
|
-
- Requirement references and active task identifier.
|
|
9
|
-
- Application, tenant, audience, flow, and redirect-URI design intent.
|
|
10
|
-
- Permission and consent intent, including the unresolved items.
|
|
11
|
-
- Credential posture, lifecycle owner, and validation obligation.
|
|
12
|
-
|
|
13
|
-
## Receipt Rules
|
|
14
|
-
|
|
15
|
-
Preserve the capability name, receipt identifier, status, evidence reference, and any explicit blocker. A missing,
|
|
16
|
-
stale, rejected, or incomplete receipt blocks downstream claims and requires kernel-directed recovery.
|
|
17
|
-
|
|
18
|
-
## Handoff
|
|
19
|
-
|
|
20
|
-
Route accepted intent to the task-envelope capability for implementation, then to the authorized validation or operations
|
|
21
|
-
capability. Return the next task and blocker state; do not perform or simulate the handoff.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# Identity Design And Diagnostic Rules
|
|
2
|
-
|
|
3
|
-
Use this reference to model identity intent and classify observed failures. It does not create registrations, issue
|
|
4
|
-
tokens, call Microsoft Graph, grant consent, or handle credentials.
|
|
5
|
-
|
|
6
|
-
## Flow And Registration Intent
|
|
7
|
-
|
|
8
|
-
Record workload purpose, client class, interactive-user model, tenant boundary, API audience, redirect-URI class, and
|
|
9
|
-
the owning application before implementation begins. Use authorization code for web applications, authorization code
|
|
10
|
-
with PKCE for SPA or mobile public clients, device code only for supported browserless user interaction, and client
|
|
11
|
-
credentials for service-to-service workloads. Treat the selection as design intent, not a configured flow.
|
|
12
|
-
|
|
13
|
-
Redirect URIs must be an exact registered match and belong to the correct client platform. Unknown callback locations,
|
|
14
|
-
tenant model, or audience block implementation intent rather than being filled with placeholders.
|
|
15
|
-
|
|
16
|
-
## Permission And Credential Intent
|
|
17
|
-
|
|
18
|
-
Map each accepted business operation to its minimum required permission and target resource. Model delegated access
|
|
19
|
-
when the operation acts for a signed-in user and application access for a background workload without a user. Record
|
|
20
|
-
the consent owner and evidence; application permissions and privileged delegated permissions require an explicit
|
|
21
|
-
consent decision and must never be inferred as granted.
|
|
22
|
-
|
|
23
|
-
Public clients have no client credential. Prefer managed identity for supported Azure-hosted workloads and federation
|
|
24
|
-
or certificates for external confidential workloads. A secret-only design needs an explicit exception, lifecycle owner,
|
|
25
|
-
and replacement plan. Record credential type and rotation requirement, never credential material or identifiers.
|
|
26
|
-
|
|
27
|
-
## Diagnostic Classification
|
|
28
|
-
|
|
29
|
-
Classify a redirect mismatch by comparing the exact requested URI, registered URI, and platform class. Classify consent
|
|
30
|
-
or insufficient-privilege failures by checking the requested permission type, consent owner, target resource, and
|
|
31
|
-
accepted configuration evidence. Classify invalid-client or expired-credential failures as a credential-lifecycle
|
|
32
|
-
blocker. Classify application-not-found or tenant failures as an identity-boundary mismatch. Do not expose tokens or
|
|
33
|
-
use diagnostic observations as authority to change an application registration.
|
|
34
|
-
|
|
35
|
-
Return the evidence gap, responsible owner, and required kernel-authorized next task. Direct configuration, consent,
|
|
36
|
-
credential, SDK, CLI, IaC, and HTTP remediation stays outside this skill.
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
# OAuth And Registration Model
|
|
2
|
-
|
|
3
|
-
Model identity before requesting an implementation capability. The design artifact must identify the workload purpose,
|
|
4
|
-
client class, users or services that authenticate, target API audience, tenant boundary, and redirect-URI class.
|
|
5
|
-
|
|
6
|
-
## Flow Selection
|
|
7
|
-
|
|
8
|
-
| Workload | Default intent | Constraints to record |
|
|
9
|
-
| --- | --- | --- |
|
|
10
|
-
| Web app | Authorization code | Redirect URI ownership and session boundary |
|
|
11
|
-
| SPA or mobile app | Authorization code with PKCE | Public-client posture and redirect URI class |
|
|
12
|
-
| Browserless user workflow | Device code only when interaction is supported | User consent and device interaction boundary |
|
|
13
|
-
| Service-to-service | Client credentials | Application permission and workload identity posture |
|
|
14
|
-
|
|
15
|
-
Do not describe token requests, generate protocol values, or claim that a flow is configured. The selected flow is a
|
|
16
|
-
traceable design choice that an authorized capability may later implement and validate.
|
|
17
|
-
|
|
18
|
-
## Redirect URI Intent
|
|
19
|
-
|
|
20
|
-
Record the owning application, URI class, environment boundary, and exact-match requirement. Unknown redirect URIs
|
|
21
|
-
block implementation intent; do not substitute placeholders or broaden accepted callback locations.
|
|
22
|
-
|
|
23
|
-
## Tenant And Audience
|
|
24
|
-
|
|
25
|
-
Record whether the application is single-tenant, multi-tenant, or otherwise restricted, and name the intended API
|
|
26
|
-
audience. Treat both as user-owned decisions when requirements lack evidence.
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# Permissions And Credentials
|
|
2
|
-
|
|
3
|
-
## Permission Intent
|
|
4
|
-
|
|
5
|
-
Map each accepted operation to one minimum API permission requirement. Specify whether the operation acts for a signed-in
|
|
6
|
-
user (delegated) or without a user (application), the target resource, consent owner, and evidence for necessity.
|
|
7
|
-
|
|
8
|
-
| Condition | Decision |
|
|
9
|
-
| --- | --- |
|
|
10
|
-
| User-context operation | Model delegated permission intent |
|
|
11
|
-
| Background workload operation | Model application permission intent |
|
|
12
|
-
| Permission necessity is unknown | Return `needs_input` or a blocker |
|
|
13
|
-
| Consent authority is absent | Preserve a consent blocker |
|
|
14
|
-
|
|
15
|
-
Never infer elevated permissions, grant consent, or treat requested permissions as approved access.
|
|
16
|
-
|
|
17
|
-
## Credential Posture
|
|
18
|
-
|
|
19
|
-
| Client or hosting model | Preferred posture |
|
|
20
|
-
| --- | --- |
|
|
21
|
-
| Public client | No client credential |
|
|
22
|
-
| Azure-hosted workload | Managed identity when the target supports it |
|
|
23
|
-
| External confidential workload | Federated identity credential or certificate |
|
|
24
|
-
| Secret-only integration | Explicit exception, lifecycle owner, and replacement plan |
|
|
25
|
-
|
|
26
|
-
Do not create, retrieve, transmit, store, rotate, or reveal secret material. Record only credential type, owner,
|
|
27
|
-
validity or rotation requirement, and the capability receipt needed to establish it.
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-mermaid
|
|
3
|
-
description: "Requests safe inline Mermaid for supported APEX Markdown slots. Use for compact flowcharts, sequences, state machines, ER models, Gantt views, renderer validation, accessible theming, and syntax troubleshooting from accepted artifact data."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Inline Mermaid
|
|
8
|
-
|
|
9
|
-
The current APEX document registry declares no Mermaid-capable slots. Do not request or emit an inline Mermaid fence
|
|
10
|
-
until a renderer registers a typed source, a supported slot, syntax validation, and a returned document receipt.
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
- The target template exposes a Mermaid-capable inline slot.
|
|
15
|
-
- Accepted artifact data contains every node, relationship, label, and time value to be shown.
|
|
16
|
-
- The renderer declares supported Mermaid syntax and validation behavior.
|
|
17
|
-
|
|
18
|
-
## Future Renderer Contract
|
|
19
|
-
|
|
20
|
-
When a renderer-supported slot exists, select the simplest diagram type that preserves accepted relationships. Apply
|
|
21
|
-
[syntax guidance](references/syntax.md) and [styling guidance](references/styling.md), then submit only the bounded
|
|
22
|
-
fence to that renderer. The renderer, rather than this skill, must validate syntax and return the document receipt.
|
|
23
|
-
|
|
24
|
-
Syntax and styling references are guidance targets, not active renderer slots. They do not make Mermaid output
|
|
25
|
-
available until a typed source, renderer registration, and receipt exist.
|
|
26
|
-
|
|
27
|
-
## Boundaries
|
|
28
|
-
|
|
29
|
-
- Do not create standalone architecture, network, runtime, as-built, WAF, cost, or compliance diagrams.
|
|
30
|
-
- Do not write or edit files, invoke deployment, or mutate source-of-truth artifacts, templates, schemas, or state.
|
|
31
|
-
- Do not use unaccepted inputs, infer missing values, or treat rendered Markdown as gate evidence.
|
|
32
|
-
- Do not embed Azure service icons, custom SVG, secrets, physical principal IDs, unsafe links, or Mermaid click actions.
|
|
33
|
-
- Do not claim syntax or visual validation from model inspection; only the renderer receipt supplies that evidence.
|
|
34
|
-
|
|
35
|
-
## Blockers
|
|
36
|
-
|
|
37
|
-
When the requested document slot is unsupported, absent, or cannot be filled from accepted data, return a blocker that
|
|
38
|
-
names the slot, diagram type, and missing renderer support or artifact data. Also block when renderer-version syntax,
|
|
39
|
-
escaping, or accessibility cannot be validated. Do not emit a substitute diagram or alter any source.
|
|
40
|
-
|
|
41
|
-
## Output
|
|
42
|
-
|
|
43
|
-
Return only the renderer request or its rendered inline document result and receipt. Preserve any projected artifact and
|
|
44
|
-
template hashes, validation status, and unresolved blockers.
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# Styling Guidance
|
|
2
|
-
|
|
3
|
-
Use a renderer-compatible neutral theme and limited semantic classes. Meaning must remain clear without color.
|
|
4
|
-
|
|
5
|
-
```mermaid
|
|
6
|
-
%%{init: {'theme': 'neutral'}}%%
|
|
7
|
-
graph LR
|
|
8
|
-
classDef gate stroke:#2563eb,stroke-width:2px;
|
|
9
|
-
INPUT["Accepted data"] --> GATE{"Supported slot"}:::gate
|
|
10
|
-
GATE --> OUTPUT["Rendered inline view"]
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Styling Rules
|
|
14
|
-
|
|
15
|
-
- Prefer one layout direction, consistent node shapes, and a small semantic class set.
|
|
16
|
-
- Use shape, border, and text labels together; never encode status or severity by color alone.
|
|
17
|
-
- Keep contrast readable in light and dark Markdown renderers. Use renderer-projected colors when available.
|
|
18
|
-
- Use subgraphs only for accepted ownership, trust, lifecycle, or resource boundaries.
|
|
19
|
-
- Keep edge labels short and place detail in surrounding prose when the slot permits it.
|
|
20
|
-
- Avoid service icons, custom SVG, background images, animations, click actions, and external CSS.
|
|
21
|
-
- Do not use emoji as the only identifier; assistive text must carry the meaning.
|
|
22
|
-
|
|
23
|
-
## Complexity Limits
|
|
24
|
-
|
|
25
|
-
When labels overlap, crossings obscure meaning, or the renderer cannot fit the slot, reduce the diagram to its primary
|
|
26
|
-
accepted relationship. Split independent concerns into supported slots or use a standalone diagram capability. Do not
|
|
27
|
-
hide nodes or drop material edges merely to make the view attractive.
|
|
28
|
-
|
|
29
|
-
## Renderer Validation
|
|
30
|
-
|
|
31
|
-
The renderer decides whether the slot accepts Mermaid, the theme directive is supported, syntax parses, and the result
|
|
32
|
-
fits the document. Inspect the renderer receipt for validation errors. Model inspection, Markdown source appearance, or
|
|
33
|
-
a successful document request is not visual-validation evidence.
|
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
# Syntax Guidance
|
|
2
|
-
|
|
3
|
-
Use one compact diagram in a fenced `mermaid` block for a renderer-supported inline slot.
|
|
4
|
-
|
|
5
|
-
## Choose The Diagram Type
|
|
6
|
-
|
|
7
|
-
| Accepted relationship | Diagram type |
|
|
8
|
-
| --- | --- |
|
|
9
|
-
| Branching process, dependency, or decision | `flowchart` or `graph` |
|
|
10
|
-
| Ordered interaction among actors | `sequenceDiagram` |
|
|
11
|
-
| Lifecycle states and transitions | `stateDiagram-v2` |
|
|
12
|
-
| Entity relationships and cardinality | `erDiagram` |
|
|
13
|
-
| Dated tasks and dependencies | `gantt` |
|
|
14
|
-
|
|
15
|
-
Use a standalone diagram capability for architecture, network, runtime, as-built, WAF, cost, or compliance visuals.
|
|
16
|
-
|
|
17
|
-
## Flowchart
|
|
18
|
-
|
|
19
|
-
```mermaid
|
|
20
|
-
graph TB
|
|
21
|
-
START["Accepted input"] --> CHECK{"Gate"}
|
|
22
|
-
CHECK -->|"Pass"| RENDER["Render slot"]
|
|
23
|
-
CHECK -->|"Block"| STOP["Return blocker"]
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
Use `TB` for vertical flows and `LR` for short horizontal flows. Group related nodes only when an accepted boundary
|
|
27
|
-
exists. Use `-->` for primary flow, `-.->` for an accepted optional relationship, and `==>` sparingly for an accepted
|
|
28
|
-
critical path. Label decisions and non-obvious edges.
|
|
29
|
-
|
|
30
|
-
## Sequence
|
|
31
|
-
|
|
32
|
-
```mermaid
|
|
33
|
-
sequenceDiagram
|
|
34
|
-
participant CLIENT as Client
|
|
35
|
-
participant API as API
|
|
36
|
-
participant STORE as Data store
|
|
37
|
-
CLIENT->>API: Accepted request
|
|
38
|
-
API->>STORE: Read accepted record
|
|
39
|
-
STORE-->>API: Result
|
|
40
|
-
API-->>CLIENT: Response
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Declare participants in first-use order. Use solid arrows for calls and dashed arrows for responses. Do not invent
|
|
44
|
-
authentication, retries, timing, or failure paths absent from accepted data.
|
|
45
|
-
|
|
46
|
-
## State
|
|
47
|
-
|
|
48
|
-
```mermaid
|
|
49
|
-
stateDiagram-v2
|
|
50
|
-
[*] --> Proposed
|
|
51
|
-
Proposed --> Accepted: Approve
|
|
52
|
-
Accepted --> Superseded: Replace
|
|
53
|
-
Superseded --> [*]
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
Use explicit transition labels and only accepted states. Avoid modeling an action as a state or implying a transition
|
|
57
|
-
the kernel does not authorize.
|
|
58
|
-
|
|
59
|
-
## Entity Relationship
|
|
60
|
-
|
|
61
|
-
```mermaid
|
|
62
|
-
erDiagram
|
|
63
|
-
WORKLOAD ||--o{ RESOURCE : contains
|
|
64
|
-
RESOURCE ||--o{ EVIDENCE : supported_by
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Use accepted cardinality. Keep entity and relationship names concise; do not expose sensitive field values.
|
|
68
|
-
|
|
69
|
-
## Gantt
|
|
70
|
-
|
|
71
|
-
```mermaid
|
|
72
|
-
gantt
|
|
73
|
-
title Accepted delivery window
|
|
74
|
-
dateFormat YYYY-MM-DD
|
|
75
|
-
section Delivery
|
|
76
|
-
Foundation :foundation, 2030-01-01, 2d
|
|
77
|
-
Validation :validation, after foundation, 1d
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
Use dates and durations only from accepted schedule data. A Gantt chart is a presentation, not authorization or proof
|
|
81
|
-
that a task started or completed.
|
|
82
|
-
|
|
83
|
-
## Safe Identifiers And Labels
|
|
84
|
-
|
|
85
|
-
- Use short, unique ASCII IDs; keep human-readable text in quoted labels or participant aliases.
|
|
86
|
-
- Keep labels factual and concise. Use renderer-supported line breaks only when validation confirms them.
|
|
87
|
-
- Avoid reserved keywords as IDs, duplicate IDs, unescaped quote characters, raw URLs, and HTML labels.
|
|
88
|
-
- Preserve accepted relationship direction; do not reverse arrows to improve layout.
|
|
89
|
-
- Omit unavailable values rather than inserting placeholders or guessed nodes.
|
|
90
|
-
|
|
91
|
-
## Troubleshooting
|
|
92
|
-
|
|
93
|
-
| Renderer finding | Correction |
|
|
94
|
-
| --- | --- |
|
|
95
|
-
| Parse error near label | Replace the display label with a quoted label and a simple ASCII ID. |
|
|
96
|
-
| Duplicate or merged nodes | Give every semantic node a unique ID while retaining its accepted display label. |
|
|
97
|
-
| Unsupported directive or diagram | Use the renderer-supported syntax or return an unsupported-capability blocker. |
|
|
98
|
-
| Unreadable dense graph | Split by accepted concern or use the standalone diagram capability. |
|
|
99
|
-
| Relationship appears wrong | Check the accepted source mapping; never fix layout by changing semantics. |
|
package/assets/client-projections/github-copilot-cli/.github/skills/apex-microsoft-docs/SKILL.md
DELETED
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-microsoft-docs
|
|
3
|
-
description: "Researches official Microsoft documentation for APEX decisions. Use for Microsoft Learn concepts, limits, version support, WAF and architecture guidance, configuration, tutorials, and official code samples with cited evidence."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# APEX Microsoft Documentation
|
|
7
|
-
|
|
8
|
-
Use this skill only for an active APEX architecture or planning task that needs current official Microsoft guidance.
|
|
9
|
-
The documentation capability is currently unavailable until it is activated and qualified for the selected client.
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
- `apex/taskContext` identifies the current task and the decision that needs evidence.
|
|
14
|
-
- An activated, client-qualified, read-only documentation capability is available for the selected projection.
|
|
15
|
-
|
|
16
|
-
Until that capability is active, return a missing-evidence blocker. Do not substitute model memory, a web scrape, a
|
|
17
|
-
CLI fallback, or an unverified third-party source.
|
|
18
|
-
|
|
19
|
-
## Workflow
|
|
20
|
-
|
|
21
|
-
1. Frame a specific question with product, service, version, platform, task intent, and the decision it supports.
|
|
22
|
-
2. Search through the qualified documentation capability before retrieving content.
|
|
23
|
-
3. Rank official results by directness, version/platform fit, scope, and currency.
|
|
24
|
-
4. Use the search excerpt when sufficient; otherwise fetch only the relevant page or section.
|
|
25
|
-
5. Request an official code-sample search only when runnable example code is part of the question.
|
|
26
|
-
6. Reconcile conflicting or incomplete sources and preserve unresolved applicability as a blocker.
|
|
27
|
-
7. Record concise evidence with URL, title, heading, retrieval time, applicability, and uncertainty.
|
|
28
|
-
8. Check that each material claim is supported and that documentation is not standing in for another evidence type.
|
|
29
|
-
|
|
30
|
-
Read [the research method](references/research-method.md) before issuing a documentation request.
|
|
31
|
-
|
|
32
|
-
## Boundaries
|
|
33
|
-
|
|
34
|
-
- This skill is advisory. It does not configure MCP servers, execute commands, or modify files.
|
|
35
|
-
- Azure pricing remains the read-only ARM MCP pricing evidence path, not a documentation lookup.
|
|
36
|
-
- Documentation does not replace governance, quota, availability, approval, or deployment evidence.
|
|
37
|
-
- Official examples are illustrative inputs to a later implementation decision, not proof that code compiles or deploys.
|
|
38
|
-
- Do not fetch broad documentation trees, copy long page bodies, or use model memory to fill a missing source.
|
|
39
|
-
|
|
40
|
-
## Blockers
|
|
41
|
-
|
|
42
|
-
Return a missing-evidence blocker when the qualified capability is absent, no official source covers the target version
|
|
43
|
-
or platform, sources materially conflict, the page is stale or inaccessible, or applicability cannot be established.
|
|
44
|
-
Name the unresolved question and the evidence needed; do not fall back to CLI, web scraping, or third-party summaries.
|
|
45
|
-
|
|
46
|
-
## References
|
|
47
|
-
|
|
48
|
-
- [Research method](references/research-method.md) covers query framing, source selection, samples, conflicts, and evidence.
|
|
49
|
-
|
|
50
|
-
## Output
|
|
51
|
-
|
|
52
|
-
Return a bounded evidence result for the active APEX decision. Include supported claims, source URLs, applicability,
|
|
53
|
-
retrieval metadata, uncertainty, conflicts, and missing-evidence blockers without changing task state.
|
|
@@ -1,91 +0,0 @@
|
|
|
1
|
-
# Official Documentation Research Method
|
|
2
|
-
|
|
3
|
-
## Frame The Question
|
|
4
|
-
|
|
5
|
-
Include the Microsoft product or Azure service, feature, exact or supported version family, platform, operating system,
|
|
6
|
-
IaC or SDK language when relevant, task intent, environment constraint, and decision to resolve.
|
|
7
|
-
|
|
8
|
-
Good query shapes name an outcome and source type:
|
|
9
|
-
|
|
10
|
-
- `Azure Storage private endpoint DNS zone group configuration`
|
|
11
|
-
- `Azure VMSS flexible orchestration limitations Linux`
|
|
12
|
-
- `.NET supported version policy App Service Linux`
|
|
13
|
-
- `Azure Well-Architected reliability checklist stateful workload`
|
|
14
|
-
|
|
15
|
-
Use `overview` for concepts, `quickstart` or `tutorial` for a guided task, `reference` for exact configuration, `limits`
|
|
16
|
-
for service boundaries, and `version support` or `retirement` for lifecycle questions.
|
|
17
|
-
|
|
18
|
-
## Select The Source Type
|
|
19
|
-
|
|
20
|
-
| Question | Preferred official source |
|
|
21
|
-
| --- | --- |
|
|
22
|
-
| Exact property, API, SDK, limit, or supported value | Product reference for the target version |
|
|
23
|
-
| Setup sequence or learning task | Current quickstart or tutorial for the target platform |
|
|
24
|
-
| Architecture trade-off | Azure Architecture Center or Well-Architected guidance |
|
|
25
|
-
| Lifecycle or compatibility | Product support, release, or retirement policy |
|
|
26
|
-
| Runnable example | Official code-sample result plus its parent documentation |
|
|
27
|
-
|
|
28
|
-
## Retrieve Evidence
|
|
29
|
-
|
|
30
|
-
1. Search first; do not begin with a full-page fetch.
|
|
31
|
-
2. Keep only results on official Microsoft domains supplied by the qualified capability.
|
|
32
|
-
3. Rank exact product/version/platform matches above generic, archived, training, or community pages.
|
|
33
|
-
4. Stop at the excerpt when it directly answers the question and supplies a citable URL.
|
|
34
|
-
5. Fetch one page or named section when qualifiers, tables, prerequisites, or exceptions are missing from the excerpt.
|
|
35
|
-
6. Run code-sample search only when the user or decision needs code; bind language, SDK, and version in the query.
|
|
36
|
-
|
|
37
|
-
Do not load an entire documentation tree. A second page is justified only when the first page explicitly delegates a
|
|
38
|
-
material prerequisite, limit, or exception to it.
|
|
39
|
-
|
|
40
|
-
## Evaluate Applicability
|
|
41
|
-
|
|
42
|
-
Check service and feature, cloud or region scope, version, platform, API surface, publication/update metadata, preview or
|
|
43
|
-
GA status, prerequisites, exclusions, and whether the page describes control plane, data plane, SDK, portal, or IaC.
|
|
44
|
-
|
|
45
|
-
Documentation can establish published behavior but cannot prove that a target subscription has quota, a SKU is currently
|
|
46
|
-
available in a region, a policy permits it, a deployment succeeded, or a price is current. Request the owning evidence
|
|
47
|
-
capability for those claims.
|
|
48
|
-
|
|
49
|
-
## Handle Code Samples
|
|
50
|
-
|
|
51
|
-
- Treat samples as illustrative and inspect their stated version, dependencies, authentication, and prerequisites.
|
|
52
|
-
- Prefer managed identity or `DefaultAzureCredential` patterns when the official sample supports them.
|
|
53
|
-
- Never copy credentials, connection strings, tenant values, or deprecated authentication patterns into an artifact.
|
|
54
|
-
- Record gaps between sample defaults and accepted security, governance, networking, or lifecycle requirements.
|
|
55
|
-
- Require later compile, test, and deployment validation; sample provenance is not execution evidence.
|
|
56
|
-
|
|
57
|
-
## Resolve Conflicts
|
|
58
|
-
|
|
59
|
-
Prefer the more specific current product reference over generic architecture prose for exact behavior. Prefer the target
|
|
60
|
-
version's page over an unversioned sample. When two applicable official sources materially disagree, retain both URLs,
|
|
61
|
-
describe the conflict, and return a blocker rather than choosing silently.
|
|
62
|
-
|
|
63
|
-
## Record The Result
|
|
64
|
-
|
|
65
|
-
For every material claim, retain:
|
|
66
|
-
|
|
67
|
-
- concise paraphrased claim
|
|
68
|
-
- page title, URL, and relevant heading
|
|
69
|
-
- retrieval time and capability evidence identifier
|
|
70
|
-
- applicable product, service, version, platform, and scope
|
|
71
|
-
- decision and requirement IDs informed
|
|
72
|
-
- caveats, conflicts, uncertainty, and follow-up evidence needed
|
|
73
|
-
|
|
74
|
-
Quote only the short phrase needed for exact terminology. Do not retain full page content in project artifacts. Treat a
|
|
75
|
-
changed, unavailable, archived, or ambiguous source as missing evidence.
|
|
76
|
-
|
|
77
|
-
## Validation Loop
|
|
78
|
-
|
|
79
|
-
1. Match every material claim to a captured source.
|
|
80
|
-
2. Check version, platform, scope, and preview/GA qualifiers.
|
|
81
|
-
3. Remove claims supported only by model memory or a search-title inference.
|
|
82
|
-
4. Search or fetch one narrower official source when a gap is resolvable.
|
|
83
|
-
5. Return the remaining gap as a blocker when the qualified capability cannot resolve it.
|
|
84
|
-
|
|
85
|
-
## Do Not
|
|
86
|
-
|
|
87
|
-
- Treat a search result as approval, policy, quota, availability, or pricing evidence.
|
|
88
|
-
- Fetch broad documentation trees or retain raw documentation in project artifacts.
|
|
89
|
-
- Use third-party summaries when an official Microsoft source is required.
|
|
90
|
-
- Add an unqualified documentation server or fallback command to a managed client projection.
|
|
91
|
-
- Claim an official sample is production-ready, secure for the workload, compiled, or deployed without separate evidence.
|
package/assets/client-projections/github-copilot-cli/.github/skills/apex-operations/SKILL.md
DELETED
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-operations
|
|
3
|
-
description: "Provides internal APEX operations guidance for status, preview, inventory, reconciliation, and diagnosis."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## APEX Operations
|
|
8
|
-
|
|
9
|
-
Use this skill only in the interactive Operator agent.
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
- `apex/status` identifies the selected run.
|
|
14
|
-
- A task context is required only when the kernel issues a task-backed operation.
|
|
15
|
-
|
|
16
|
-
## Workflow
|
|
17
|
-
|
|
18
|
-
1. Use `apex/status` for taskless status. Use `apex/preview` only to read the current preview and explain its recorded
|
|
19
|
-
semantic changes, target, expiry, destructive actions, ignored or unevaluated items, and uncertainty.
|
|
20
|
-
2. Use `apex/inventory` only to read the inventory already recorded for the selected run. Use `apex/reconcile` only for
|
|
21
|
-
an indeterminate operation; do not repeat a side effect independently.
|
|
22
|
-
3. Use `apex/diagnose` only when the kernel issues a task-backed diagnosis, then read its exact `apex/taskContext`.
|
|
23
|
-
4. Direct the user to `apex gate decide` and `apex deploy`; those trusted CLI ceremonies are not MCP tools.
|
|
24
|
-
5. Report provider and kernel results without claiming transactional rollback, live Azure diagnostics, or a diagnosis
|
|
25
|
-
beyond the returned bounded status and doctor checks.
|
|
26
|
-
|
|
27
|
-
## Output
|
|
28
|
-
|
|
29
|
-
Return the operation ID, state, evidence references, blockers, and kernel-provided next action.
|
|
30
|
-
|
|
31
|
-
## Boundaries
|
|
32
|
-
|
|
33
|
-
Required validation, authorization, freshness, and writer-epoch checks are kernel-controlled. Do not invent operations,
|
|
34
|
-
retry effects, or claim a provider inspection that the current APEX MCP result does not contain.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-planning
|
|
3
|
-
description: "Provides internal APEX planning guidance for implementation intent, controls, dependencies, and bindings."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## APEX Planning
|
|
8
|
-
|
|
9
|
-
Use this skill only for an active planning task.
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
- The kernel projects accepted architecture and current governance inputs.
|
|
14
|
-
- The selected IaC track and target environment are present in the task envelope.
|
|
15
|
-
|
|
16
|
-
## Workflow
|
|
17
|
-
|
|
18
|
-
1. Use accepted task-context artifacts and preserve their source hashes in implementation intent. Keep intent free of
|
|
19
|
-
Bicep or Terraform syntax.
|
|
20
|
-
2. Define logical resources, controls, dependencies, identity, networking, diagnostics, outputs, and environment
|
|
21
|
-
obligations. Keep dependencies acyclic.
|
|
22
|
-
3. Put modules, providers, API versions, variables, parameters, phases, backend, and stack ownership in the selected
|
|
23
|
-
binding rather than neutral intent. Bind only the selected task track.
|
|
24
|
-
4. Trace every binding obligation to intent and projected policy requirements. Represent environment secrets only as
|
|
25
|
-
typed references; do not include secret values.
|
|
26
|
-
5. Stage each typed output through `apex/stageArtifact`, then call `apex/completeTask` once with every required
|
|
27
|
-
output in `outputs`. Do not submit a single-output completion for a multi-output task.
|
|
28
|
-
|
|
29
|
-
## Output
|
|
30
|
-
|
|
31
|
-
Return the kernel result and any architecture-rooted or user-owned blocker.
|
|
32
|
-
|
|
33
|
-
## Boundaries
|
|
34
|
-
|
|
35
|
-
The kernel validates source hashes, track consistency, binding coverage, dependency shape, and secret safety. Do not
|
|
36
|
-
claim a binding, hash format, provider capability, or gate result that is not returned by the current task contract.
|