@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
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/SKILL.md
DELETED
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-azure-validate
|
|
3
|
-
description: "Assess APEX Azure preflight evidence. Use for freshness, acceptance criteria, readiness blockers, and validated handoff decisions."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Azure Validation
|
|
8
|
-
|
|
9
|
-
Use this skill only for an active validation task. It evaluates the kernel-projected preparation artifacts and evidence
|
|
10
|
-
against acceptance criteria; it does not execute checks independently or change lifecycle state.
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
- `apex/taskContext` identifies the validation scope, target, required evidence, freshness policy, and acceptance
|
|
15
|
-
criteria.
|
|
16
|
-
- Required preparation artifacts and the selected IaC binding are accepted by the kernel.
|
|
17
|
-
- The task envelope supplies the authorized validation capability or evidence results. Missing or stale evidence is a
|
|
18
|
-
blocker, not an invitation to re-create it from local files, chat history, or model memory.
|
|
19
|
-
|
|
20
|
-
## Workflow
|
|
21
|
-
|
|
22
|
-
1. Confirm that each required preparation output is present, accepted, and traceable to the active run and target.
|
|
23
|
-
2. Evaluate evidence freshness using the policy and timestamps projected by the kernel. Report expired, mismatched,
|
|
24
|
-
incomplete, or indeterminate evidence exactly as returned.
|
|
25
|
-
3. Compare the authorized validation results with the task's functional, security, governance, build, and deployment
|
|
26
|
-
acceptance criteria. Keep a failed check distinct from an unavailable check.
|
|
27
|
-
4. Return the kernel-provided validation result and unresolved criteria. When remediation changes intent or bindings,
|
|
28
|
-
route back to the owning preparation task rather than editing artifacts directly.
|
|
29
|
-
5. Hand off only an accepted validation result to the next kernel-selected lifecycle task.
|
|
30
|
-
|
|
31
|
-
## Boundaries
|
|
32
|
-
|
|
33
|
-
- Do not run previews, builds, linters, IaC validators, authentication checks, or Azure queries directly.
|
|
34
|
-
- Do not amend validation proof, bypass a failed criterion, or set a plan to validated.
|
|
35
|
-
- Do not deploy or imply that passing a partial check authorizes deployment.
|
|
36
|
-
- Transform a request to run a preflight command into a request for the trusted validation capability's evidence. The
|
|
37
|
-
capability and kernel, not this skill, decide whether it can refresh evidence or advance state.
|
|
38
|
-
|
|
39
|
-
## References
|
|
40
|
-
|
|
41
|
-
- [Preflight evidence model](references/preflight-evidence.md) - freshness, acceptance outcomes, and remediation
|
|
42
|
-
routing.
|
|
43
|
-
- [Operational checklist](references/operational-checklist.md) -
|
|
44
|
-
generated-tree validation, acceptance coverage, and failed-check routing.
|
|
45
|
-
|
|
46
|
-
## Output
|
|
47
|
-
|
|
48
|
-
Return the validation state, acceptance-criterion outcomes, evidence references, blockers, and the kernel-provided next
|
|
49
|
-
action. Use `indeterminate` when provided evidence cannot establish readiness.
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
# Validation Operational Checklist
|
|
2
|
-
|
|
3
|
-
## Preconditions
|
|
4
|
-
|
|
5
|
-
- Confirm accepted preparation artifacts, selected IaC binding, target, and
|
|
6
|
-
acceptance criteria belong to the active run before reading validation proof.
|
|
7
|
-
- Use only kernel-projected or trusted capability evidence. A local file,
|
|
8
|
-
remembered command result, or chat statement cannot replace accepted proof.
|
|
9
|
-
- Keep unavailable, failed, incomplete, stale, and scope-mismatched checks
|
|
10
|
-
distinct; none may be restated as a passed criterion.
|
|
11
|
-
|
|
12
|
-
## Coverage
|
|
13
|
-
|
|
14
|
-
- Evaluate generated-tree validation, build, security, governance, functional,
|
|
15
|
-
and deployment-readiness criteria against their declared evidence scope.
|
|
16
|
-
- Require each accepted result to identify its target, artifact revision,
|
|
17
|
-
observation time, outcome, and remaining limits.
|
|
18
|
-
- When a failure changes intent, inputs, or IaC bindings, route it to the
|
|
19
|
-
owning preparation task and require renewed validation evidence.
|
|
20
|
-
|
|
21
|
-
## Handoff
|
|
22
|
-
|
|
23
|
-
Only a complete accepted validation result may advance to the kernel-selected
|
|
24
|
-
next task. This skill neither changes lifecycle state nor invokes deployment.
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
# Preflight Evidence Model
|
|
2
|
-
|
|
3
|
-
## Evidence Requirements
|
|
4
|
-
|
|
5
|
-
Preflight is a claim about a specific run, target, binding, and artifact revision. Valid evidence identifies:
|
|
6
|
-
|
|
7
|
-
- The active run and target environment.
|
|
8
|
-
- The accepted preparation and binding artifacts being evaluated.
|
|
9
|
-
- The validator or trusted capability that produced the result.
|
|
10
|
-
- The observation time and kernel-defined freshness result.
|
|
11
|
-
- The acceptance criterion, outcome, and any supporting diagnostic reference.
|
|
12
|
-
|
|
13
|
-
Evidence that lacks a target, artifact revision, freshness result, or producing authority is incomplete. Treat it as a
|
|
14
|
-
blocker rather than estimating its validity from source files or earlier chat output.
|
|
15
|
-
|
|
16
|
-
## Outcome Semantics
|
|
17
|
-
|
|
18
|
-
| Outcome | Meaning | Lifecycle Treatment |
|
|
19
|
-
| --- | --- | --- |
|
|
20
|
-
| Pass | Current evidence meets the named criterion | Retain the evidence reference |
|
|
21
|
-
| Fail | Current evidence disproves the criterion | Route to the task that owns remediation |
|
|
22
|
-
| Blocked | Required input, authority, or evidence is absent | Request or await the missing dependency |
|
|
23
|
-
| Indeterminate | Evidence cannot establish an outcome | Do not advance readiness |
|
|
24
|
-
| Stale | Evidence exceeds the kernel-defined freshness policy | Request trusted evidence refresh |
|
|
25
|
-
|
|
26
|
-
## Acceptance Criteria
|
|
27
|
-
|
|
28
|
-
Acceptance criteria should be explicit, scoped, and independently checkable. They may cover artifact integrity, binding
|
|
29
|
-
consistency, policy obligations, security controls, build readiness, prerequisite availability, preview readiness, and
|
|
30
|
-
verification obligations. A pass for one criterion does not silently satisfy another.
|
|
31
|
-
|
|
32
|
-
## Remediation Routing
|
|
33
|
-
|
|
34
|
-
Return each non-pass outcome to its owner: requirements for an unresolved desired outcome, architecture for a decision,
|
|
35
|
-
planning or binding for implementation intent, CodeGen for an authorized generation batch, or a trusted validation
|
|
36
|
-
capability for refreshed observations. Validation never rewrites evidence it is evaluating.
|
|
37
|
-
|
|
38
|
-
## Region, Global, And Error Semantics
|
|
39
|
-
|
|
40
|
-
Evaluate a region or global prerequisite only from evidence bound to the selected target, service, binding revision, and
|
|
41
|
-
freshness policy. Preserve authorization, environment, compiler, provider, and policy failures as distinct outcomes;
|
|
42
|
-
an unavailable check is not a failed check. Policy discovery, CLI authentication, previews, and recipe command execution
|
|
43
|
-
remain deferred trusted capabilities, so this skill records their evidence and routes errors without executing them.
|
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/SKILL.md
DELETED
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-bicep-patterns
|
|
3
|
-
description: "Apply approved Bicep architecture patterns to APEX implementation intent. Use for AVM composition, private endpoints, networking, diagnostics, and CodeGen acceptance."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# APEX Bicep Patterns
|
|
7
|
-
|
|
8
|
-
Use this skill for an active Bicep-bound planning or CodeGen task. It describes approved intent and acceptance criteria;
|
|
9
|
-
CodeGen and validators own generated files and command execution.
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
- `apex/taskContext` identifies an accepted Bicep track task and its typed binding inputs.
|
|
14
|
-
- Requirements, governance, security, and architecture decisions are current.
|
|
15
|
-
|
|
16
|
-
## Workflow
|
|
17
|
-
|
|
18
|
-
1. Select only patterns supported by the accepted architecture and track binding.
|
|
19
|
-
2. Apply [Network and observability](references/network-and-observability.md) to private connectivity and diagnostics.
|
|
20
|
-
3. Read [Module interfaces and parameters](references/module-interfaces-and-parameters.md) when creating reusable
|
|
21
|
-
modules or binding environment-specific inputs.
|
|
22
|
-
4. Read [Compiler and provider gotchas](references/compiler-and-provider-gotchas.md) before accepting module bindings.
|
|
23
|
-
5. Apply [AVM and CodeGen acceptance](references/avm-and-codegen-acceptance.md) to module decisions and validation intent.
|
|
24
|
-
6. Verify the generated intent against the [CodeGen acceptance checklist](references/codegen-acceptance-checklist.md).
|
|
25
|
-
7. Stage only typed intent through APEX MCP; return unavailable modules or stale evidence as blockers.
|
|
26
|
-
|
|
27
|
-
## Boundaries
|
|
28
|
-
|
|
29
|
-
- This skill does not write Bicep, resolve module versions, invoke Bicep, or perform deployment commands.
|
|
30
|
-
- CodeGen owns generated IaC; validators own build, lint, security, and preview receipts.
|
|
31
|
-
- Module choice does not bypass policy, cost, approval, or deployment evidence.
|
|
32
|
-
|
|
33
|
-
## References
|
|
34
|
-
|
|
35
|
-
- [Network and observability](references/network-and-observability.md) - hub-spoke, private endpoints, and diagnostics.
|
|
36
|
-
- [Module interfaces and parameters](references/module-interfaces-and-parameters.md) - stable composition contracts and
|
|
37
|
-
environment-neutral input binding.
|
|
38
|
-
- [Compiler and provider gotchas](references/compiler-and-provider-gotchas.md) - exact-schema, language, identity, SKU,
|
|
39
|
-
query, and service-topology failure rules.
|
|
40
|
-
- [CodeGen acceptance checklist](references/codegen-acceptance-checklist.md) - final intent and evidence review loop.
|
|
41
|
-
- [AVM and CodeGen acceptance](references/avm-and-codegen-acceptance.md) - module binding and validation intent.
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
# AVM And CodeGen Acceptance
|
|
2
|
-
|
|
3
|
-
Prefer Azure Verified Modules when the selected Bicep binding can meet accepted requirements. Record the module family,
|
|
4
|
-
version-resolution evidence, required inputs, identity, network, diagnostics, tags, and outputs as typed constraints.
|
|
5
|
-
|
|
6
|
-
An AVM module is not automatically compliant. CodeGen must bind the selected version and interface; validation must
|
|
7
|
-
confirm syntax, lint, security baseline, policy-compatible settings, and preview results. When a module cannot express a
|
|
8
|
-
requirement, record the exception, alternative implementation, rationale, and traceability before generation.
|
|
9
|
-
|
|
10
|
-
Use explicit parameters for environment-specific values and avoid secret literals. Preserve stable resource identity and
|
|
11
|
-
outputs needed by dependent bindings. What-if review is a required pre-deployment receipt, not an informal observation.
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
# CodeGen Acceptance Checklist
|
|
2
|
-
|
|
3
|
-
Use this checklist after Bicep generation and before accepting validator or preview evidence.
|
|
4
|
-
|
|
5
|
-
## Intent And Governance
|
|
6
|
-
|
|
7
|
-
- [ ] Every generated resource traces to accepted requirements and architecture intent.
|
|
8
|
-
- [ ] Applicable policy effects map to generated properties or an explicit blocker.
|
|
9
|
-
- [ ] Environment-specific values come from the accepted environment input contract.
|
|
10
|
-
- [ ] No secret, placeholder identifier, recipient, subscription, tenant, or principal is embedded in source.
|
|
11
|
-
|
|
12
|
-
## Modules And Composition
|
|
13
|
-
|
|
14
|
-
- [ ] AVM is used when the selected module can satisfy the accepted intent.
|
|
15
|
-
- [ ] Every module version has authorized resolution evidence and its exact schema was inspected.
|
|
16
|
-
- [ ] Module inputs and outputs follow the accepted interface and match the exact selected schema.
|
|
17
|
-
- [ ] Resource names satisfy service constraints without changing stable identity unexpectedly.
|
|
18
|
-
- [ ] Optional modules guard dependent outputs and resources consistently.
|
|
19
|
-
- [ ] Existing resource references have explicit dependencies when their targets are created in the same deployment.
|
|
20
|
-
|
|
21
|
-
## Security And Identity
|
|
22
|
-
|
|
23
|
-
- [ ] HTTPS, transport security, identity, network access, and data-access settings match the accepted baseline.
|
|
24
|
-
- [ ] Role assignments use the narrowest accepted scope and the intended principal type.
|
|
25
|
-
- [ ] Runtime identities are not promoted to data-plane administrators.
|
|
26
|
-
- [ ] Public access or credential-based exceptions have accepted, current dispositions.
|
|
27
|
-
|
|
28
|
-
## Network And Operations
|
|
29
|
-
|
|
30
|
-
- [ ] Address spaces and service CIDRs do not overlap.
|
|
31
|
-
- [ ] Private endpoint bindings include the correct subresource, subnet, DNS zone, VNet link ownership, and zone group.
|
|
32
|
-
- [ ] Diagnostics target the accepted monitoring destination and include supported log and metric categories.
|
|
33
|
-
- [ ] SKU-sensitive properties are compatible with the selected tier in the rendered template.
|
|
34
|
-
- [ ] Query-based alert text is valid for the target table schema.
|
|
35
|
-
- [ ] Post-deployment requirements are recorded rather than represented as unsupported resource properties.
|
|
36
|
-
|
|
37
|
-
## Validation Loop
|
|
38
|
-
|
|
39
|
-
- [ ] Formatting, build, lint, security, policy, and provider-readiness checks pass.
|
|
40
|
-
- [ ] Preview contains no unexplained deletion, SKU downgrade, public-access change, authentication change, or identity
|
|
41
|
-
removal.
|
|
42
|
-
- [ ] Generated parameters compile against the generated entrypoint.
|
|
43
|
-
- [ ] Validation receipts bind the current source tree, module locks, target, inputs, and dependency revision.
|
|
44
|
-
- [ ] Any correction was followed by a fresh full validation pass; stale receipts were not reused.
|
|
45
|
-
|
|
46
|
-
Return a blocker with the failing checklist item and required owner when any mandatory item cannot be proven.
|
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
# Compiler And Provider Gotchas
|
|
2
|
-
|
|
3
|
-
Read this reference before accepting a new AVM binding and when build, preview, and apply results disagree.
|
|
4
|
-
|
|
5
|
-
## Exact Module Schema Wins
|
|
6
|
-
|
|
7
|
-
AVM parameter names, nested object fields, required values, and outputs can change between module versions. Inspect the
|
|
8
|
-
schema for the exact selected version before authoring its binding. Do not copy parameter shapes from model memory, an
|
|
9
|
-
older project, or documentation for another version.
|
|
10
|
-
|
|
11
|
-
Record the inspected inputs and outputs in validation evidence. If the exact schema cannot be inspected, return a
|
|
12
|
-
blocker rather than guessing.
|
|
13
|
-
|
|
14
|
-
AVM use also requires these checks:
|
|
15
|
-
|
|
16
|
-
- pin the version selected by the authorized resolver
|
|
17
|
-
- verify output names before creating downstream dependencies
|
|
18
|
-
- confirm required policy tags survive any module-internal tag merge
|
|
19
|
-
- verify diagnostics are emitted by the module or by an explicit companion binding
|
|
20
|
-
- wrap a module to override incompatible defaults; record an exception before replacing AVM with a raw resource
|
|
21
|
-
|
|
22
|
-
## Bicep Language Constraints
|
|
23
|
-
|
|
24
|
-
- `utcNow()` is valid only as a parameter default. Do not use it in a variable or resource expression.
|
|
25
|
-
- A child resource `parent` must be calculable at deployment start. A module output is not a static parent name; use a
|
|
26
|
-
parameter-derived existing resource and an explicit dependency when ordering is otherwise lost.
|
|
27
|
-
- A subscription-scope module called from a resource-group deployment requires an explicit subscription scope.
|
|
28
|
-
- An `existing` resource reference does not prove that its creating module has completed. Add an explicit dependency
|
|
29
|
-
when a child or extension resource targets something created in the same deployment.
|
|
30
|
-
|
|
31
|
-
## Identity And RBAC
|
|
32
|
-
|
|
33
|
-
Keep identity creation separate from target-resource authorization. Putting a target resource's role assignment inside
|
|
34
|
-
the identity module can create a dependency cycle when each module needs the other's output. Place the assignment with
|
|
35
|
-
the target resource and use the identity principal output as an input.
|
|
36
|
-
|
|
37
|
-
A runtime managed identity is not a data-plane administrator. Use a dedicated administration principal for SQL or other
|
|
38
|
-
data-plane administration, then grant the runtime identity only the application permissions it needs. Deploy-time
|
|
39
|
-
principal IDs remain required environment inputs; CodeGen must not invent or bake them into parameter files.
|
|
40
|
-
|
|
41
|
-
## Validation Green, Apply Red
|
|
42
|
-
|
|
43
|
-
A successful build or preview does not prove resource-provider compatibility. Review the rendered resource properties
|
|
44
|
-
when an AVM default may be SKU-dependent. Reject premium-only networking, zone, quarantine, trust, or data-endpoint
|
|
45
|
-
properties on a lower tier unless the exact provider contract supports them.
|
|
46
|
-
|
|
47
|
-
For scheduled query rules, validate KQL against the target table schema. Bicep treats the query as an opaque string and
|
|
48
|
-
preview does not run the service query parser. Ingestion quota alert queries against `_LogOperation` must use that
|
|
49
|
-
table's columns rather than fields copied from `AzureActivity`, `AzureDiagnostics`, or application tables.
|
|
50
|
-
|
|
51
|
-
## Service Topology Traps
|
|
52
|
-
|
|
53
|
-
- AKS egress mode must match the accepted topology: subnet NAT gateway, AKS-managed NAT gateway, explicit default route
|
|
54
|
-
to an operator-managed firewall, or load balancer are different designs. Fixed-size pools must not carry autoscaling
|
|
55
|
-
bounds, and a control-plane identity using an existing VNet needs the accepted network role assignment.
|
|
56
|
-
- An Application Gateway backend pool may be empty until its real backend exists. Never use a loopback address as a
|
|
57
|
-
placeholder.
|
|
58
|
-
- MySQL private endpoint and delegated-subnet injection are different, mutually exclusive topologies. A shared private
|
|
59
|
-
endpoint subnet is not a delegated MySQL subnet. Treat read-only authentication settings and other post-deployment
|
|
60
|
-
operations as deployment tasks, not writable Bicep properties.
|
|
61
|
-
- A database major-version upgrade is an isolated lifecycle operation. Do not combine it with unrelated property
|
|
62
|
-
changes. Resolve supported versions from current service evidence rather than retaining a version literal here.
|
|
63
|
-
- Subscription-scoped cost alerts require a scope-compatible view and module scope.
|
|
64
|
-
- Automation schedules cannot attach to an unpublished runbook. Keep publish-and-link work as an explicit
|
|
65
|
-
post-deployment task when the resource provider requires it.
|
|
66
|
-
|
|
67
|
-
## Repair Loop
|
|
68
|
-
|
|
69
|
-
1. Classify the failure as Bicep language, exact module schema, rendered-template, or provider apply-time behavior.
|
|
70
|
-
2. Check the exact selected schema and accepted architecture/SKU evidence.
|
|
71
|
-
3. Correct the typed binding or record an explicit module exception; do not add a speculative property.
|
|
72
|
-
4. Re-run the owning build, lint, security, policy, and preview validators.
|
|
73
|
-
5. Proceed only when the new receipts are current; an apply-only limitation remains a documented deployment risk or
|
|
74
|
-
blocker.
|
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
# Module Interfaces And Parameters
|
|
2
|
-
|
|
3
|
-
Read this reference when a Bicep binding introduces a reusable module or environment-specific inputs.
|
|
4
|
-
|
|
5
|
-
## Stable Module Interface
|
|
6
|
-
|
|
7
|
-
Give reusable modules a predictable contract so composition, diagnostics, identity, and downstream dependencies do not
|
|
8
|
-
rely on module-specific guesswork.
|
|
9
|
-
|
|
10
|
-
Required inputs normally include:
|
|
11
|
-
|
|
12
|
-
- `name`
|
|
13
|
-
- `location`
|
|
14
|
-
- `tags`
|
|
15
|
-
- the accepted monitoring workspace binding when the resource supports diagnostics
|
|
16
|
-
|
|
17
|
-
Required outputs normally include:
|
|
18
|
-
|
|
19
|
-
- `resourceId`
|
|
20
|
-
- `resourceName`
|
|
21
|
-
- `principalId` when managed identity is supported
|
|
22
|
-
|
|
23
|
-
When a resource has no managed identity, expose an explicitly optional or empty principal value according to the typed
|
|
24
|
-
binding contract. Do not invent an identity merely to satisfy a uniform output shape.
|
|
25
|
-
|
|
26
|
-
Add service-specific inputs and outputs only when a downstream binding needs them. Keep secrets out of outputs, and do
|
|
27
|
-
not leak generated credentials through module composition.
|
|
28
|
-
|
|
29
|
-
## Environment Inputs
|
|
30
|
-
|
|
31
|
-
Keep the generated Bicep tree environment-neutral. Environment-specific subscription IDs, tenant IDs, object IDs,
|
|
32
|
-
notification recipients, budget values, and existing-resource bindings must come from the accepted environment input
|
|
33
|
-
contract rather than literals or environment branches in `main.bicep`.
|
|
34
|
-
|
|
35
|
-
Use `.bicepparam` files as generated binding surfaces when the selected toolchain supports them. Each parameter must map
|
|
36
|
-
to an accepted typed input. Values resolved at deployment time remain unresolved in source; CodeGen must not fabricate a
|
|
37
|
-
placeholder GUID, address, secret, or recipient.
|
|
38
|
-
|
|
39
|
-
Reject these patterns:
|
|
40
|
-
|
|
41
|
-
- project-specific GUIDs or subscription IDs embedded in Bicep or parameter files
|
|
42
|
-
- secret defaults
|
|
43
|
-
- production and non-production identifiers selected by conditional literals in `main.bicep`
|
|
44
|
-
- parameters that are not present in the accepted IaC binding contract
|
|
45
|
-
- environment input names that are silently renamed between planning, CodeGen, and deployment
|
|
46
|
-
|
|
47
|
-
## Acceptance Check
|
|
48
|
-
|
|
49
|
-
Before staging CodeGen intent, verify:
|
|
50
|
-
|
|
51
|
-
- every module input traces to accepted architecture, governance, defaults, or environment intent
|
|
52
|
-
- every output has a known consumer or documented compatibility purpose
|
|
53
|
-
- required monitoring and identity bindings are explicit
|
|
54
|
-
- environment-specific values remain external to the generated source tree
|
|
55
|
-
- parameter names and types match the selected module interface
|
|
56
|
-
- missing deploy-time values return a blocker instead of a generated placeholder
|
|
@@ -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.
|
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-codegen/SKILL.md
DELETED
|
@@ -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.
|