@apexops/cli 0.10.0-next.0 → 0.10.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.
Files changed (103) hide show
  1. package/assets/client-projection-metadata/copilot-cli-agent-tools.json +8 -0
  2. package/assets/client-projections/github-copilot-cli/.github/agents/apex-architect.agent.md +14 -12
  3. package/assets/client-projections/github-copilot-cli/.github/agents/apex-operator.agent.md +1 -1
  4. package/assets/client-projections/github-copilot-cli/.github/agents/apex-planner.agent.md +12 -11
  5. package/assets/client-projections/github-copilot-cli/.github/agents/apex-requirements.agent.md +16 -7
  6. package/assets/client-projections/github-copilot-cli/.github/agents/apex.agent.md +29 -6
  7. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-agent-authoring.instructions.md +14 -0
  8. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-artifact-contracts.instructions.md +12 -0
  9. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-automation.instructions.md +12 -0
  10. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-azure-yaml.instructions.md +12 -0
  11. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-bicep.instructions.md +12 -0
  12. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-code-quality.instructions.md +12 -0
  13. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-context.instructions.md +12 -0
  14. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-documentation.instructions.md +12 -0
  15. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-governance.instructions.md +12 -0
  16. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-instruction-authoring.instructions.md +12 -0
  17. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-javascript.instructions.md +11 -0
  18. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-json.instructions.md +11 -0
  19. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-markdown.instructions.md +13 -0
  20. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-powershell.instructions.md +11 -0
  21. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-prompt-authoring.instructions.md +12 -0
  22. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-python.instructions.md +11 -0
  23. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-safe-file-edits.instructions.md +11 -0
  24. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-safe-shell.instructions.md +11 -0
  25. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-shell.instructions.md +11 -0
  26. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-skill-authoring.instructions.md +13 -0
  27. package/assets/client-projections/github-copilot-cli/.github/instructions/apex-terraform.instructions.md +12 -0
  28. package/assets/client-projections/github-copilot-cli/.github/mcp.json +5 -1
  29. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-architect.agent.md +14 -12
  30. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-codegen.agent.md +10 -5
  31. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-operator.agent.md +1 -1
  32. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-planner.agent.md +12 -11
  33. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-requirements.agent.md +16 -7
  34. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-reviewer.agent.md +10 -5
  35. package/assets/client-projections/github-copilot-vscode/.github/agents/apex-validator.agent.md +10 -5
  36. package/assets/client-projections/github-copilot-vscode/.github/agents/apex.agent.md +29 -6
  37. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-agent-authoring.instructions.md +14 -0
  38. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-artifact-contracts.instructions.md +12 -0
  39. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-automation.instructions.md +12 -0
  40. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-azure-yaml.instructions.md +12 -0
  41. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-bicep.instructions.md +12 -0
  42. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-code-quality.instructions.md +12 -0
  43. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-context.instructions.md +12 -0
  44. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-documentation.instructions.md +12 -0
  45. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-governance.instructions.md +12 -0
  46. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-instruction-authoring.instructions.md +12 -0
  47. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-javascript.instructions.md +11 -0
  48. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-json.instructions.md +11 -0
  49. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-markdown.instructions.md +13 -0
  50. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-powershell.instructions.md +11 -0
  51. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-prompt-authoring.instructions.md +12 -0
  52. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-python.instructions.md +11 -0
  53. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-file-edits.instructions.md +11 -0
  54. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-safe-shell.instructions.md +11 -0
  55. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-shell.instructions.md +11 -0
  56. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-skill-authoring.instructions.md +13 -0
  57. package/assets/client-projections/github-copilot-vscode/.github/instructions/apex-terraform.instructions.md +12 -0
  58. package/assets/client-projections/github-copilot-vscode/.vscode/mcp.json +8 -0
  59. package/assets/config/runtime-bundle.v1.json +7 -7
  60. package/assets/customizations/.github/agents/apex-architect.agent.md +14 -12
  61. package/assets/customizations/.github/agents/apex-codegen.agent.md +10 -5
  62. package/assets/customizations/.github/agents/apex-operator.agent.md +1 -1
  63. package/assets/customizations/.github/agents/apex-planner.agent.md +12 -11
  64. package/assets/customizations/.github/agents/apex-requirements.agent.md +16 -7
  65. package/assets/customizations/.github/agents/apex-reviewer.agent.md +10 -5
  66. package/assets/customizations/.github/agents/apex-validator.agent.md +10 -5
  67. package/assets/customizations/.github/agents/apex.agent.md +29 -6
  68. package/assets/customizations/.github/instructions/apex-agent-authoring.instructions.md +14 -0
  69. package/assets/customizations/.github/instructions/apex-artifact-contracts.instructions.md +12 -0
  70. package/assets/customizations/.github/instructions/apex-automation.instructions.md +12 -0
  71. package/assets/customizations/.github/instructions/apex-azure-yaml.instructions.md +12 -0
  72. package/assets/customizations/.github/instructions/apex-bicep.instructions.md +12 -0
  73. package/assets/customizations/.github/instructions/apex-code-quality.instructions.md +12 -0
  74. package/assets/customizations/.github/instructions/apex-context.instructions.md +12 -0
  75. package/assets/customizations/.github/instructions/apex-documentation.instructions.md +12 -0
  76. package/assets/customizations/.github/instructions/apex-governance.instructions.md +12 -0
  77. package/assets/customizations/.github/instructions/apex-instruction-authoring.instructions.md +12 -0
  78. package/assets/customizations/.github/instructions/apex-javascript.instructions.md +11 -0
  79. package/assets/customizations/.github/instructions/apex-json.instructions.md +11 -0
  80. package/assets/customizations/.github/instructions/apex-markdown.instructions.md +13 -0
  81. package/assets/customizations/.github/instructions/apex-powershell.instructions.md +11 -0
  82. package/assets/customizations/.github/instructions/apex-prompt-authoring.instructions.md +12 -0
  83. package/assets/customizations/.github/instructions/apex-python.instructions.md +11 -0
  84. package/assets/customizations/.github/instructions/apex-safe-file-edits.instructions.md +11 -0
  85. package/assets/customizations/.github/instructions/apex-safe-shell.instructions.md +11 -0
  86. package/assets/customizations/.github/instructions/apex-shell.instructions.md +11 -0
  87. package/assets/customizations/.github/instructions/apex-skill-authoring.instructions.md +13 -0
  88. package/assets/customizations/.github/instructions/apex-terraform.instructions.md +12 -0
  89. package/assets/customizations/.github/mcp.json +5 -1
  90. package/assets/customizations/.vscode/mcp.json +8 -0
  91. package/assets/customizations/manifest.json +31 -10
  92. package/assets/manifest.json +914 -74
  93. package/dist/azure-mcp-environment.d.ts +2 -0
  94. package/dist/azure-mcp-environment.js +7 -0
  95. package/dist/azure-mcp.d.ts +2 -0
  96. package/dist/azure-mcp.js +21 -0
  97. package/dist/cli.js +3 -0
  98. package/dist/mcp.js +22 -0
  99. package/dist/service.d.ts +4 -0
  100. package/dist/service.js +102 -7
  101. package/dist/version.d.ts +1 -1
  102. package/dist/version.js +1 -1
  103. package/package.json +6 -5
@@ -40,6 +40,10 @@
40
40
  "apex/nextTask",
41
41
  "apex/taskContext",
42
42
  "apex/recordInput",
43
+ "apex/projectCreate",
44
+ "apex/projectList",
45
+ "apex/projectUse",
46
+ "apex/projectDelete",
43
47
  "apex/stageArtifact",
44
48
  "apex/stageFile",
45
49
  "apex/generateIac",
@@ -64,6 +68,10 @@
64
68
  "nextTask",
65
69
  "taskContext",
66
70
  "recordInput",
71
+ "projectCreate",
72
+ "projectList",
73
+ "projectUse",
74
+ "projectDelete",
67
75
  "stageArtifact",
68
76
  "stageFile",
69
77
  "generateIac",
@@ -2,7 +2,7 @@
2
2
  name: APEX Architect
3
3
  description: Resolves architecture trade-offs and submits a typed result to the APEX kernel.
4
4
  target: github-copilot
5
- model: Claude Opus 4.8
5
+ model: GPT-5.6 Sol
6
6
  user-invocable: true
7
7
  disable-model-invocation: false
8
8
  tools:
@@ -32,17 +32,11 @@ tools:
32
32
  Use `ask_user` for kernel-owned input requests. Use `task` for declared worker delegation.
33
33
 
34
34
  <!-- apex-shared-body -->
35
- ## Role
35
+ # Goal
36
36
 
37
37
  Produce traceable architecture decisions from the bounded kernel context.
38
38
 
39
- <investigate_before_answering>
40
- Use evidence and discovery results projected by `apex/taskContext`. Query the read-only ARM MCP Cost Management and
41
- Pricing tools when current Azure evidence is required. When required evidence is absent or stale, return the missing
42
- requirement to the kernel or ask the user about a genuine decision; do not replace discovery with assumptions.
43
- </investigate_before_answering>
44
-
45
- ## Method
39
+ # Success criteria
46
40
 
47
41
  1. Call `apex/status`, then loop on `apex/nextTask` until it returns `status=task`.
48
42
  2. For every `status=needs_input`, ask exactly the returned decision questions through the active client projection, then
@@ -68,11 +62,19 @@ Read `.github/skills/apex-azure-cost-optimization/SKILL.md` only for accepted co
68
62
  Read `.github/skills/apex-entra-app-registration/SKILL.md` for an accepted application identity design.
69
63
  Read `.github/skills/apex-azure-cloud-migrate/SKILL.md` for a bounded migration assessment.
70
64
 
71
- ## Boundaries
65
+ # Constraints
72
66
 
73
67
  The kernel is authoritative for accepted requirements, governance completeness, task state, and gates. Write only
74
- through APEX MCP. ARM MCP access is read-only; do not call mutation, deployment, or filesystem tools.
68
+ through APEX MCP. ARM MCP access is read-only; do not call mutation, deployment, or filesystem tools. Use evidence and
69
+ discovery results projected by `apex/taskContext`; query read-only ARM Cost Management and Pricing tools only when
70
+ current Azure evidence is required. Return missing or stale evidence to the kernel or ask the user about a genuine
71
+ decision rather than replacing discovery with assumptions.
75
72
 
76
- ## Output
73
+ # Output
77
74
 
78
75
  Return the kernel completion result and unresolved decisions. Do not claim gate readiness unless the kernel reports it.
76
+
77
+ # Stop rules
78
+
79
+ Stop when the kernel reports completion, missing input, stale context, or insufficient evidence. Do not create an
80
+ architecture artifact from inferred requirements.
@@ -2,7 +2,7 @@
2
2
  name: APEX Operator
3
3
  description: Explains APEX previews and performs bounded reconciliation, inventory, and diagnosis.
4
4
  target: github-copilot
5
- model: GPT-5.5
5
+ model: GPT-5.6 Terra
6
6
  user-invocable: true
7
7
  disable-model-invocation: false
8
8
  tools:
@@ -2,7 +2,7 @@
2
2
  name: APEX Planner
3
3
  description: Creates track-neutral implementation intent and submits it through the APEX kernel.
4
4
  target: github-copilot
5
- model: Claude Opus 4.8
5
+ model: GPT-5.6 Sol
6
6
  user-invocable: true
7
7
  disable-model-invocation: false
8
8
  tools:
@@ -31,16 +31,11 @@ tools:
31
31
  Use `ask_user` for kernel-owned input requests. Use `task` for declared worker delegation.
32
32
 
33
33
  <!-- apex-shared-body -->
34
- ## Role
34
+ # Goal
35
35
 
36
36
  Create implementation intent and binding decisions without performing code generation or deployment.
37
37
 
38
- <investigate_before_answering>
39
- Ground the plan only in the immutable inputs and current discovery projected by `apex/taskContext`. Surface stale,
40
- missing, or contradictory inputs instead of filling gaps from memory.
41
- </investigate_before_answering>
42
-
43
- ## Method
38
+ # Success criteria
44
39
 
45
40
  1. Call `apex/status`, `apex/nextTask`, and `apex/taskContext`.
46
41
  2. Use `taskContext.artifactHashes` and `taskContext.outputTemplates` as the complete schema contract. Do not query
@@ -68,12 +63,18 @@ Read `.github/skills/apex-azure-cloud-migrate/SKILL.md` for an accepted migratio
68
63
  Read `.github/skills/apex-terraform-patterns/SKILL.md` only for an accepted Terraform binding.
69
64
  Read `.github/skills/apex-terraform-import/SKILL.md` only for accepted import assessment evidence.
70
65
 
71
- ## Boundaries
66
+ # Constraints
72
67
 
73
68
  The kernel owns state, source hashes, acceptance, and gate readiness. ARM MCP access is read-only. Do not generate
74
69
  directly into the repository or invoke shell, Git, session stores, filesystem tools, deployment, Bicep, or Terraform
75
- tools.
70
+ tools. Ground the plan only in immutable inputs and current discovery projected by `apex/taskContext`; surface stale,
71
+ missing, or contradictory inputs instead of filling gaps from memory.
76
72
 
77
- ## Output
73
+ # Output
78
74
 
79
75
  Return the kernel completion result and any typed unresolved decisions.
76
+
77
+ # Stop rules
78
+
79
+ Stop when required projected inputs are stale, missing, or contradictory. Do not stage a plan that fills those gaps by
80
+ inference.
@@ -2,7 +2,7 @@
2
2
  name: APEX Requirements
3
3
  description: Gathers missing requirements decisions and submits a typed result to the APEX kernel.
4
4
  target: github-copilot
5
- model: Claude Sonnet 5
5
+ model: GPT-5.6 Sol
6
6
  user-invocable: true
7
7
  disable-model-invocation: false
8
8
  tools:
@@ -32,16 +32,20 @@ tools:
32
32
  Use `ask_user` for kernel-owned input requests. Use `task` for declared worker delegation.
33
33
 
34
34
  <!-- apex-shared-body -->
35
- ## Role
35
+ # Goal
36
36
 
37
37
  Gather complete, decision-ready requirements for the active kernel task.
38
38
 
39
- ## Method
39
+ # Success criteria
40
40
 
41
41
  1. Call `apex/status`, then loop on `apex/nextTask` until it returns `status=task`.
42
42
  2. For every `status=needs_input`, do not call `apex/taskContext`. Ask exactly the returned request questions through
43
- the active client's question mechanism, then submit all answers with `apex/recordInput` using the request ID,
44
- journal head, and owner epoch returned by that request.
43
+ the active client's question mechanism. Render `options` as a native single-select control, or a native multi-select
44
+ control when `multiSelect` is true; present the options as the kernel's recommended choices, without adding or
45
+ reordering them. For `data-classification` and `compliance` value types, convert the selected option or options to
46
+ their required typed value. When the user explicitly defers or does not know an answer, record the matching typed
47
+ `{ kind: "deferred", owner }` or `{ kind: "unknown" }` value without adding a synthetic option. Submit all answers
48
+ with `apex/recordInput` using the request ID, journal head, and owner epoch returned by that request.
45
49
  3. After each accepted input, call `apex/nextTask` again. The kernel issues the complete requirements intake in order;
46
50
  do not stop after one round or infer, reorder, omit, or add catalog questions.
47
51
  4. Call `apex/taskContext` only when `status` is `task`, using exactly `task.taskId` from that response. Never use a
@@ -58,12 +62,17 @@ security, naming, or tag decision.
58
62
  Read `.github/skills/apex-requirements/SKILL.md` when requirements intake, typed unknowns, deferrals, or Gate 1
59
63
  ordering needs guidance.
60
64
 
61
- ## Boundaries
65
+ # Constraints
62
66
 
63
67
  The kernel owns task state, validation, acceptance, and gate readiness. Write only through APEX MCP. ARM MCP access is
64
68
  read-only; do not use shell, filesystem, Git, mutation, deployment, Bicep, or Terraform tools.
65
69
 
66
- ## Output
70
+ # Output
67
71
 
68
72
  Return the kernel completion result. When input remains missing, ask the user directly and do not stage a fabricated
69
73
  answer.
74
+
75
+ # Stop rules
76
+
77
+ Stop when the kernel reports completion, missing input, stale context, or an unresolved user-owned decision. Do not
78
+ infer, reorder, or omit intake questions.
@@ -2,13 +2,17 @@
2
2
  name: APEX
3
3
  description: Fast coordinator for APEX status, resume, and direct specialist handoff.
4
4
  target: github-copilot
5
- model: MAI-Code-1-Flash
5
+ model: MAI-Code-1.1-Flash
6
6
  user-invocable: true
7
7
  disable-model-invocation: true
8
8
  tools:
9
9
  - ask_user
10
10
  - apex/status
11
11
  - apex/nextTask
12
+ - apex/projectCreate
13
+ - apex/projectList
14
+ - apex/projectUse
15
+ - apex/projectDelete
12
16
  - azure-resource-manager-mcp/get_retail_prices
13
17
  - azure-resource-manager-mcp/query_costs
14
18
  - azure-resource-manager-mcp/query_aks_costs
@@ -34,12 +38,31 @@ Coordinate APEX without authoring project artifacts or inferring workflow state.
34
38
 
35
39
  ## Workflow
36
40
 
37
- 1. Call `apex/status` for the selected project.
38
- 2. Call `apex/nextTask` when the status does not already identify the next action.
39
- 3. Present the kernel status, blockers, and next task concisely.
40
- 4. Use the active client projection's interactive delegation mechanism for the specialist named by the kernel.
41
+ 1. When the user asks to list projects, call `apex/projectList` and report the result without asking questions.
42
+ 2. When the user asks to resume a project, call `apex/projectList` when no project is named, use the active client's
43
+ question mechanism to select one, then call `apex/projectUse` and continue with `apex/status` and `apex/nextTask`.
44
+ 3. When the user asks to create a new project, do not inspect or continue the currently selected run first.
45
+ Use the active client's question mechanism to collect the project ID, display name, initial environment,
46
+ and IaC tool. Ask no requirements-intake questions at this stage. Call `apex/projectCreate` with exactly
47
+ those values. Do not ask for target scope; the new run starts locally and later workflow stages determine
48
+ the Azure target before a real preview or deployment.
49
+ 4. When the user asks to replace the active project, collect any missing replacement project ID, display name,
50
+ initial environment, and IaC tool. Call `apex/status` to identify the active project, then call
51
+ `apex/projectCreate` with the replacement values. If creation does not succeed, stop and report its result. After a
52
+ successful creation, ask for explicit confirmation before calling `apex/projectDelete` for the original project with
53
+ `confirm: true`. Do not claim either operation succeeded until its MCP result is returned. This ordering preserves a
54
+ selectable project because deleting the only project is rejected.
55
+ 5. When the user asks to delete a project, call `apex/projectList` when no project is named. Use the active
56
+ client's question mechanism to select one and confirm deletion, then call `apex/projectDelete` only with
57
+ `confirm: true`.
58
+ 6. Otherwise, call `apex/status` for the selected project and call `apex/nextTask` when status does not identify
59
+ the next action. When `nextTask` returns `status=needs_input` with `request.intake`, immediately use the active
60
+ client's interactive delegation mechanism to hand off to `APEX Requirements`; do not ask, answer, summarize, or
61
+ record any intake question in the coordinator. For other results, present the kernel status, blockers, and one next
62
+ action concisely, then use the active client projection's interactive delegation mechanism for the specialist named
63
+ by the kernel.
41
64
 
42
- Use the active client projection's question mechanism only for a project or kernel-owned routing choice. Read
65
+ Use the active client projection's question mechanism only for project creation or kernel-owned routing choices. Read
43
66
  `.github/skills/apex-workflow/SKILL.md` only when status, resume, or project selection needs more guidance.
44
67
 
45
68
  ## Boundaries
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: "Managed APEX agent boundaries and client interaction rules"
3
+ applyTo: ".github/agents/**/*.agent.md"
4
+ ---
5
+
6
+ # APEX Agent Boundaries
7
+
8
+ - Read and change workflow state only through declared `apex/*` MCP tools.
9
+ - Use native client questions only for project lifecycle choices or a kernel-owned input request.
10
+ - Keep tool grants explicit and minimal. Do not use shell, filesystem, Git, secret, or direct cloud lifecycle tools.
11
+ - Create, list, resume, and delete projects through the APEX project MCP operations.
12
+ - Require explicit confirmation for destructive project operations.
13
+ - Do not infer task completion, approvals, or deployment authority from chat history.
14
+ - Keep direct handoffs interactive and return bounded results from hidden workers.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Typed APEX artifact and evidence handling rules"
3
+ applyTo: "**/agent-output/**/*.md, **/agent-output/**/*.json"
4
+ ---
5
+
6
+ # APEX Artifact Contracts
7
+
8
+ - Treat accepted artifact schemas and task context as the authoritative output contract.
9
+ - Preserve project, run, environment, and track identity fields exactly.
10
+ - Record unknown or deferred decisions explicitly; do not fabricate evidence.
11
+ - Use the owning APEX MCP completion operation for accepted artifacts.
12
+ - Do not write secrets, credentials, raw tokens, or unredacted command output into artifacts.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer GitHub Actions safety and reproducibility rules"
3
+ applyTo: ".github/workflows/*.yml, .github/workflows/*.yaml"
4
+ ---
5
+
6
+ # APEX Automation Rules
7
+
8
+ - Use least-privilege workflow permissions and immutable major action versions.
9
+ - Use `npm ci` for Node.js dependencies and declare the required Node version.
10
+ - Keep deployment, approval, and secret-bearing operations outside unmanaged workflows.
11
+ - Do not expose credentials in workflow logs or command arguments.
12
+ - Use explicit, bounded triggers and concurrency for mutating workflows.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer azd manifest co-location and environment naming rules"
3
+ applyTo: "**/azure.yaml"
4
+ ---
5
+
6
+ # APEX azure.yaml Rules
7
+
8
+ - Keep each workload's `infra.path` inside its workload directory.
9
+ - Use an environment name that identifies both workload and lifecycle stage.
10
+ - Do not point `infra.path` at the consumer repository root.
11
+ - Keep Bicep and Terraform workload paths separate.
12
+ - Treat deployment execution as an APEX-governed operation, not an instruction-driven command.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer Bicep security, AVM, and repeatability guidance"
3
+ applyTo: "**/*.bicep"
4
+ ---
5
+
6
+ # APEX Bicep Rules
7
+
8
+ - Prefer Azure Verified Modules where they fit the selected design.
9
+ - Use managed identity, HTTPS, current TLS baselines, and private data access patterns.
10
+ - Derive names deterministically from the workload, environment, and approved suffix inputs.
11
+ - Keep parameters environment-specific and avoid hardcoded secrets or subscription identifiers.
12
+ - Validate generated Bicep through the APEX workflow before requesting a preview.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer code review, comments, and security boundaries"
3
+ applyTo: "**/*.{js,mjs,cjs,ts,tsx,jsx,py,ps1,sh,bicep,tf}"
4
+ ---
5
+
6
+ # APEX Code Quality
7
+
8
+ - Explain why non-obvious code exists; do not narrate obvious assignments.
9
+ - Validate inputs at boundaries and fail with precise, stable errors.
10
+ - Keep secret values out of source, logs, generated artifacts, and configuration.
11
+ - Prefer typed or structured APIs over ad hoc parsing.
12
+ - Keep changes scoped to the selected project and its declared workflow task.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer guidance context and instruction size boundaries"
3
+ applyTo: ".github/agents/**/*.agent.md, .github/skills/**/SKILL.md, .github/instructions/**/*.instructions.md"
4
+ ---
5
+
6
+ # APEX Context Boundaries
7
+
8
+ - Keep instructions focused on one consumer concern and use narrow `applyTo` globs.
9
+ - Move detailed decision knowledge into a skill reference rather than repeating it across agents.
10
+ - Read only the skills and references needed for the active project task.
11
+ - Prefer targeted edits over full rewrites when changing consumer guidance.
12
+ - Do not embed large logs, secrets, or complete chat history in managed guidance.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer documentation structure and evidence-aware writing rules"
3
+ applyTo: "docs/**/*.md, README.md, **/agent-output/**/*.md"
4
+ ---
5
+
6
+ # APEX Consumer Documentation
7
+
8
+ - Use one H1 per document and concise H2 sections for the remaining structure.
9
+ - Keep lines within 120 characters and use fenced code blocks with a language.
10
+ - Link to local, consumer-relevant files with descriptive text.
11
+ - Distinguish implemented behavior from deferred or unqualified capabilities.
12
+ - Do not claim deployment, client, provider, or compliance qualification without recorded evidence.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer governance evidence and IaC planning boundaries"
3
+ applyTo: "**/04-governance-constraints.md, **/04-governance-constraints.json, **/04-implementation-plan.md"
4
+ ---
5
+
6
+ # APEX Governance And Planning
7
+
8
+ - Treat governance constraints as evidence-bound inputs, not assumptions.
9
+ - Record unavailable policy evidence as a blocker or explicit uncertainty.
10
+ - Bind cost, resilience, security, and naming decisions to the selected project and environment.
11
+ - Keep implementation plans track-neutral until the kernel selects Bicep or Terraform generation.
12
+ - Do not query, exempt, assign, or deploy Azure resources directly from planning guidance.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer custom instruction authoring and scope rules"
3
+ applyTo: ".github/instructions/**/*.instructions.md"
4
+ ---
5
+
6
+ # APEX Instruction Authoring
7
+
8
+ - Use `description` and a narrow `applyTo` pattern in YAML frontmatter.
9
+ - Name consumer instructions with the `apex-` prefix.
10
+ - Keep instructions imperative, concise, and scoped to consumer files.
11
+ - Do not duplicate skill content, repository maintenance rules, or direct operational authority.
12
+ - State evidence and safety boundaries where guidance could otherwise be interpreted as authorization.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer JavaScript and Node.js implementation guidance"
3
+ applyTo: "**/*.{js,mjs,cjs}"
4
+ ---
5
+
6
+ # APEX JavaScript Rules
7
+
8
+ - Use ESM syntax and explicit error handling.
9
+ - Keep command execution bounded, argument-based, and free of shell interpolation.
10
+ - Parse structured input with a parser and validate external data before use.
11
+ - Avoid writing consumer state outside the owning APEX MCP or CLI operation.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer JSON and JSONC configuration rules"
3
+ applyTo: "**/*.{json,jsonc}"
4
+ ---
5
+
6
+ # APEX JSON Rules
7
+
8
+ - Format JSON with two-space indentation and a final newline.
9
+ - Use JSONC comments only where the consumer client supports JSONC.
10
+ - Keep configuration declarative and free of secrets, tokens, or connection strings.
11
+ - Preserve project, run, environment, and track identifiers exactly when they are contract fields.
@@ -0,0 +1,13 @@
1
+ ---
2
+ description: "Consumer Markdown formatting and evidence language rules"
3
+ applyTo: "**/*.md"
4
+ ---
5
+
6
+ # APEX Markdown Rules
7
+
8
+ - Use one H1 and structured H2 sections.
9
+ - Keep lines within 120 characters and specify languages on fenced code blocks.
10
+ - Use descriptive links and avoid feature claims that lack evidence.
11
+ - Keep generated artifact content consistent with its accepted APEX contract.
12
+ - Use accepted APEX templates before adding presentation or diagram content.
13
+ - Use `mermaid` for inline flows and `python-diagrams` for standalone `.py`, `.png`, and `.svg` artifacts.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer PowerShell safety and idempotent scripting guidance"
3
+ applyTo: "**/*.{ps1,psm1}"
4
+ ---
5
+
6
+ # APEX PowerShell Rules
7
+
8
+ - Use approved cmdlets and explicit parameters.
9
+ - Keep scripts non-interactive and idempotent where possible.
10
+ - Require explicit confirmation through APEX project lifecycle prompts before destructive work.
11
+ - Do not embed credentials, tokens, or direct cloud deployment authority in scripts.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer prompt and model instruction boundaries"
3
+ applyTo: ".github/agents/**/*.agent.md, .github/prompts/**/*.prompt.md"
4
+ ---
5
+
6
+ # APEX Prompt Rules
7
+
8
+ - Use the model assigned by the managed role and do not override it redundantly.
9
+ - Keep prompts outcome-focused with explicit scope, input, output, and stop conditions.
10
+ - Keep tool lists minimal and use native client questions for user-owned decisions.
11
+ - Do not grant direct mutation, secrets, repository maintenance, or cloud lifecycle authority.
12
+ - Route workflow state changes through the declared APEX MCP operation.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer Python implementation and validation guidance"
3
+ applyTo: "**/*.py"
4
+ ---
5
+
6
+ # APEX Python Rules
7
+
8
+ - Use explicit dependencies, typed boundaries, and structured parsing.
9
+ - Keep Azure and workflow state operations behind declared APEX capabilities.
10
+ - Validate external input and produce concise, actionable errors.
11
+ - Do not embed secrets, credentials, or direct deployment commands.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer safe file editing and generated artifact boundaries"
3
+ applyTo: "**/*.{js,mjs,cjs,ts,tsx,jsx,py,ps1,sh,bicep,tf}"
4
+ ---
5
+
6
+ # APEX Safe File Edits
7
+
8
+ - Use the client file-editing capability for source changes; do not create files through shell redirection.
9
+ - Do not use heredocs, `tee`, or inline interpreters to write project code or artifacts.
10
+ - Write accepted workflow outputs only through the owning APEX MCP operation.
11
+ - Keep generated files inside the selected project and run boundaries.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer shell safety and non-interactive command rules"
3
+ applyTo: ".github/agents/**/*.agent.md, .github/prompts/**/*.prompt.md, .github/skills/**/SKILL.md"
4
+ ---
5
+
6
+ # APEX Shell Safety
7
+
8
+ - Use non-interactive commands only; do not use confirmation flags or prompt-driven shell builtins.
9
+ - Keep command output bounded and summarize results instead of replaying large logs.
10
+ - Do not request, print, store, or pass secrets through chat or command arguments.
11
+ - Use explicit paths and arguments; avoid shell interpolation for consumer workflow operations.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: "Consumer shell script structure and safety guidance"
3
+ applyTo: "**/*.sh"
4
+ ---
5
+
6
+ # APEX Shell Rules
7
+
8
+ - Use `set -euo pipefail` when compatible with the script's contract.
9
+ - Validate arguments and quote variable expansions.
10
+ - Use structured tools for JSON instead of string parsing.
11
+ - Keep scripts non-interactive and do not embed secrets or direct cloud lifecycle commands.
@@ -0,0 +1,13 @@
1
+ ---
2
+ description: "Consumer skill authoring and progressive disclosure rules"
3
+ applyTo: ".github/skills/**/SKILL.md"
4
+ ---
5
+
6
+ # APEX Skill Authoring
7
+
8
+ - State the supported decision or workflow outcome in the skill description.
9
+ - Keep the main skill concise and place detailed guidance in `references/` files.
10
+ - Describe prerequisites and evidence boundaries before operational guidance.
11
+ - Do not grant new MCP tools, shell access, state mutation, deployment, or secret handling.
12
+ - Route state changes through the owning APEX MCP operation.
13
+ - Keep examples decision-oriented; do not claim live Azure facts without current evidence.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: "Consumer Terraform security, provider, and repeatability guidance"
3
+ applyTo: "**/*.tf"
4
+ ---
5
+
6
+ # APEX Terraform Rules
7
+
8
+ - Prefer Azure Verified Modules and explicit provider constraints.
9
+ - Keep backend, provider, and environment inputs separate from generated resource intent.
10
+ - Use managed identity and Entra-based access patterns instead of shared keys or secrets.
11
+ - Derive names from approved workload and environment inputs.
12
+ - Validate the exact generated configuration and lock state through the APEX workflow before preview.
@@ -12,6 +12,10 @@
12
12
  "nextTask",
13
13
  "taskContext",
14
14
  "recordInput",
15
+ "projectCreate",
16
+ "projectList",
17
+ "projectUse",
18
+ "projectDelete",
15
19
  "stageArtifact",
16
20
  "stageFile",
17
21
  "generateIac",
@@ -51,4 +55,4 @@
51
55
  ]
52
56
  }
53
57
  }
54
- }
58
+ }
@@ -3,7 +3,7 @@ name: APEX Architect
3
3
  description: Resolves architecture trade-offs and submits a typed result to the APEX kernel.
4
4
  argument-hint: Assess the approved requirements
5
5
  model:
6
- - Claude Opus 4.8
6
+ - GPT-5.6 Sol
7
7
  user-invocable: true
8
8
  tools:
9
9
  - vscode/askQuestions
@@ -41,17 +41,11 @@ target: vscode
41
41
  Use `vscode/askQuestions` for kernel-owned input requests. Use the declared direct handoffs for interactive transitions.
42
42
 
43
43
  <!-- apex-shared-body -->
44
- ## Role
44
+ # Goal
45
45
 
46
46
  Produce traceable architecture decisions from the bounded kernel context.
47
47
 
48
- <investigate_before_answering>
49
- Use evidence and discovery results projected by `apex/taskContext`. Query the read-only ARM MCP Cost Management and
50
- Pricing tools when current Azure evidence is required. When required evidence is absent or stale, return the missing
51
- requirement to the kernel or ask the user about a genuine decision; do not replace discovery with assumptions.
52
- </investigate_before_answering>
53
-
54
- ## Method
48
+ # Success criteria
55
49
 
56
50
  1. Call `apex/status`, then loop on `apex/nextTask` until it returns `status=task`.
57
51
  2. For every `status=needs_input`, ask exactly the returned decision questions through the active client projection, then
@@ -77,11 +71,19 @@ Read `.github/skills/apex-azure-cost-optimization/SKILL.md` only for accepted co
77
71
  Read `.github/skills/apex-entra-app-registration/SKILL.md` for an accepted application identity design.
78
72
  Read `.github/skills/apex-azure-cloud-migrate/SKILL.md` for a bounded migration assessment.
79
73
 
80
- ## Boundaries
74
+ # Constraints
81
75
 
82
76
  The kernel is authoritative for accepted requirements, governance completeness, task state, and gates. Write only
83
- through APEX MCP. ARM MCP access is read-only; do not call mutation, deployment, or filesystem tools.
77
+ through APEX MCP. ARM MCP access is read-only; do not call mutation, deployment, or filesystem tools. Use evidence and
78
+ discovery results projected by `apex/taskContext`; query read-only ARM Cost Management and Pricing tools only when
79
+ current Azure evidence is required. Return missing or stale evidence to the kernel or ask the user about a genuine
80
+ decision rather than replacing discovery with assumptions.
84
81
 
85
- ## Output
82
+ # Output
86
83
 
87
84
  Return the kernel completion result and unresolved decisions. Do not claim gate readiness unless the kernel reports it.
85
+
86
+ # Stop rules
87
+
88
+ Stop when the kernel reports completion, missing input, stale context, or insufficient evidence. Do not create an
89
+ architecture artifact from inferred requirements.