@apexops/cli 0.10.0-next.4 → 0.11.0-next.0
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/README.md +40 -0
- package/assets/capability-packs/registry.v1.json +1 -62
- package/assets/client-projection-metadata/copilot-cli-agent-tools.json +20 -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 -21
- 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 +3 -0
- 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 -23
- 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 +419 -4237
- 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 +18 -2
- package/dist/cli.js +222 -65
- 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 +833 -78
- package/dist/runtime-binding.d.ts +37 -0
- package/dist/runtime-binding.js +131 -0
- package/dist/service.d.ts +676 -31
- package/dist/service.js +5270 -587
- package/dist/state-transfer.js +44 -7
- 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 -90
- 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 -86
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-requirements.agent.md +0 -92
- 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 -60
- 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 -43
- 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 -99
- 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 -96
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-requirements.agent.md +0 -101
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-reviewer.agent.md +0 -59
- 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 -43
- 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 -92
- package/assets/customizations/.github/agents/apex-operator.agent.md +0 -72
- package/assets/customizations/.github/agents/apex-planner.agent.md +0 -89
- package/assets/customizations/.github/agents/apex-requirements.agent.md +0 -94
- package/assets/customizations/.github/agents/apex-reviewer.agent.md +0 -56
- package/assets/customizations/.github/mcp.json +0 -60
- 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,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-vscode/.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-vscode/.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.
|
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-planning/SKILL.md
DELETED
|
@@ -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.
|
package/assets/client-projections/github-copilot-vscode/.github/skills/apex-requirements/SKILL.md
DELETED
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-requirements
|
|
3
|
-
description: "Provides internal APEX requirements guidance for typed intake, scope, constraints, and budget."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## APEX Requirements
|
|
8
|
-
|
|
9
|
-
Use this skill only for an active requirements task.
|
|
10
|
-
|
|
11
|
-
## Prerequisites
|
|
12
|
-
|
|
13
|
-
- `apex/taskContext` returns a requirements task envelope.
|
|
14
|
-
- The interactive Requirements agent is active when user input may be needed.
|
|
15
|
-
- The kernel's returned input request is the authoritative requirements question catalog.
|
|
16
|
-
|
|
17
|
-
## Workflow
|
|
18
|
-
|
|
19
|
-
1. Call `apex/nextTask`. Validate that a returned `task` is owned by the requirements role before reading its context.
|
|
20
|
-
2. When it returns `needs_input`, use its `intake` metadata and `questions` exactly as returned; do not maintain a
|
|
21
|
-
separate client-side question list.
|
|
22
|
-
3. Ask the returned questions through the active client projection's question mechanism. Record each response as a
|
|
23
|
-
supplied value, typed unknown, or explicit deferral with its owner; never replace an unknown with an inferred value.
|
|
24
|
-
4. Submit that request only through `apex/recordInput`, preserving its request ID, expected journal head, and owner
|
|
25
|
-
epoch.
|
|
26
|
-
5. Call `apex/nextTask` again and repeat until it returns a requirements `task`; only then read `apex/taskContext`.
|
|
27
|
-
6. Treat the service-preferences round as a preference boundary. Capture retained, prohibited, and preferred services,
|
|
28
|
-
SKU preferences, and environment overrides without selecting architecture, SKUs, or implementation details.
|
|
29
|
-
7. Stage the task-context-defined requirements output, complete the requirements task, and wait for the required review
|
|
30
|
-
result before reporting that Gate 1 is ready. Only the kernel opens or evaluates Gate 1.
|
|
31
|
-
|
|
32
|
-
The kernel catalog and its versioned input contracts are authoritative. Do not choose architecture, SKUs, or
|
|
33
|
-
implementation details while gathering requirements.
|
|
34
|
-
|
|
35
|
-
## Boundaries
|
|
36
|
-
|
|
37
|
-
Do not read task context for `needs_input`, a task owned by another role, or a stale task ID. Treat `APEX_STALE` as a
|
|
38
|
-
fresh-status requirement, and return kernel validation or authorization errors without fabricating a requirements
|
|
39
|
-
result.
|
|
40
|
-
|
|
41
|
-
## Output
|
|
42
|
-
|
|
43
|
-
Return the kernel result plus any unresolved user-owned fields.
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-terraform-import
|
|
3
|
-
description: "Assess Terraform adoption of existing Azure resources in APEX. Use for scoped inventory evidence, import mapping, provider and module locks, drift assessment, and adoption attestation."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Terraform Import Assessment
|
|
8
|
-
|
|
9
|
-
Use this skill for an active Terraform adoption task concerning existing resources. It evaluates accepted inventory and
|
|
10
|
-
mapping evidence, then records adoption intent; authorized capabilities own discovery, configuration generation,
|
|
11
|
-
stateful operations, validation, and lifecycle changes.
|
|
12
|
-
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- `apex/taskContext` identifies the accepted adoption task, target boundary, resource scope, and acceptance criteria.
|
|
16
|
-
- Accepted inventory evidence identifies its observation scope, completeness, redactions, and observation time.
|
|
17
|
-
- Required mapping, provider/module lock, and validation capability receipts are accepted and current for that target.
|
|
18
|
-
|
|
19
|
-
## Workflow
|
|
20
|
-
|
|
21
|
-
1. Apply [Import assessment](references/import-assessment.md) to match accepted inventory facts to resource mappings
|
|
22
|
-
and ownership boundaries.
|
|
23
|
-
2. Apply [Mapping and adoption attestation](references/mapping-and-adoption-attestation.md) to bind each candidate to
|
|
24
|
-
its intended address and accepted outcome evidence.
|
|
25
|
-
3. Record a typed adoption proposal with scoped identifiers, exact provider/module locks, expected managed identities,
|
|
26
|
-
and reconciliation criteria.
|
|
27
|
-
4. Apply [Adoption attestation](references/adoption-attestation.md) to evaluate authorized outcomes and remaining drift.
|
|
28
|
-
5. Apply [Import mapping and reconciliation](references/import-mapping.md) to preserve candidate boundaries and
|
|
29
|
-
expected reconciliation without generating import blocks or executing a stateful operation.
|
|
30
|
-
6. Route missing inventory, mapping, stateful-operation, or validation capabilities to the kernel as blockers. Never
|
|
31
|
-
replace a missing receipt with inferred configuration or model memory.
|
|
32
|
-
|
|
33
|
-
## Boundaries
|
|
34
|
-
|
|
35
|
-
- Do not query cloud inventories, inspect state, generate configuration, invoke Terraform, or mutate files.
|
|
36
|
-
- Do not perform import, preview, apply, or deployment actions.
|
|
37
|
-
- Import assessment does not establish ownership, compliance, a drift-free result, or deployment authorization without
|
|
38
|
-
accepted evidence.
|
|
39
|
-
|
|
40
|
-
## References
|
|
41
|
-
|
|
42
|
-
- [Import assessment](references/import-assessment.md) - scoped inventory, mappings, locks, and adoption intent.
|
|
43
|
-
- [Mapping and adoption attestation](references/mapping-and-adoption-attestation.md) - candidate-to-address evidence
|
|
44
|
-
and outcome review.
|
|
45
|
-
- [Adoption attestation](references/adoption-attestation.md) - receipt requirements, reconciliation, and handoff.
|
|
46
|
-
- [Import mapping and reconciliation](references/import-mapping.md) - candidate records, drift review, and blocked
|
|
47
|
-
operations.
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
# Adoption Attestation
|
|
2
|
-
|
|
3
|
-
An accepted adoption receipt identifies the active run, scoped target, candidate identifiers, exact provider and module
|
|
4
|
-
locks, authorized operation outcome, reconciliation evidence, observation time, and unresolved differences. Evaluate
|
|
5
|
-
the receipt against the declared criteria: each approved candidate is accounted for, no unapproved target is included,
|
|
6
|
-
and remaining differences are classified rather than silently accepted.
|
|
7
|
-
|
|
8
|
-
Carry accepted evidence identifiers and unresolved drift into the next kernel-selected task. A successful adoption
|
|
9
|
-
outcome is not a policy, security, cost, or deployment approval. Stale, partial, mismatched, or absent attestation is a
|
|
10
|
-
blocker and must be routed to the owning authorized capability.
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
# Import Assessment
|
|
2
|
-
|
|
3
|
-
Start with accepted inventory evidence that is complete for the declared subscription, resource-group, resource-type,
|
|
4
|
-
and result boundary. Treat each observed resource as a candidate until its mapping, dependencies, ownership boundary,
|
|
5
|
-
and required configuration are accepted. Do not infer resource facts from names or incomplete inventory pages.
|
|
6
|
-
|
|
7
|
-
For every candidate, record the scoped resource identifier, intended Terraform address, resource mapping evidence,
|
|
8
|
-
exact provider lock, exact module lock when adoption uses a module, required identity, network and diagnostics intent,
|
|
9
|
-
and reconciliation criteria. Preserve parent-child and cross-resource dependencies so the authorized capability can
|
|
10
|
-
sequence adoption safely.
|
|
11
|
-
|
|
12
|
-
Raw resource mapping may be a temporary accepted stage when an AVM binding cannot yet represent the resource. Record
|
|
13
|
-
the target module transition, rationale, and stable-address strategy as typed intent. Missing mapping evidence, an
|
|
14
|
-
unresolved lock, or an unavailable authorized capability is a blocker.
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# Import Mapping And Reconciliation
|
|
2
|
-
|
|
3
|
-
Use accepted inventory evidence to describe Terraform adoption candidates. It does not authorize a cloud read,
|
|
4
|
-
configuration generation, state import, plan, or apply.
|
|
5
|
-
|
|
6
|
-
## Candidate Record
|
|
7
|
-
|
|
8
|
-
For every candidate, preserve:
|
|
9
|
-
|
|
10
|
-
- scoped resource identifier and inventory observation boundary;
|
|
11
|
-
- intended Terraform address and mapping rationale;
|
|
12
|
-
- exact provider lock and any accepted module lock;
|
|
13
|
-
- parent, child, and cross-resource dependencies;
|
|
14
|
-
- identity, network, diagnostics, and ownership intent; and
|
|
15
|
-
- expected reconciliation result and remaining-drift classification.
|
|
16
|
-
|
|
17
|
-
## Review Checklist
|
|
18
|
-
|
|
19
|
-
- Reject incomplete pages, inferred names, ambiguous resource types, and mappings without evidence.
|
|
20
|
-
- Keep raw-resource adoption and later AVM refactoring as distinct, reviewable stages.
|
|
21
|
-
- Require an explicit stable-address strategy before any stateful transition.
|
|
22
|
-
- Treat unexpected create, delete, replacement, or drift as a blocker for the owning authorized capability.
|
|
23
|
-
|
|
24
|
-
## Blocked Operations
|
|
25
|
-
|
|
26
|
-
Terraform import apply, state mutation, cloud inventory reads, generated import blocks, preview, and deployment remain
|
|
27
|
-
outside this skill.
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
# Mapping and Adoption Attestation
|
|
2
|
-
|
|
3
|
-
For each accepted inventory candidate, record the stable resource identifier, intended Terraform address, mapping
|
|
4
|
-
rationale, parent or dependent relationships, exact provider and module locks, and target boundary. Treat an address
|
|
5
|
-
as proposed until an authorized capability returns target-matched evidence.
|
|
6
|
-
|
|
7
|
-
An adoption attestation accounts for every approved candidate and no unapproved target. It records the authorized
|
|
8
|
-
outcome, reconciliation evidence, observation time, remaining differences, and any accepted exception. Classify
|
|
9
|
-
unresolved drift rather than treating it as a successful adoption.
|
|
10
|
-
|
|
11
|
-
Missing inventory scope, mapping evidence, stateful-operation evidence, or validation evidence is a blocker. This
|
|
12
|
-
reference does not authorize discovery, configuration generation, state changes, import, preview, or apply.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-terraform-patterns
|
|
3
|
-
description: "Apply approved Terraform architecture intent in APEX. Use for hub-spoke, private endpoints, diagnostics, AVM module locks, and CodeGen acceptance."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Terraform Patterns
|
|
8
|
-
|
|
9
|
-
Use this skill for an active Terraform-bound planning or CodeGen task. It records approved architecture intent and
|
|
10
|
-
acceptance criteria; authorized capabilities own source inspection, generation, validation, and lifecycle changes.
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
- `apex/taskContext` identifies an accepted Terraform track task, scoped target, and typed binding inputs.
|
|
15
|
-
- Architecture, governance, security, and monitoring decisions are accepted for that target.
|
|
16
|
-
- Required capability receipts are accepted, current, target-matched, and include the exact provider and module locks.
|
|
17
|
-
|
|
18
|
-
## Workflow
|
|
19
|
-
|
|
20
|
-
1. Select only patterns supported by accepted architecture and track bindings.
|
|
21
|
-
2. Apply [Network and observability](references/network-and-observability.md) for hub-spoke, private connectivity,
|
|
22
|
-
and diagnostics intent.
|
|
23
|
-
3. Apply [Module locks and CodeGen acceptance](references/module-locks-and-codegen-acceptance.md) for AVM selection,
|
|
24
|
-
exact locks, and evidence requirements.
|
|
25
|
-
4. Apply [Module composition and state boundaries](references/module-composition-and-state-boundaries.md) to define
|
|
26
|
-
stable interfaces and record refactoring migration intent.
|
|
27
|
-
5. Apply [Plan and change assessment](references/plan-and-change-assessment.md) to classify proposed actions and
|
|
28
|
-
surface replacement, deletion, or stateful-resource risk.
|
|
29
|
-
6. Submit typed intent only through an authorized capability. Treat unavailable capabilities, missing locks, stale
|
|
30
|
-
receipts, or unaccepted evidence as blockers.
|
|
31
|
-
|
|
32
|
-
## Boundaries
|
|
33
|
-
|
|
34
|
-
- Do not write Terraform, inspect provider sources, resolve versions, invoke Terraform, or mutate files.
|
|
35
|
-
- Do not discover cloud resources, validate infrastructure, preview changes, or deploy.
|
|
36
|
-
- CodeGen, validation, and operations remain responsible for their own authorized receipts; pattern selection does not
|
|
37
|
-
bypass policy, cost, approval, or deployment gates.
|
|
38
|
-
|
|
39
|
-
## References
|
|
40
|
-
|
|
41
|
-
- [Network and observability](references/network-and-observability.md) - hub-spoke, private endpoints, and diagnostics.
|
|
42
|
-
- [Module locks and CodeGen acceptance](references/module-locks-and-codegen-acceptance.md) - AVM binding, exact
|
|
43
|
-
locks, and receipt-based acceptance.
|
|
44
|
-
- [Module composition and refactor intent](references/module-composition-and-refactor.md) - boundary, interface, and
|
|
45
|
-
state-transition review criteria.
|
|
46
|
-
- [Module composition and state boundaries](references/module-composition-and-state-boundaries.md) - output-to-input
|
|
47
|
-
interfaces and refactoring migration intent.
|
|
48
|
-
- [Plan and change assessment](references/plan-and-change-assessment.md) - receipt-gated action classification and
|
|
49
|
-
stateful-resource risk review.
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
# Module Composition And Refactor Intent
|
|
2
|
-
|
|
3
|
-
Use accepted architecture and exact locks to describe a Terraform module boundary. This reference does not authorize
|
|
4
|
-
Terraform source generation, state inspection, state moves, planning, or apply.
|
|
5
|
-
|
|
6
|
-
## Composition Checklist
|
|
7
|
-
|
|
8
|
-
- Group resources only when they share lifecycle, ownership, and a cohesive interface.
|
|
9
|
-
- Keep cross-cutting diagnostics, policy, tags, and environment-specific bindings explicit at the accepted root
|
|
10
|
-
boundary.
|
|
11
|
-
- Define typed inputs, stable outputs, identity requirements, private networking, and dependent-output contracts.
|
|
12
|
-
- Prefer an accepted AVM interface when it meets the requirement; document an exception, rationale, and review criteria
|
|
13
|
-
when it does not.
|
|
14
|
-
- Preserve stable resource addresses across module extraction. A state transition requires a separately authorized,
|
|
15
|
-
reviewed operation and evidence.
|
|
16
|
-
|
|
17
|
-
## Plan Review Signals
|
|
18
|
-
|
|
19
|
-
Treat replacement, deletion, unexpected address changes, unmanaged dependencies, provider-lock drift, or missing
|
|
20
|
-
diagnostics as blockers. A clean intent record is not a Terraform plan or proof of safe state migration.
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
# Module Composition and State Boundaries
|
|
2
|
-
|
|
3
|
-
Define each module by its stable inputs, outputs, ownership boundary, dependencies, and accepted locks. Compose modules
|
|
4
|
-
through declared outputs and inputs; do not substitute literal resource identifiers for an interface contract.
|
|
5
|
-
|
|
6
|
-
Group resources only when they share a lifecycle and a clear responsibility. Keep cross-cutting monitoring, identity,
|
|
7
|
-
policy, and provider configuration at an explicit boundary unless accepted architecture says otherwise.
|
|
8
|
-
|
|
9
|
-
For a refactor, record every source address, destination address, interface change, dependency, migration receipt, and
|
|
10
|
-
rollback condition as typed intent. An address change is not safe until an authorized capability supplies accepted
|
|
11
|
-
state-transition evidence. Do not perform or prescribe state operations.
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
# Module Locks And CodeGen Acceptance
|
|
2
|
-
|
|
3
|
-
Prefer an accepted Azure Verified Module when its locked interface can satisfy the approved requirements. Record the
|
|
4
|
-
module family, exact module lock, exact provider lock, required inputs, identity, network, diagnostics, tags, and
|
|
5
|
-
dependent outputs as typed constraints. A lock is valid only when its supporting capability receipt is accepted and
|
|
6
|
-
matches the active target and binding.
|
|
7
|
-
|
|
8
|
-
An AVM selection is not automatically compliant. CodeGen must return an authorized receipt for the locked bindings;
|
|
9
|
-
validation must return accepted evidence for syntax, security baseline, policy compatibility, and preview criteria. When
|
|
10
|
-
a module cannot express a requirement, record the exception, alternative intent, rationale, and traceability before
|
|
11
|
-
requesting generation.
|
|
12
|
-
|
|
13
|
-
Use typed parameters for environment-specific values and never carry secret literals in intent. Preserve stable resource
|
|
14
|
-
identity and required outputs for dependent bindings. Missing, stale, mismatched, or unavailable evidence is a blocker.
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
# Network And Observability
|
|
2
|
-
|
|
3
|
-
Use hub-spoke topology only when shared connectivity, inspection, DNS, or platform services are accepted architectural
|
|
4
|
-
requirements. Spokes connect to the hub under accepted routing, peering, subnet, and network-security bindings; do not
|
|
5
|
-
infer these choices from naming or module defaults.
|
|
6
|
-
|
|
7
|
-
Private endpoint intent is complete only when the target subresource, approved subnet, private DNS zone, and DNS zone
|
|
8
|
-
group are all bound. A public-access exception requires accepted risk evidence and a policy-compatible boundary.
|
|
9
|
-
|
|
10
|
-
Every governed resource needs diagnostics and metrics mapped to the accepted monitoring destination. Categories,
|
|
11
|
-
retention, cost, ownership, and destination are typed decisions. Generated settings and deployment outcomes require
|
|
12
|
-
accepted validation and operation receipts for the same scoped target.
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
# Plan and Change Assessment
|
|
2
|
-
|
|
3
|
-
Assess accepted plan evidence by its declared actions, target scope, and locked provider or module context.
|
|
4
|
-
Do not infer an action from configuration or perform a preview.
|
|
5
|
-
|
|
6
|
-
| Action class | Assessment intent |
|
|
7
|
-
| --- | --- |
|
|
8
|
-
| Create | Confirm the target is in scope and its governance evidence is current. |
|
|
9
|
-
| In-place update | Confirm the changed properties and dependent interfaces are accepted. |
|
|
10
|
-
| Replace | Escalate downtime, data, identity, network, and rollback consequences for approval. |
|
|
11
|
-
| Delete | Require explicit ownership, recovery, and approval evidence before handoff. |
|
|
12
|
-
| Read | Treat it as observation only; it does not establish desired-state acceptance. |
|
|
13
|
-
|
|
14
|
-
## Stateful and Drift Signals
|
|
15
|
-
|
|
16
|
-
Treat replacements or deletions of data, identity, network, and secret-bearing resources as blockers until an
|
|
17
|
-
authorized capability records the required recovery and approval evidence. A broad update set can indicate a
|
|
18
|
-
provider-schema, collection-order, or configuration-drift difference; record the uncertainty instead of assuming it
|
|
19
|
-
is harmless.
|
|
20
|
-
|
|
21
|
-
## Handoff
|
|
22
|
-
|
|
23
|
-
Record the receipt identifier, target, exact locks, action summary, accepted exceptions, and unresolved risks.
|
|
24
|
-
CodeGen and validation capabilities own preview generation, provider inspection, and any stateful follow-up.
|