@apexops/cli 0.10.0-next.5 → 0.11.0-next.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/capability-packs/registry.v1.json +1 -62
- package/assets/client-projection-metadata/copilot-cli-agent-tools.json +12 -0
- package/assets/client-projections/github-copilot-cli/.github/copilot/settings.json +13 -0
- package/assets/client-projections/github-copilot-cli/.github/instructions/apex-prompt-authoring.instructions.md +1 -1
- package/assets/client-projections/github-copilot-cli/.github/workflows/governance-policy-baseline.yml +101 -0
- package/assets/client-projections/github-copilot-cli/tools/schemas/governance-baseline.schema.json +118 -0
- package/assets/client-projections/github-copilot-cli/tools/scripts/collect-governance-baseline.ps1 +817 -0
- package/assets/config/capability-packs.v1.json +1 -32
- package/assets/config/governance-reference.v1.json +26379 -0
- package/assets/config/recipe-packs.v1.json +1 -26
- package/assets/config/runtime-bundle.v1.json +7 -7
- package/assets/config/toolchain.v1.json +35 -33
- package/assets/config/workflow.v1.json +103 -72
- package/assets/customizations/.github/agents/apex-codegen.agent.md +8 -22
- package/assets/customizations/.github/agents/apex-validator.agent.md +14 -20
- package/assets/customizations/.github/agents/apex.agent.md +108 -75
- package/assets/customizations/.github/copilot/settings.json +13 -0
- package/assets/customizations/.github/instructions/apex-prompt-authoring.instructions.md +1 -1
- package/assets/customizations/.github/skills/apex-architecture/SKILL.md +62 -18
- package/assets/customizations/.github/skills/apex-artifacts/SKILL.md +28 -6
- package/assets/customizations/.github/skills/apex-azure-adr/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-cloud-migrate/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-compliance/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-compute/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-cost-optimization/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-defaults/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-defaults/references/governance-effects.md +5 -3
- package/assets/customizations/.github/skills/apex-azure-deploy/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-diagnostics/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-governance/SKILL.md +19 -3
- package/assets/customizations/.github/skills/apex-azure-governance/references/evidence-interpretation.md +38 -3
- package/assets/customizations/.github/skills/apex-azure-kusto/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-prepare/SKILL.md +5 -3
- package/assets/customizations/.github/skills/apex-azure-quotas/SKILL.md +6 -2
- package/assets/customizations/.github/skills/apex-azure-quotas/references/capacity-decision-rules.md +4 -3
- package/assets/customizations/.github/skills/apex-azure-quotas/references/operational-checklist.md +3 -2
- package/assets/customizations/.github/skills/apex-azure-rbac/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-resources/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-storage/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-azure-validate/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-bicep-patterns/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-codegen/SKILL.md +6 -2
- package/assets/customizations/.github/skills/apex-entra-app-registration/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-mermaid/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-microsoft-docs/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-next/SKILL.md +99 -0
- package/assets/customizations/.github/skills/apex-operations/SKILL.md +46 -16
- package/assets/customizations/.github/skills/apex-planning/SKILL.md +48 -19
- package/assets/customizations/.github/skills/apex-requirements/SKILL.md +61 -26
- package/assets/customizations/.github/skills/apex-terraform-import/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-terraform-patterns/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-terraform-test/SKILL.md +3 -0
- package/assets/customizations/.github/skills/apex-unslop/LICENSE.txt +21 -0
- package/assets/customizations/.github/skills/apex-unslop/SKILL.md +94 -0
- package/assets/customizations/.github/skills/apex-workflow/SKILL.md +15 -5
- package/assets/customizations/.github/workflows/governance-policy-baseline.yml +101 -0
- package/assets/customizations/README.md +8 -9
- package/assets/customizations/manifest.json +167 -209
- package/assets/customizations/tools/schemas/governance-baseline.schema.json +118 -0
- package/assets/customizations/tools/scripts/collect-governance-baseline.ps1 +817 -0
- package/assets/manifest.json +423 -4241
- package/assets/schemas/governance-baseline.schema.json +118 -0
- package/dist/assets.d.ts +18 -2
- package/dist/assets.js +115 -35
- package/dist/bootstrap-wizard.d.ts +37 -0
- package/dist/bootstrap-wizard.js +259 -0
- package/dist/cli.d.ts +17 -2
- package/dist/cli.js +180 -63
- package/dist/dependency-revision.js +8 -0
- package/dist/errors.d.ts +6 -1
- package/dist/errors.js +55 -0
- package/dist/host-profile.d.ts +47 -0
- package/dist/host-profile.js +269 -0
- package/dist/mcp-output-schemas.d.ts +43 -0
- package/dist/mcp-output-schemas.js +279 -0
- package/dist/mcp-tool-effects.d.ts +101 -0
- package/dist/mcp-tool-effects.js +66 -0
- package/dist/mcp.d.ts +50 -3
- package/dist/mcp.js +800 -87
- package/dist/runtime-binding.d.ts +37 -0
- package/dist/runtime-binding.js +131 -0
- package/dist/service.d.ts +643 -38
- package/dist/service.js +4937 -662
- package/dist/state-transfer.js +21 -1
- package/dist/target-scope.d.ts +4 -0
- package/dist/target-scope.js +9 -0
- package/dist/version.d.ts +3 -1
- package/dist/version.js +19 -1
- package/dist/workflow-validators.d.ts +20 -3
- package/dist/workflow-validators.js +408 -67
- package/dist/workspace-root.d.ts +7 -0
- package/dist/workspace-root.js +67 -0
- package/package.json +11 -12
- package/assets/capability-packs/azure-governance-discovery/source/scripts/discover.py +0 -1189
- package/assets/capability-packs/azure-governance-discovery/source/scripts/render_governance.py +0 -676
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-architect.agent.md +0 -91
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-operator.agent.md +0 -75
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-planner.agent.md +0 -88
- package/assets/client-projections/github-copilot-cli/.github/agents/apex-requirements.agent.md +0 -99
- package/assets/client-projections/github-copilot-cli/.github/agents/apex.agent.md +0 -88
- package/assets/client-projections/github-copilot-cli/.github/mcp.json +0 -65
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-architecture/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/SKILL.md +0 -65
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/references/presentation-conventions.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/references/reference-only-outlines.md +0 -78
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/architecture-assessment.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/cost-estimate.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/deployment-summary.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/governance-constraints.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/implementation-plan.md +0 -43
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/operations-runbook.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/requirements.md +0 -42
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-artifacts/templates/resource-inventory.md +0 -29
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-examples.md +0 -38
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-guardrails.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-quality.md +0 -21
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-adr/references/decision-record-fields.md +0 -57
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/SKILL.md +0 -55
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/lambda-to-functions-assessment.md +0 -29
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/migration-readiness.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/staged-validation-handoff.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cloud-migrate/references/workload-mapping.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compliance/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compliance/references/compliance-finding-criteria.md +0 -63
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compliance/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/references/compute-selection.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/references/pricing-evidence.md +0 -11
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-compute/references/recommendation-and-scale-rules.md +0 -44
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cost-optimization/SKILL.md +0 -61
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cost-optimization/references/cost-assessment-criteria.md +0 -61
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-cost-optimization/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/SKILL.md +0 -59
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/avm-binding-guidance.md +0 -29
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/baseline-fallbacks.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/cost-monitoring.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/decision-boundaries.md +0 -19
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/governance-effects.md +0 -28
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/naming.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/network-planning.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/security-baseline.md +0 -40
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/service-selection.md +0 -51
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-defaults/references/tag-precedence.md +0 -31
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-deploy/SKILL.md +0 -50
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-deploy/references/operational-checklist.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-deploy/references/preview-recovery-verification.md +0 -48
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-diagnostics/SKILL.md +0 -60
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-diagnostics/references/diagnostic-interpretation.md +0 -42
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-diagnostics/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-governance/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-governance/references/evidence-interpretation.md +0 -58
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-governance/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-kusto/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-kusto/references/kql-evidence-interpretation.md +0 -41
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-kusto/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-prepare/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-prepare/references/functions-recipe-pack.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-prepare/references/preparation-lineage.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-quotas/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-quotas/references/capacity-decision-rules.md +0 -48
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-quotas/references/operational-checklist.md +0 -23
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-rbac/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-rbac/references/assignment-intent.md +0 -39
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-rbac/references/least-privilege-selection.md +0 -50
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-resources/SKILL.md +0 -54
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-resources/references/inventory-query-patterns.md +0 -49
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-resources/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/SKILL.md +0 -35
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/references/security-and-governance.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/references/service-auth-and-sdk-boundary.md +0 -33
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-storage/references/storage-selection.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-validate/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-validate/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-azure-validate/references/preflight-evidence.md +0 -43
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/SKILL.md +0 -41
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/avm-and-codegen-acceptance.md +0 -11
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/codegen-acceptance-checklist.md +0 -46
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/compiler-and-provider-gotchas.md +0 -74
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/module-interfaces-and-parameters.md +0 -56
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-bicep-patterns/references/network-and-observability.md +0 -52
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-codegen/SKILL.md +0 -32
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/capability-receipts.md +0 -21
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/design-and-diagnostics.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/oauth-registration-model.md +0 -26
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-entra-app-registration/references/permissions-and-credentials.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-mermaid/SKILL.md +0 -44
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-mermaid/references/styling.md +0 -33
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-mermaid/references/syntax.md +0 -99
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-microsoft-docs/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-microsoft-docs/references/research-method.md +0 -91
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-operations/SKILL.md +0 -34
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-planning/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-requirements/SKILL.md +0 -46
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/SKILL.md +0 -47
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/adoption-attestation.md +0 -10
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/import-assessment.md +0 -14
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/import-mapping.md +0 -27
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-import/references/mapping-and-adoption-attestation.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/module-composition-and-refactor.md +0 -20
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/module-composition-and-state-boundaries.md +0 -11
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/module-locks-and-codegen-acceptance.md +0 -14
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/network-and-observability.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-patterns/references/plan-and-change-assessment.md +0 -24
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/evidence-acceptance.md +0 -10
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/plan-mode-and-mock-design.md +0 -12
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/plan-mode-test-design.md +0 -23
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-terraform-test/references/test-design.md +0 -13
- package/assets/client-projections/github-copilot-cli/.github/skills/apex-workflow/SKILL.md +0 -37
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-architect.agent.md +0 -100
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-codegen.agent.md +0 -62
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-operator.agent.md +0 -79
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-planner.agent.md +0 -98
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-requirements.agent.md +0 -108
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-reviewer.agent.md +0 -63
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex-validator.agent.md +0 -61
- package/assets/client-projections/github-copilot-vscode/.github/agents/apex.agent.md +0 -107
- package/assets/client-projections/github-copilot-vscode/.github/copilot-instructions.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-agent-authoring.instructions.md +0 -14
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-artifact-contracts.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-automation.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-azure-yaml.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-bicep.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-code-quality.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-context.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-documentation.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-governance.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-instruction-authoring.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-javascript.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-json.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-markdown.instructions.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-powershell.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-prompt-authoring.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-python.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-file-edits.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-shell.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-shell.instructions.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-skill-authoring.instructions.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-terraform.instructions.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-architecture/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/SKILL.md +0 -65
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/references/presentation-conventions.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/references/reference-only-outlines.md +0 -78
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/architecture-assessment.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/cost-estimate.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/deployment-summary.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/governance-constraints.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/implementation-plan.md +0 -43
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/operations-runbook.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/requirements.md +0 -42
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-artifacts/templates/resource-inventory.md +0 -29
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-examples.md +0 -38
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-guardrails.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-quality.md +0 -21
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-adr/references/decision-record-fields.md +0 -57
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/SKILL.md +0 -55
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/lambda-to-functions-assessment.md +0 -29
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/migration-readiness.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/staged-validation-handoff.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cloud-migrate/references/workload-mapping.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compliance/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compliance/references/compliance-finding-criteria.md +0 -63
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compliance/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/references/compute-selection.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/references/pricing-evidence.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-compute/references/recommendation-and-scale-rules.md +0 -44
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cost-optimization/SKILL.md +0 -61
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cost-optimization/references/cost-assessment-criteria.md +0 -61
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-cost-optimization/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/SKILL.md +0 -59
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/avm-binding-guidance.md +0 -29
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/baseline-fallbacks.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/cost-monitoring.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/decision-boundaries.md +0 -19
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/governance-effects.md +0 -28
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/naming.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/network-planning.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/security-baseline.md +0 -40
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/service-selection.md +0 -51
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-defaults/references/tag-precedence.md +0 -31
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/SKILL.md +0 -50
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/references/operational-checklist.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-deploy/references/preview-recovery-verification.md +0 -48
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-diagnostics/SKILL.md +0 -60
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-diagnostics/references/diagnostic-interpretation.md +0 -42
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-diagnostics/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-governance/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-governance/references/evidence-interpretation.md +0 -58
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-governance/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/SKILL.md +0 -58
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/references/kql-evidence-interpretation.md +0 -41
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-kusto/references/operational-checklist.md +0 -25
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-prepare/SKILL.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-prepare/references/functions-recipe-pack.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-prepare/references/preparation-lineage.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-quotas/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-quotas/references/capacity-decision-rules.md +0 -48
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-quotas/references/operational-checklist.md +0 -23
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-rbac/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-rbac/references/assignment-intent.md +0 -39
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-rbac/references/least-privilege-selection.md +0 -50
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-resources/SKILL.md +0 -54
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-resources/references/inventory-query-patterns.md +0 -49
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-resources/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/SKILL.md +0 -35
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/references/security-and-governance.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/references/service-auth-and-sdk-boundary.md +0 -33
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-storage/references/storage-selection.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/references/operational-checklist.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-azure-validate/references/preflight-evidence.md +0 -43
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/SKILL.md +0 -41
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/avm-and-codegen-acceptance.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/codegen-acceptance-checklist.md +0 -46
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/compiler-and-provider-gotchas.md +0 -74
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/module-interfaces-and-parameters.md +0 -56
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-bicep-patterns/references/network-and-observability.md +0 -52
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-codegen/SKILL.md +0 -32
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/capability-receipts.md +0 -21
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/design-and-diagnostics.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/oauth-registration-model.md +0 -26
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-entra-app-registration/references/permissions-and-credentials.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-mermaid/SKILL.md +0 -44
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-mermaid/references/styling.md +0 -33
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-mermaid/references/syntax.md +0 -99
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-microsoft-docs/SKILL.md +0 -53
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-microsoft-docs/references/research-method.md +0 -91
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-operations/SKILL.md +0 -34
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-planning/SKILL.md +0 -36
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-requirements/SKILL.md +0 -46
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/SKILL.md +0 -47
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/adoption-attestation.md +0 -10
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/import-assessment.md +0 -14
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/import-mapping.md +0 -27
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-import/references/mapping-and-adoption-attestation.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/SKILL.md +0 -49
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/module-composition-and-refactor.md +0 -20
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/module-composition-and-state-boundaries.md +0 -11
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/module-locks-and-codegen-acceptance.md +0 -14
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/network-and-observability.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-patterns/references/plan-and-change-assessment.md +0 -24
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/SKILL.md +0 -45
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/evidence-acceptance.md +0 -10
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/plan-mode-and-mock-design.md +0 -12
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/plan-mode-test-design.md +0 -23
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-terraform-test/references/test-design.md +0 -13
- package/assets/client-projections/github-copilot-vscode/.github/skills/apex-workflow/SKILL.md +0 -37
- package/assets/client-projections/github-copilot-vscode/.vscode/mcp.json +0 -29
- package/assets/customizations/.github/agents/apex-architect.agent.md +0 -93
- package/assets/customizations/.github/agents/apex-operator.agent.md +0 -72
- package/assets/customizations/.github/agents/apex-planner.agent.md +0 -91
- package/assets/customizations/.github/agents/apex-requirements.agent.md +0 -101
- package/assets/customizations/.github/agents/apex-reviewer.agent.md +0 -60
- package/assets/customizations/.github/mcp.json +0 -65
- package/assets/customizations/.github/skills/apex-azure-prepare/references/functions-recipe-pack.md +0 -27
- package/assets/customizations/.vscode/mcp.json +0 -29
- package/dist/azure-mcp-environment.d.ts +0 -2
- package/dist/azure-mcp-environment.js +0 -7
- package/dist/azure-mcp.d.ts +0 -2
- package/dist/azure-mcp.js +0 -21
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
## Presentation Conventions
|
|
2
|
-
|
|
3
|
-
Use a template only after the kernel accepts the matching typed artifact. Keep the artifact and its kernel-rendered
|
|
4
|
-
document receipt canonical; the Markdown presentation is a derived view.
|
|
5
|
-
|
|
6
|
-
### Authority And Provenance
|
|
7
|
-
|
|
8
|
-
- Record the renderer-projected artifact identifier and template identifier.
|
|
9
|
-
- Keep accepted values, units, scopes, status, and evidence references unchanged.
|
|
10
|
-
- Label design, planned, simulated, expected, and observed values distinctly.
|
|
11
|
-
- Never claim current Azure state, successful validation, or deployment from a template placeholder.
|
|
12
|
-
|
|
13
|
-
### Slot Rules
|
|
14
|
-
|
|
15
|
-
- Replace every required `{slot-name}` from accepted values or explicit kernel decisions.
|
|
16
|
-
- Preserve `unknown`, `deferred`, `unavailable`, and `not applicable` as supplied by the renderer.
|
|
17
|
-
- Keep optional sections only when accepted data supports them; do not manufacture empty success claims.
|
|
18
|
-
- Stop and report a blocker when a required slot, renderer, artifact kind, or disclosure permission is unavailable.
|
|
19
|
-
- Do not infer, invent, normalize, or use a presentation to change artifact meaning.
|
|
20
|
-
|
|
21
|
-
### Traceability
|
|
22
|
-
|
|
23
|
-
- Connect requirements to decisions, controls, implementation intent, risks, and accepted evidence where slots permit.
|
|
24
|
-
- For governance, map each accepted constraint to a control, adaptation, exemption, or unsatisfied blocker.
|
|
25
|
-
- For plans and inventories, account for every accepted resource and identify coverage gaps explicitly.
|
|
26
|
-
- For as-built views, show design-versus-observed variance only when both accepted values exist.
|
|
27
|
-
|
|
28
|
-
### Cost Semantics
|
|
29
|
-
|
|
30
|
-
- State currency, region, pricing basis, usage quantities, query or evidence time, and expected variance.
|
|
31
|
-
- Separate fixed or baseline cost from usage-sensitive cost and list redesign or scale triggers.
|
|
32
|
-
- Represent savings as `quantified`, `not quantified`, or `not applicable`; never render zero as "not evaluated."
|
|
33
|
-
- Do not present mutable prices as current unless accepted pricing evidence carries that claim.
|
|
34
|
-
|
|
35
|
-
### Document Shape
|
|
36
|
-
|
|
37
|
-
- Preserve template H2 order and use H3 sections for detail.
|
|
38
|
-
- Prefer concise tables for comparisons, controls, resources, risks, and ownership.
|
|
39
|
-
- Use callouts only for material notes, warnings, blockers, or irreversible consequences.
|
|
40
|
-
- Include inline Mermaid only for a supported diagram slot and only from accepted nodes and relationships.
|
|
41
|
-
- Keep links relative or from accepted source URLs; do not invent repository paths or portal links.
|
|
42
|
-
|
|
43
|
-
### Receipt
|
|
44
|
-
|
|
45
|
-
When available, include renderer-provided artifact and template identifiers, evidence identifiers, and render status.
|
|
46
|
-
|
|
47
|
-
### Validation Loop
|
|
48
|
-
|
|
49
|
-
1. Check required slots and accepted source mappings before rendering.
|
|
50
|
-
2. Render through the kernel capability.
|
|
51
|
-
3. Check unresolved placeholders, heading order, status wording, disclosure, links, and receipt identifiers.
|
|
52
|
-
4. Correct the request and re-render. If the renderer still cannot satisfy a required slot, return the blocker.
|
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
## Reference-Only Document Outlines
|
|
2
|
-
|
|
3
|
-
These outlines preserve useful document semantics from the source skill. They do not declare artifact kinds, renderer
|
|
4
|
-
bindings, workflow phases, file names, or authority to read repositories or query Azure. Use one only when a supported
|
|
5
|
-
custom-document capability supplies accepted values for every required slot.
|
|
6
|
-
|
|
7
|
-
### Preflight Evidence
|
|
8
|
-
|
|
9
|
-
- Purpose and validation scope
|
|
10
|
-
- Module or provider schema checks
|
|
11
|
-
- Parameter type and interface checks
|
|
12
|
-
- Region or service availability constraints
|
|
13
|
-
- Known pitfalls, pass/fail evidence, and unresolved blockers
|
|
14
|
-
|
|
15
|
-
Never infer a pass from planned configuration. Without accepted validation evidence, report the capability as absent.
|
|
16
|
-
|
|
17
|
-
### Implementation Reference
|
|
18
|
-
|
|
19
|
-
- Accepted implementation location or identifier
|
|
20
|
-
- File or module structure from accepted inventory
|
|
21
|
-
- Validation status with evidence references
|
|
22
|
-
- Resources represented by the implementation
|
|
23
|
-
- Key interfaces, decisions, limitations, and follow-up
|
|
24
|
-
|
|
25
|
-
Do not add deployment commands or claim files exist unless accepted evidence provides them.
|
|
26
|
-
|
|
27
|
-
### Documentation Package Index
|
|
28
|
-
|
|
29
|
-
- Package contents and status
|
|
30
|
-
- Accepted source artifacts and provenance
|
|
31
|
-
- Workload summary
|
|
32
|
-
- Related accepted resources and bounded links
|
|
33
|
-
- Missing package items and deferrals
|
|
34
|
-
|
|
35
|
-
### Design Document
|
|
36
|
-
|
|
37
|
-
- Purpose, audience, objectives, constraints, assumptions, and stakeholders
|
|
38
|
-
- Architecture overview and accepted relationships
|
|
39
|
-
- Networking, storage, compute, identity, security, compliance, backup, and monitoring
|
|
40
|
-
- Design decisions, operational implications, evidence, risks, and appendices
|
|
41
|
-
|
|
42
|
-
Only include domains represented by accepted inputs. Keep planned and observed state distinct.
|
|
43
|
-
|
|
44
|
-
### Backup And Recovery Plan
|
|
45
|
-
|
|
46
|
-
- Recovery objectives by service tier
|
|
47
|
-
- Backup scope, retention, restore approach, and ownership
|
|
48
|
-
- Failover and failback decision points
|
|
49
|
-
- Test schedule and accepted test evidence
|
|
50
|
-
- Communications, dependencies, recovery procedures, and blockers
|
|
51
|
-
|
|
52
|
-
Do not invent executable recovery commands. A missing tested procedure or owner is a blocker, not a placeholder success.
|
|
53
|
-
|
|
54
|
-
### Compliance Matrix
|
|
55
|
-
|
|
56
|
-
- Framework and scope
|
|
57
|
-
- Requirement-to-control-to-evidence mapping
|
|
58
|
-
- Gaps with severity, risk, owner, and remediation state
|
|
59
|
-
- Evidence collection metadata and audit trail
|
|
60
|
-
- Exceptions, expirations, deferrals, and residual risk
|
|
61
|
-
|
|
62
|
-
Compliance percentages require accepted numerator, denominator, and scope. Otherwise present coverage as unknown.
|
|
63
|
-
|
|
64
|
-
### Project Index
|
|
65
|
-
|
|
66
|
-
- Workload summary and status
|
|
67
|
-
- Accepted artifact catalog with provenance
|
|
68
|
-
- Architecture preview only when a supported media slot exists
|
|
69
|
-
- Resource summary, unresolved blockers, and related bounded links
|
|
70
|
-
|
|
71
|
-
### Lessons And Improvement View
|
|
72
|
-
|
|
73
|
-
- Accepted observations grouped by severity and workflow area
|
|
74
|
-
- What happened, impact, corrective action, and evidence
|
|
75
|
-
- Recommendations with owners and affected capability or contract
|
|
76
|
-
- Deferred improvements and rationale
|
|
77
|
-
|
|
78
|
-
Do not create improvement state or claim a correction was applied; project only kernel-accepted decisions.
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
4
|
-
|
|
5
|
-
## Requirements Validation
|
|
6
|
-
|
|
7
|
-
{requirements-validation}
|
|
8
|
-
|
|
9
|
-
## Executive Summary
|
|
10
|
-
|
|
11
|
-
{executive-summary}
|
|
12
|
-
|
|
13
|
-
## Well-Architected Assessment
|
|
14
|
-
|
|
15
|
-
{waf-assessment}
|
|
16
|
-
|
|
17
|
-
## Resource And SKU Recommendations
|
|
18
|
-
|
|
19
|
-
{resource-recommendations}
|
|
20
|
-
|
|
21
|
-
## Architecture Decisions
|
|
22
|
-
|
|
23
|
-
{architecture-decisions}
|
|
24
|
-
|
|
25
|
-
## Implementation Handoff
|
|
26
|
-
|
|
27
|
-
{implementation-handoff}
|
|
28
|
-
|
|
29
|
-
## Risks And Deferrals
|
|
30
|
-
|
|
31
|
-
{risks-and-deferrals}
|
|
32
|
-
|
|
33
|
-
## References
|
|
34
|
-
|
|
35
|
-
{references}
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
4
|
-
|
|
5
|
-
## Cost At A Glance
|
|
6
|
-
|
|
7
|
-
{cost-at-a-glance}
|
|
8
|
-
|
|
9
|
-
## Decision Summary
|
|
10
|
-
|
|
11
|
-
{decision-summary}
|
|
12
|
-
|
|
13
|
-
## Requirements To Cost Mapping
|
|
14
|
-
|
|
15
|
-
{requirements-cost-mapping}
|
|
16
|
-
|
|
17
|
-
## Cost Drivers And Sensitivities
|
|
18
|
-
|
|
19
|
-
{cost-drivers-and-sensitivities}
|
|
20
|
-
|
|
21
|
-
## Assumptions
|
|
22
|
-
|
|
23
|
-
{assumptions}
|
|
24
|
-
|
|
25
|
-
## Cost Breakdown
|
|
26
|
-
|
|
27
|
-
{cost-breakdown}
|
|
28
|
-
|
|
29
|
-
## Savings Opportunities
|
|
30
|
-
|
|
31
|
-
{savings-state-and-opportunities}
|
|
32
|
-
|
|
33
|
-
## Guardrails And Change Triggers
|
|
34
|
-
|
|
35
|
-
{guardrails-and-change-triggers}
|
|
36
|
-
|
|
37
|
-
## Risks And Deferrals
|
|
38
|
-
|
|
39
|
-
{risks-and-deferrals}
|
|
40
|
-
|
|
41
|
-
## Pricing Evidence
|
|
42
|
-
|
|
43
|
-
{pricing-evidence}
|
|
44
|
-
|
|
45
|
-
## References
|
|
46
|
-
|
|
47
|
-
{references}
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
4
|
-
|
|
5
|
-
## Preflight Evidence
|
|
6
|
-
|
|
7
|
-
{preflight-evidence}
|
|
8
|
-
|
|
9
|
-
## Execution Context
|
|
10
|
-
|
|
11
|
-
{execution-context}
|
|
12
|
-
|
|
13
|
-
## Change Summary
|
|
14
|
-
|
|
15
|
-
{change-summary}
|
|
16
|
-
|
|
17
|
-
## Resource Results
|
|
18
|
-
|
|
19
|
-
{resource-results}
|
|
20
|
-
|
|
21
|
-
## Outputs
|
|
22
|
-
|
|
23
|
-
{outputs}
|
|
24
|
-
|
|
25
|
-
## Outputs And Follow-Up
|
|
26
|
-
|
|
27
|
-
{outputs-and-follow-up}
|
|
28
|
-
|
|
29
|
-
## Exceptions And Deferrals
|
|
30
|
-
|
|
31
|
-
{exceptions-and-deferrals}
|
|
32
|
-
|
|
33
|
-
## References
|
|
34
|
-
|
|
35
|
-
{references}
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
4
|
-
|
|
5
|
-
## Discovery And Attestation
|
|
6
|
-
|
|
7
|
-
{discovery-and-attestation}
|
|
8
|
-
|
|
9
|
-
## Constraint Summary
|
|
10
|
-
|
|
11
|
-
{constraint-summary}
|
|
12
|
-
|
|
13
|
-
## Policy And Control Mapping
|
|
14
|
-
|
|
15
|
-
{policy-and-control-mapping}
|
|
16
|
-
|
|
17
|
-
## Adaptations And Exceptions
|
|
18
|
-
|
|
19
|
-
{adaptations-and-exceptions}
|
|
20
|
-
|
|
21
|
-
## Required Tags And Security Controls
|
|
22
|
-
|
|
23
|
-
{tags-and-security-controls}
|
|
24
|
-
|
|
25
|
-
## Cost And Network Constraints
|
|
26
|
-
|
|
27
|
-
{cost-and-network-constraints}
|
|
28
|
-
|
|
29
|
-
## Blockers And Deferrals
|
|
30
|
-
|
|
31
|
-
{blockers-and-deferrals}
|
|
32
|
-
|
|
33
|
-
## References
|
|
34
|
-
|
|
35
|
-
{references}
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
4
|
-
|
|
5
|
-
## Plan Summary
|
|
6
|
-
|
|
7
|
-
{plan-summary}
|
|
8
|
-
|
|
9
|
-
## Resource Inventory
|
|
10
|
-
|
|
11
|
-
{resource-inventory}
|
|
12
|
-
|
|
13
|
-
## Governance Coverage
|
|
14
|
-
|
|
15
|
-
{governance-coverage}
|
|
16
|
-
|
|
17
|
-
## Module And Interface Structure
|
|
18
|
-
|
|
19
|
-
{module-and-interface-structure}
|
|
20
|
-
|
|
21
|
-
## Planned Work
|
|
22
|
-
|
|
23
|
-
{planned-work}
|
|
24
|
-
|
|
25
|
-
## Code Generation Contract
|
|
26
|
-
|
|
27
|
-
{code-generation-contract}
|
|
28
|
-
|
|
29
|
-
## Dependencies And Delivery Sequence
|
|
30
|
-
|
|
31
|
-
{dependencies-and-delivery-sequence}
|
|
32
|
-
|
|
33
|
-
## Naming And Security Decisions
|
|
34
|
-
|
|
35
|
-
{naming-and-security-decisions}
|
|
36
|
-
|
|
37
|
-
## Risks And Deferrals
|
|
38
|
-
|
|
39
|
-
{risks-and-deferrals}
|
|
40
|
-
|
|
41
|
-
## References
|
|
42
|
-
|
|
43
|
-
{references}
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
4
|
-
|
|
5
|
-
## Quick Reference
|
|
6
|
-
|
|
7
|
-
{quick-reference}
|
|
8
|
-
|
|
9
|
-
## Health And Routine Operations
|
|
10
|
-
|
|
11
|
-
{health-and-routine-operations}
|
|
12
|
-
|
|
13
|
-
## Monitoring And Incident Response
|
|
14
|
-
|
|
15
|
-
{monitoring-and-incident-response}
|
|
16
|
-
|
|
17
|
-
## Common Procedures
|
|
18
|
-
|
|
19
|
-
{common-procedures}
|
|
20
|
-
|
|
21
|
-
## Maintenance And Recovery
|
|
22
|
-
|
|
23
|
-
{maintenance-and-recovery}
|
|
24
|
-
|
|
25
|
-
## Escalation And Ownership
|
|
26
|
-
|
|
27
|
-
{escalation-and-ownership}
|
|
28
|
-
|
|
29
|
-
## Change Evidence
|
|
30
|
-
|
|
31
|
-
{change-evidence}
|
|
32
|
-
|
|
33
|
-
## References
|
|
34
|
-
|
|
35
|
-
{references}
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
# Requirements: {workload}
|
|
2
|
-
|
|
3
|
-
> Derived from accepted APEX requirements artifact `{artifact-hash}` using template `{template-hash}`.
|
|
4
|
-
|
|
5
|
-
## Project Overview
|
|
6
|
-
|
|
7
|
-
- Environment: {environment}
|
|
8
|
-
- Status: {artifact-status}
|
|
9
|
-
- Business context: {business-context}
|
|
10
|
-
- Success criteria: {success-criteria}
|
|
11
|
-
|
|
12
|
-
## Functional Requirements
|
|
13
|
-
|
|
14
|
-
{requirements-table}
|
|
15
|
-
|
|
16
|
-
## Non-Functional Requirements
|
|
17
|
-
|
|
18
|
-
{nfr-table}
|
|
19
|
-
|
|
20
|
-
## Security And Compliance
|
|
21
|
-
|
|
22
|
-
{security-and-compliance-table}
|
|
23
|
-
|
|
24
|
-
## Budget And Operations
|
|
25
|
-
|
|
26
|
-
{budget-and-operations}
|
|
27
|
-
|
|
28
|
-
## Regional And Residency Constraints
|
|
29
|
-
|
|
30
|
-
{regional-constraints}
|
|
31
|
-
|
|
32
|
-
## Assumptions
|
|
33
|
-
|
|
34
|
-
{assumptions-list}
|
|
35
|
-
|
|
36
|
-
## Unknowns And Deferrals
|
|
37
|
-
|
|
38
|
-
{unknowns-list}
|
|
39
|
-
|
|
40
|
-
## Architecture Handoff
|
|
41
|
-
|
|
42
|
-
{architecture-handoff}
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
## {artifact-title}
|
|
2
|
-
|
|
3
|
-
> Reference-only outline: no active renderer binding is declared for this template.
|
|
4
|
-
>
|
|
5
|
-
> Presentation receipt: artifact `{artifact-identifier}`; template `{template-identifier}`.
|
|
6
|
-
|
|
7
|
-
## Inventory Summary
|
|
8
|
-
|
|
9
|
-
{inventory-summary-by-category}
|
|
10
|
-
|
|
11
|
-
## Resource Listing
|
|
12
|
-
|
|
13
|
-
{resource-listing-with-type-sku-location-purpose-and-status}
|
|
14
|
-
|
|
15
|
-
## Identity Network And Dependency Context
|
|
16
|
-
|
|
17
|
-
{identity-network-and-dependency-context}
|
|
18
|
-
|
|
19
|
-
## Cost And Operational Context
|
|
20
|
-
|
|
21
|
-
{accepted-cost-monitoring-backup-and-ownership-context}
|
|
22
|
-
|
|
23
|
-
## Coverage Gaps And Deferrals
|
|
24
|
-
|
|
25
|
-
{coverage-gaps-and-deferrals}
|
|
26
|
-
|
|
27
|
-
## References
|
|
28
|
-
|
|
29
|
-
{references}
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: apex-azure-adr
|
|
3
|
-
description: "Records bounded Azure architecture decisions. Use for ADR rationale, alternatives, WAF and compliance consequences, implementation constraints, supersession, and revisit criteria."
|
|
4
|
-
user-invocable: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# APEX Azure Architecture Decisions
|
|
8
|
-
|
|
9
|
-
Use this skill only for an active architecture or planning task. The kernel-owned architecture artifact, recorded
|
|
10
|
-
architecture decisions, requirements, and governance evidence are authoritative.
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
- A material decision question and affected requirement IDs are present in `apex/taskContext`.
|
|
15
|
-
- Accepted governance, availability, cost, lifecycle, and technical evidence needed for comparison is available.
|
|
16
|
-
- The kernel exposes the decision-recording capability when a new user-owned choice is required.
|
|
17
|
-
|
|
18
|
-
Create a decision record for a material, cross-cutting, costly-to-reverse, compliance-relevant, or intentionally deferred
|
|
19
|
-
choice. Do not create one for routine implementation detail already fixed by an accepted contract.
|
|
20
|
-
|
|
21
|
-
## Decision Method
|
|
22
|
-
|
|
23
|
-
1. Frame one bounded question and state why a decision is needed now.
|
|
24
|
-
2. List the driving requirements, constraints, assumptions, stakeholders, and accepted evidence.
|
|
25
|
-
3. Compare the selected option with viable alternatives against the same criteria.
|
|
26
|
-
4. State the selected option precisely and record why each alternative was rejected.
|
|
27
|
-
5. Record positive, negative, and neutral consequences, including WAF and compliance effects.
|
|
28
|
-
6. Record implementation constraints, validation signals, reversal cost, and revisit triggers.
|
|
29
|
-
7. Check the record with [decision quality](references/decision-quality.md); revise until it passes or return a blocker.
|
|
30
|
-
|
|
31
|
-
Use kernel-projected lifecycle states. `Proposed`, `Accepted`, `Deprecated`, and `Superseded` describe recorded decision
|
|
32
|
-
state, not an inferred workflow phase. A superseded decision must link to its replacement; do not rewrite history.
|
|
33
|
-
|
|
34
|
-
## Boundaries
|
|
35
|
-
|
|
36
|
-
Do not create ADR files, sequence document numbers, write Markdown, use shell or Git, query Azure directly, or alter
|
|
37
|
-
architecture artifacts outside the authorized workflow.
|
|
38
|
-
|
|
39
|
-
Do not invent mutable service facts, prices, versions, policy state, benchmark results, or implementation outcomes.
|
|
40
|
-
Missing evidence or an unresolved user-owned trade-off is an explicit blocker.
|
|
41
|
-
|
|
42
|
-
## References
|
|
43
|
-
|
|
44
|
-
- Read [decision record fields](references/decision-record-fields.md) when constructing the typed rationale.
|
|
45
|
-
- Read [decision quality](references/decision-quality.md) before returning a completed decision.
|
|
46
|
-
- Read [decision guardrails](references/decision-guardrails.md) when alternatives or evidence are weak.
|
|
47
|
-
- Read [decision examples](references/decision-examples.md) when a concrete decision shape is useful.
|
|
48
|
-
|
|
49
|
-
## Output
|
|
50
|
-
|
|
51
|
-
Return bounded architecture or plan decision guidance with rationale, alternatives, consequences, requirement
|
|
52
|
-
traceability, accepted evidence references, implementation constraints, revisit triggers, and blockers.
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
# Decision Examples
|
|
2
|
-
|
|
3
|
-
Use these as decision-shape examples, not as automatic service recommendations.
|
|
4
|
-
|
|
5
|
-
| Area | Example trade-off |
|
|
6
|
-
| --- | --- |
|
|
7
|
-
| Compute | Container Apps versus App Service for an API with variable demand. |
|
|
8
|
-
| Data | Azure SQL Database versus Cosmos DB for transactional consistency and scale. |
|
|
9
|
-
| Networking | Private endpoints versus approved public access for a data service. |
|
|
10
|
-
| Identity | Managed identity versus application credential for service-to-service access. |
|
|
11
|
-
| Integration | Service Bus versus Event Grid for ordered, durable processing. |
|
|
12
|
-
|
|
13
|
-
For each example, bind the final choice to projected requirements, cost/availability evidence, governance constraints,
|
|
14
|
-
and any kernel-recorded user decision.
|
|
15
|
-
|
|
16
|
-
## Example: Compute Hosting
|
|
17
|
-
|
|
18
|
-
**Question**: Which managed host satisfies burst scaling, private data access, and the team's operating model?
|
|
19
|
-
|
|
20
|
-
| Option | Fit | Trade-off | Evidence needed |
|
|
21
|
-
| --- | --- | --- | --- |
|
|
22
|
-
| Container Apps | Event-driven scaling and container portability | More platform concepts and network constraints | Scale, region, network, and price evidence |
|
|
23
|
-
| App Service | Familiar managed web hosting | Scaling and container controls differ | Plan/SKU, region, network, and price evidence |
|
|
24
|
-
|
|
25
|
-
The selected option must state the hosting posture and accepted SKU family, not merely the service name. Consequences
|
|
26
|
-
should cover identity, ingress, diagnostics, scaling behavior, cost sensitivity, and migration effort.
|
|
27
|
-
|
|
28
|
-
## Example: Data Access Posture
|
|
29
|
-
|
|
30
|
-
**Question**: Should a production data service use private access or an approved public endpoint?
|
|
31
|
-
|
|
32
|
-
| Option | Fit | Trade-off | Evidence needed |
|
|
33
|
-
| --- | --- | --- | --- |
|
|
34
|
-
| Private endpoint | Strong isolation and policy alignment | DNS, subnet capacity, routing, and added cost | Policy, topology, DNS, capacity, and price evidence |
|
|
35
|
-
| Restricted public endpoint | Simpler connectivity when policy permits | Greater exposure and compensating controls | Policy, threat model, firewall, identity, and approval evidence |
|
|
36
|
-
|
|
37
|
-
If accepted governance denies public access, the public option is not viable; record that constraint rather than
|
|
38
|
-
pretending the alternatives are equally available.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# Decision Guardrails
|
|
2
|
-
|
|
3
|
-
## Do
|
|
4
|
-
|
|
5
|
-
- Keep one decision focused on one trade-off.
|
|
6
|
-
- Compare viable alternatives honestly.
|
|
7
|
-
- Record measurable consequences when evidence exists.
|
|
8
|
-
- Trace the decision to requirements, governance, cost, availability, or recorded user choices.
|
|
9
|
-
- Preserve the original record when deprecating or superseding it.
|
|
10
|
-
- State what evidence or condition would cause the decision to be revisited.
|
|
11
|
-
- Preserve unresolved information as a blocker, unknown, or deferred decision.
|
|
12
|
-
|
|
13
|
-
## Do Not
|
|
14
|
-
|
|
15
|
-
- Create or number ADR files.
|
|
16
|
-
- Replace typed architecture decisions with Markdown as authority.
|
|
17
|
-
- Use placeholder text, fabricated evidence, or generic implementation guidance.
|
|
18
|
-
- Combine unrelated data, networking, identity, and deployment choices into one decision.
|
|
19
|
-
- Present a predetermined selection with token alternatives that were never viable.
|
|
20
|
-
- Treat a planned benchmark, migration, validation, or deployment as an observed result.
|
|
21
|
-
- Copy prices, versions, service retirement dates, policy state, or availability claims from memory.
|
|
22
|
-
- Perform Azure reads, writes, deployments, or role assignments directly.
|
|
23
|
-
|
|
24
|
-
## Common Failures
|
|
25
|
-
|
|
26
|
-
| Failure | Correction |
|
|
27
|
-
| --- | --- |
|
|
28
|
-
| Vague selected option | Name the service, posture, or constraint and its requirement traceability. |
|
|
29
|
-
| Missing alternative | Record a viable option and why accepted evidence or constraints rejected it. |
|
|
30
|
-
| False alternative | Remove the option or explain the mandatory constraint it violates. |
|
|
31
|
-
| One-sided consequence | Include both benefits and costs, risks, or operational obligations. |
|
|
32
|
-
| Missing WAF impact | State the relevant affected pillars and the resulting trade-off. |
|
|
33
|
-
| Generic implementation note | Record typed module, identity, network, diagnostics, or recovery constraints. |
|
|
34
|
-
| Outcome stated as intent | Label the item planned and name the future acceptance evidence. |
|
|
35
|
-
| Stale decision | Preserve it as deprecated or superseded and link the accepted replacement. |
|
|
36
|
-
| Multi-decision record | Split choices whose alternatives, owners, or reversal triggers differ. |
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# Decision Quality Checklist
|
|
2
|
-
|
|
3
|
-
Before completing an architecture or plan artifact, verify:
|
|
4
|
-
|
|
5
|
-
- The decision identifier, lifecycle state, owner, and scope are present.
|
|
6
|
-
- The decision addresses one bounded material trade-off.
|
|
7
|
-
- Context separates the problem from the proposed solution.
|
|
8
|
-
- Drivers name mandatory requirements, assumptions, and accepted evidence.
|
|
9
|
-
- The selected option is precise, scoped, and unambiguous.
|
|
10
|
-
- Viable alternatives are compared against the same criteria and have rejection rationales.
|
|
11
|
-
- Positive, negative, and neutral consequences are honest and measurable where evidence permits.
|
|
12
|
-
- Every WAF pillar is addressed or explicitly marked as having no material effect with rationale.
|
|
13
|
-
- Compliance and governance implications use accepted constraints.
|
|
14
|
-
- Implementation constraints are actionable through typed bindings without embedding execution steps.
|
|
15
|
-
- Validation signals and revisit or supersession triggers are testable.
|
|
16
|
-
- Reversal cost, residual risk, and decision ownership are visible.
|
|
17
|
-
- Unknown and deferred values remain explicit.
|
|
18
|
-
- The decision does not claim live state or results that are absent from task context.
|
|
19
|
-
|
|
20
|
-
If a mandatory requirement has no supported option, evidence is stale or absent, or a user-owned trade-off remains
|
|
21
|
-
unresolved, return a blocker instead of weakening the record.
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
# Architecture Decision Record Fields
|
|
2
|
-
|
|
3
|
-
Use these fields in a typed architecture or planning decision. They are presentation and quality guidance; the accepted
|
|
4
|
-
artifact schema remains authoritative.
|
|
5
|
-
|
|
6
|
-
## Identity And Lifecycle
|
|
7
|
-
|
|
8
|
-
Record the stable decision identifier, concise title, kernel-projected status, decision owner, deciders, decision time,
|
|
9
|
-
and affected workload scope. When applicable, record `supersedes` or `superseded_by`; preserve the earlier rationale.
|
|
10
|
-
|
|
11
|
-
## Context
|
|
12
|
-
|
|
13
|
-
State the problem or opportunity, current state, desired outcome, constraints, assumptions, stakeholders, accepted
|
|
14
|
-
evidence, affected requirement IDs, and why a decision is required now. Keep one material trade-off per decision.
|
|
15
|
-
|
|
16
|
-
## Decision Drivers
|
|
17
|
-
|
|
18
|
-
List measurable evaluation criteria such as availability, RTO/RPO, latency, consistency, residency, identity, network
|
|
19
|
-
exposure, operability, migration effort, cost envelope, team capability, and reversibility. Mark mandatory constraints.
|
|
20
|
-
|
|
21
|
-
## Selected Option
|
|
22
|
-
|
|
23
|
-
State the selected option precisely. Tie it to an accepted requirement, a kernel-recorded user choice, or accepted
|
|
24
|
-
evidence. Include scope and posture, not just a product name. Do not use vague statements such as "use a database".
|
|
25
|
-
|
|
26
|
-
## Alternatives
|
|
27
|
-
|
|
28
|
-
Record at least one viable alternative when the choice materially affects the workload. For each alternative, state its
|
|
29
|
-
fit against the same drivers, benefits, drawbacks, evidence, rejection rationale, and affected WAF pillars. Do not pad
|
|
30
|
-
the record with options that violate mandatory constraints unless the violation itself explains the rejection.
|
|
31
|
-
|
|
32
|
-
## Consequences
|
|
33
|
-
|
|
34
|
-
Record at least one positive and one negative consequence. Use measurable statements where evidence exists. Include
|
|
35
|
-
neutral constraints, residual risks, migration effects, lock-in, operating burden, cost sensitivity, and follow-up
|
|
36
|
-
obligations when they affect later planning.
|
|
37
|
-
|
|
38
|
-
## WAF And Compliance
|
|
39
|
-
|
|
40
|
-
Describe effects on Security, Reliability, Performance Efficiency, Cost Optimization, and Operational Excellence. Record
|
|
41
|
-
direction, rationale, mitigation, and evidence for each material effect. Record compliance, residency, identity,
|
|
42
|
-
governance, audit, and exception implications from accepted constraints; do not infer live policy.
|
|
43
|
-
|
|
44
|
-
## Implementation Constraints
|
|
45
|
-
|
|
46
|
-
Record binding constraints such as required module/provider family, identity model, network posture, diagnostics, or
|
|
47
|
-
recovery objective. Do not include direct shell commands, role assignment snippets, secret values, or deployment steps.
|
|
48
|
-
|
|
49
|
-
## Validation And Revisit
|
|
50
|
-
|
|
51
|
-
Define observable acceptance signals, decision owner, review event, reversal or migration trigger, and conditions that
|
|
52
|
-
would invalidate the decision. Planned validation is not evidence that validation already passed.
|
|
53
|
-
|
|
54
|
-
## Provenance
|
|
55
|
-
|
|
56
|
-
Reference accepted requirement, governance, pricing, availability, benchmark, and user-decision identifiers. Preserve
|
|
57
|
-
unknown and deferred evidence explicitly and never fabricate a citation.
|