@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-mermaid/SKILL.md
DELETED
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-mermaid
|
|
3
|
-
description: "Requests safe inline Mermaid for supported APEX Markdown slots. Use for compact flowcharts, sequences, state machines, ER models, Gantt views, renderer validation, accessible theming, and syntax troubleshooting from accepted artifact data."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Inline Mermaid
|
|
8
|
-
|
|
9
|
-
The current APEX document registry declares no Mermaid-capable slots. Do not request or emit an inline Mermaid fence
|
|
10
|
-
until a renderer registers a typed source, a supported slot, syntax validation, and a returned document receipt.
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
- The target template exposes a Mermaid-capable inline slot.
|
|
15
|
-
- Accepted artifact data contains every node, relationship, label, and time value to be shown.
|
|
16
|
-
- The renderer declares supported Mermaid syntax and validation behavior.
|
|
17
|
-
|
|
18
|
-
## Future Renderer Contract
|
|
19
|
-
|
|
20
|
-
When a renderer-supported slot exists, select the simplest diagram type that preserves accepted relationships. Apply
|
|
21
|
-
[syntax guidance](references/syntax.md) and [styling guidance](references/styling.md), then submit only the bounded
|
|
22
|
-
fence to that renderer. The renderer, rather than this skill, must validate syntax and return the document receipt.
|
|
23
|
-
|
|
24
|
-
Syntax and styling references are guidance targets, not active renderer slots. They do not make Mermaid output
|
|
25
|
-
available until a typed source, renderer registration, and receipt exist.
|
|
26
|
-
|
|
27
|
-
## Boundaries
|
|
28
|
-
|
|
29
|
-
- Do not create standalone architecture, network, runtime, as-built, WAF, cost, or compliance diagrams.
|
|
30
|
-
- Do not write or edit files, invoke deployment, or mutate source-of-truth artifacts, templates, schemas, or state.
|
|
31
|
-
- Do not use unaccepted inputs, infer missing values, or treat rendered Markdown as gate evidence.
|
|
32
|
-
- Do not embed Azure service icons, custom SVG, secrets, physical principal IDs, unsafe links, or Mermaid click actions.
|
|
33
|
-
- Do not claim syntax or visual validation from model inspection; only the renderer receipt supplies that evidence.
|
|
34
|
-
|
|
35
|
-
## Blockers
|
|
36
|
-
|
|
37
|
-
When the requested document slot is unsupported, absent, or cannot be filled from accepted data, return a blocker that
|
|
38
|
-
names the slot, diagram type, and missing renderer support or artifact data. Also block when renderer-version syntax,
|
|
39
|
-
escaping, or accessibility cannot be validated. Do not emit a substitute diagram or alter any source.
|
|
40
|
-
|
|
41
|
-
## Output
|
|
42
|
-
|
|
43
|
-
Return only the renderer request or its rendered inline document result and receipt. Preserve any projected artifact and
|
|
44
|
-
template hashes, validation status, and unresolved blockers.
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# Styling Guidance
|
|
2
|
-
|
|
3
|
-
Use a renderer-compatible neutral theme and limited semantic classes. Meaning must remain clear without color.
|
|
4
|
-
|
|
5
|
-
```mermaid
|
|
6
|
-
%%{init: {'theme': 'neutral'}}%%
|
|
7
|
-
graph LR
|
|
8
|
-
classDef gate stroke:#2563eb,stroke-width:2px;
|
|
9
|
-
INPUT["Accepted data"] --> GATE{"Supported slot"}:::gate
|
|
10
|
-
GATE --> OUTPUT["Rendered inline view"]
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Styling Rules
|
|
14
|
-
|
|
15
|
-
- Prefer one layout direction, consistent node shapes, and a small semantic class set.
|
|
16
|
-
- Use shape, border, and text labels together; never encode status or severity by color alone.
|
|
17
|
-
- Keep contrast readable in light and dark Markdown renderers. Use renderer-projected colors when available.
|
|
18
|
-
- Use subgraphs only for accepted ownership, trust, lifecycle, or resource boundaries.
|
|
19
|
-
- Keep edge labels short and place detail in surrounding prose when the slot permits it.
|
|
20
|
-
- Avoid service icons, custom SVG, background images, animations, click actions, and external CSS.
|
|
21
|
-
- Do not use emoji as the only identifier; assistive text must carry the meaning.
|
|
22
|
-
|
|
23
|
-
## Complexity Limits
|
|
24
|
-
|
|
25
|
-
When labels overlap, crossings obscure meaning, or the renderer cannot fit the slot, reduce the diagram to its primary
|
|
26
|
-
accepted relationship. Split independent concerns into supported slots or use a standalone diagram capability. Do not
|
|
27
|
-
hide nodes or drop material edges merely to make the view attractive.
|
|
28
|
-
|
|
29
|
-
## Renderer Validation
|
|
30
|
-
|
|
31
|
-
The renderer decides whether the slot accepts Mermaid, the theme directive is supported, syntax parses, and the result
|
|
32
|
-
fits the document. Inspect the renderer receipt for validation errors. Model inspection, Markdown source appearance, or
|
|
33
|
-
a successful document request is not visual-validation evidence.
|
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
# Syntax Guidance
|
|
2
|
-
|
|
3
|
-
Use one compact diagram in a fenced `mermaid` block for a renderer-supported inline slot.
|
|
4
|
-
|
|
5
|
-
## Choose The Diagram Type
|
|
6
|
-
|
|
7
|
-
| Accepted relationship | Diagram type |
|
|
8
|
-
| --- | --- |
|
|
9
|
-
| Branching process, dependency, or decision | `flowchart` or `graph` |
|
|
10
|
-
| Ordered interaction among actors | `sequenceDiagram` |
|
|
11
|
-
| Lifecycle states and transitions | `stateDiagram-v2` |
|
|
12
|
-
| Entity relationships and cardinality | `erDiagram` |
|
|
13
|
-
| Dated tasks and dependencies | `gantt` |
|
|
14
|
-
|
|
15
|
-
Use a standalone diagram capability for architecture, network, runtime, as-built, WAF, cost, or compliance visuals.
|
|
16
|
-
|
|
17
|
-
## Flowchart
|
|
18
|
-
|
|
19
|
-
```mermaid
|
|
20
|
-
graph TB
|
|
21
|
-
START["Accepted input"] --> CHECK{"Gate"}
|
|
22
|
-
CHECK -->|"Pass"| RENDER["Render slot"]
|
|
23
|
-
CHECK -->|"Block"| STOP["Return blocker"]
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
Use `TB` for vertical flows and `LR` for short horizontal flows. Group related nodes only when an accepted boundary
|
|
27
|
-
exists. Use `-->` for primary flow, `-.->` for an accepted optional relationship, and `==>` sparingly for an accepted
|
|
28
|
-
critical path. Label decisions and non-obvious edges.
|
|
29
|
-
|
|
30
|
-
## Sequence
|
|
31
|
-
|
|
32
|
-
```mermaid
|
|
33
|
-
sequenceDiagram
|
|
34
|
-
participant CLIENT as Client
|
|
35
|
-
participant API as API
|
|
36
|
-
participant STORE as Data store
|
|
37
|
-
CLIENT->>API: Accepted request
|
|
38
|
-
API->>STORE: Read accepted record
|
|
39
|
-
STORE-->>API: Result
|
|
40
|
-
API-->>CLIENT: Response
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Declare participants in first-use order. Use solid arrows for calls and dashed arrows for responses. Do not invent
|
|
44
|
-
authentication, retries, timing, or failure paths absent from accepted data.
|
|
45
|
-
|
|
46
|
-
## State
|
|
47
|
-
|
|
48
|
-
```mermaid
|
|
49
|
-
stateDiagram-v2
|
|
50
|
-
[*] --> Proposed
|
|
51
|
-
Proposed --> Accepted: Approve
|
|
52
|
-
Accepted --> Superseded: Replace
|
|
53
|
-
Superseded --> [*]
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
Use explicit transition labels and only accepted states. Avoid modeling an action as a state or implying a transition
|
|
57
|
-
the kernel does not authorize.
|
|
58
|
-
|
|
59
|
-
## Entity Relationship
|
|
60
|
-
|
|
61
|
-
```mermaid
|
|
62
|
-
erDiagram
|
|
63
|
-
WORKLOAD ||--o{ RESOURCE : contains
|
|
64
|
-
RESOURCE ||--o{ EVIDENCE : supported_by
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Use accepted cardinality. Keep entity and relationship names concise; do not expose sensitive field values.
|
|
68
|
-
|
|
69
|
-
## Gantt
|
|
70
|
-
|
|
71
|
-
```mermaid
|
|
72
|
-
gantt
|
|
73
|
-
title Accepted delivery window
|
|
74
|
-
dateFormat YYYY-MM-DD
|
|
75
|
-
section Delivery
|
|
76
|
-
Foundation :foundation, 2030-01-01, 2d
|
|
77
|
-
Validation :validation, after foundation, 1d
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
Use dates and durations only from accepted schedule data. A Gantt chart is a presentation, not authorization or proof
|
|
81
|
-
that a task started or completed.
|
|
82
|
-
|
|
83
|
-
## Safe Identifiers And Labels
|
|
84
|
-
|
|
85
|
-
- Use short, unique ASCII IDs; keep human-readable text in quoted labels or participant aliases.
|
|
86
|
-
- Keep labels factual and concise. Use renderer-supported line breaks only when validation confirms them.
|
|
87
|
-
- Avoid reserved keywords as IDs, duplicate IDs, unescaped quote characters, raw URLs, and HTML labels.
|
|
88
|
-
- Preserve accepted relationship direction; do not reverse arrows to improve layout.
|
|
89
|
-
- Omit unavailable values rather than inserting placeholders or guessed nodes.
|
|
90
|
-
|
|
91
|
-
## Troubleshooting
|
|
92
|
-
|
|
93
|
-
| Renderer finding | Correction |
|
|
94
|
-
| --- | --- |
|
|
95
|
-
| Parse error near label | Replace the display label with a quoted label and a simple ASCII ID. |
|
|
96
|
-
| Duplicate or merged nodes | Give every semantic node a unique ID while retaining its accepted display label. |
|
|
97
|
-
| Unsupported directive or diagram | Use the renderer-supported syntax or return an unsupported-capability blocker. |
|
|
98
|
-
| Unreadable dense graph | Split by accepted concern or use the standalone diagram capability. |
|
|
99
|
-
| Relationship appears wrong | Check the accepted source mapping; never fix layout by changing semantics. |
|
package/assets/client-projections/github-copilot-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,46 +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 service questions in the workload panel as a preference boundary. Present the kernel recommendation, then
|
|
28
|
-
capture retained, prohibited, and preferred services, SKU preferences, and environment overrides without selecting
|
|
29
|
-
architecture, SKUs, or implementation details.
|
|
30
|
-
7. Submit the task-context-defined output through `apex/requirementsComplete`, invoke the required Reviewer, and handle
|
|
31
|
-
`needs_review` through one native findings panel and `apex/reviewDecide`.
|
|
32
|
-
8. After a clean or fully dispositioned review, ask for explicit Gate 1 approval. Call `apex/gateDecide` only after the
|
|
33
|
-
user chooses Proceed, then continue to Architecture in the same turn.
|
|
34
|
-
|
|
35
|
-
The kernel catalog and its versioned input contracts are authoritative. Do not choose architecture, SKUs, or
|
|
36
|
-
implementation details while gathering requirements.
|
|
37
|
-
|
|
38
|
-
## Boundaries
|
|
39
|
-
|
|
40
|
-
Do not read task context for `needs_input`, a task owned by another role, or a stale task ID. Treat `APEX_STALE` as a
|
|
41
|
-
fresh-status requirement, and return kernel validation or authorization errors without fabricating a requirements
|
|
42
|
-
result.
|
|
43
|
-
|
|
44
|
-
## Output
|
|
45
|
-
|
|
46
|
-
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.
|