@massa-ai/codex-plugin 1.13.0 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/.codex-plugin/plugin.json +1 -1
  2. package/agents/massa-ai-architecture-specialist.toml +0 -3
  3. package/agents/massa-ai-audit-specialist.toml +0 -3
  4. package/agents/massa-ai-builder.toml +0 -3
  5. package/agents/massa-ai-context-curator.toml +0 -3
  6. package/agents/massa-ai-documentation-agent.toml +0 -3
  7. package/agents/massa-ai-furps-analyst.toml +0 -3
  8. package/agents/massa-ai-investigator.toml +0 -3
  9. package/agents/massa-ai-judge.toml +6 -5
  10. package/agents/massa-ai-meta-judge.toml +5 -2
  11. package/agents/massa-ai-mobile-specialist.toml +0 -3
  12. package/agents/massa-ai-navigator.toml +0 -3
  13. package/agents/massa-ai-plan-critic.toml +0 -3
  14. package/agents/massa-ai-planner.toml +0 -3
  15. package/agents/massa-ai-requirements-analyst.toml +0 -3
  16. package/agents/massa-ai-reviewer.toml +0 -3
  17. package/agents/massa-ai-test-engineer.toml +0 -3
  18. package/agents/massa-ai-verification-agent.toml +0 -3
  19. package/package.json +1 -1
  20. package/skills/agents/architecture-specialist/SKILL.md +1 -4
  21. package/skills/agents/audit-specialist/SKILL.md +1 -4
  22. package/skills/agents/builder/SKILL.md +1 -4
  23. package/skills/agents/context-curator/SKILL.md +1 -4
  24. package/skills/agents/documentation-agent/SKILL.md +1 -4
  25. package/skills/agents/furps-analyst/SKILL.md +1 -4
  26. package/skills/agents/investigator/SKILL.md +1 -4
  27. package/skills/agents/judge/SKILL.md +7 -6
  28. package/skills/agents/meta-judge/SKILL.md +6 -3
  29. package/skills/agents/mobile-specialist/SKILL.md +1 -4
  30. package/skills/agents/navigator/SKILL.md +1 -4
  31. package/skills/agents/plan-critic/SKILL.md +1 -4
  32. package/skills/agents/planner/SKILL.md +1 -4
  33. package/skills/agents/requirements-analyst/SKILL.md +1 -4
  34. package/skills/agents/reviewer/SKILL.md +1 -4
  35. package/skills/agents/test-engineer/SKILL.md +1 -4
  36. package/skills/agents/verification-agent/SKILL.md +1 -4
  37. package/skills/massa-ai/references/agent-orchestration.md +25 -19
  38. package/skills/massa-ai/references/maestro/fact-ledger.md +2 -2
  39. package/skills/massa-ai/references/maestro.md +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "massa-ai",
3
- "version": "1.13.0",
3
+ "version": "1.15.0",
4
4
  "description": "massa-ai — semantic code search, memory, and context compression for Codex",
5
5
  "author": {
6
6
  "name": "Luiz Massa",
@@ -53,9 +53,6 @@ Provide architectural guidance by evaluating structure, suggesting boundaries, a
53
53
  - Synapse: own ephemeral session when evaluation spans multiple modules with repeated searches.
54
54
  - References: `references/architecture-lenses.md`, `references/architecture-domain-lens.md`, `references/architecture-coupling-lens.md`, `references/architecture-deepening-lens.md`.
55
55
 
56
- ## Model Hint
57
- MiniMax M3 (advisory). Fallback to the workflow's configured default model if unavailable.
58
-
59
56
  ## Validation Sensors
60
57
  - Every finding has a `path:line` or metric pointer.
61
58
  - Trade-offs name at least two alternatives.
@@ -68,9 +68,6 @@ All lenses share `references/audit-scope.md` (scope rules) and `references/audit
68
68
  - Synapse: own ephemeral session when the audit spans multiple modules with repeated searches.
69
69
  - References: `references/audit-scope.md`, `references/audit-report-io.md`, plus the per-lens references above.
70
70
 
71
- ## Model Hint
72
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
73
-
74
71
  ## Validation Sensors
75
72
  - Every finding has a `path:line` pointer.
76
73
  - Findings follow the project audit-report format (`references/audit-report-io.md`).
@@ -55,9 +55,6 @@ Implement an approved plan or task by modifying source code with a disjoint writ
55
55
  - Synapse: none (implementation is not a repeated-search task).
56
56
  - References: `references/agent-orchestration.md`, `references/naming-standards.md`, `references/code-annotation.md`, `references/root-cause-scripts.md`.
57
57
 
58
- ## Model Hint
59
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
60
-
61
58
  ## Validation Sensors
62
59
  - Verification commands from the plan pass (tests, build, typecheck, lint).
63
60
  - Diff stays within the assigned write set.
@@ -55,9 +55,6 @@ Prepare the minimum high-quality Context Packet required for another agent to do
55
55
  - Synapse: own ephemeral session per `references/synapse-policy.md`; pass `synapseSessionId` on every `search`.
56
56
  - References: `references/context-firewall.md`, `references/synapse-policy.md`, `references/mcp-tools.md`.
57
57
 
58
- ## Model Hint
59
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
60
-
61
58
  ## Validation Sensors
62
59
  - Every file in the Context Packet exists (`test -f`).
63
60
  - Every reference in the packet exists in the symlinked skill tree.
@@ -53,9 +53,6 @@ Generate engineering documentation artifacts (README, ADR, RFC, changelog, KDoc,
53
53
  - Synapse: none (documentation is not a repeated-search task).
54
54
  - References: `references/adr-authoring.md`, `references/rfc/`.
55
55
 
56
- ## Model Hint
57
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
58
-
59
56
  ## Validation Sensors
60
57
  - Stale-reference scan passes (no dead links to removed files).
61
58
  - Doc format matches the project ADR/RFC template.
@@ -57,9 +57,6 @@ Analyze exactly one FURPS+ dimension of a PRD or ADR against its checklist secti
57
57
  - Synapse: own ephemeral session when >= 2 searches are expected, per `references/synapse-policy.md`.
58
58
  - References: `references/furps/checklist.md`, `references/furps/report-contract.md`, `references/furps/intake.md`, `references/agent-orchestration.md`.
59
59
 
60
- ## Model Hint
61
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
62
-
63
60
  ## Validation Sensors
64
61
  - Source-location proof (quote plus section) for every `covered`/`partial` claim.
65
62
  - Absent-claim detection for every `missing` claim.
@@ -56,9 +56,6 @@ Read and understand the codebase to answer engineering questions without modifyi
56
56
  - Synapse: own ephemeral session per `references/synapse-policy.md`; pass `synapseSessionId` on every `search`.
57
57
  - References: `references/codebase-investigation.md`, `references/agent-orchestration.md`, `references/synapse-policy.md`.
58
58
 
59
- ## Model Hint
60
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
61
-
62
59
  ## Validation Sensors
63
60
  - Source-backed evidence for every claim (`path:line`).
64
61
  - Dependency references confirmed via `get_references` or equivalent.
@@ -78,11 +78,12 @@ next_step: <string>
78
78
  - References: `references/agent-orchestration.md`, `references/audit-report-io.md` (Judge With Debate Report Contracts).
79
79
 
80
80
  ## Model Hint
81
- deepseek-v4-pro (advisory charter default — the Judge-1 slot model). Per-slot diversity is
82
- assigned by the workflow at dispatch: Judge 1 `deepseek-v4-pro`, Judge 2 `minimax-m3`, Judge 3
83
- `GLM-5.2`. Hosts without dispatch-time model selection run this charter default for every slot;
84
- the orchestrator records that as `DIVERSITY DEGRADED` per the workflow contract. Fallback to the
85
- workflow's configured default model if the pinned model is unavailable.
81
+ This charter's `metadata.model_tier` (`deep`) is the fallback every host runs when dispatch-time
82
+ model selection is unavailable. The `judge-with-debate` workflow additionally requests per-slot
83
+ model diversity at dispatch time on hosts that support it — `workflows/judge-with-debate.md` is
84
+ the single source for the current slot assignments, not this file. When dispatch-time selection
85
+ is unavailable, every slot runs the charter default and the orchestrator records
86
+ `DIVERSITY DEGRADED` per the workflow contract.
86
87
 
87
88
  ## Validation Sensors
88
89
  - Every criterion score carries an exact quotation from the artifact.
@@ -69,8 +69,11 @@ overall: weighted-mean
69
69
  - References: `references/agent-orchestration.md`, `references/audit-report-io.md` (Judge With Debate Report Contracts).
70
70
 
71
71
  ## Model Hint
72
- kimi-k3 (advisory). Fallback to the workflow's configured default model if unavailable; the
73
- fallback is recorded by the orchestrator as a diversity warning per the workflow contract.
72
+ This charter's `metadata.model_tier` (`deep`) is the fallback every host runs when dispatch-time
73
+ model selection is unavailable. The `judge-with-debate` workflow additionally requests a specific
74
+ model for this slot at dispatch time on hosts that support it — `workflows/judge-with-debate.md`
75
+ is the single source for the current assignment, not this file. When dispatch-time selection is
76
+ unavailable, the orchestrator records a diversity warning per the workflow contract.
74
77
 
75
78
  ## Validation Sensors
76
79
  - Output parses as YAML; weights sum to 1.0 (±0.001); every criterion carries id, name, weight, scale (min 1, max 5), rubric anchors for 1/3/5, and a non-empty checklist.
@@ -70,9 +70,6 @@ If none are present, refuse with: `Non-mobile target. Refusing mobile-specialist
70
70
  - Synapse: own ephemeral session when guidance spans multiple mobile modules with repeated searches.
71
71
  - References: `references/mobile-context.md`, `references/mobile-diagnosis.md`, `references/maestro.md`.
72
72
 
73
- ## Model Hint
74
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
75
-
76
73
  ## Validation Sensors
77
74
  - At least one detection signal is confirmed present before guidance is given.
78
75
  - Every finding has a `path:line` pointer or a platform constraint citation.
@@ -62,9 +62,6 @@ The user's codebase is **already indexed** by massa-ai. The first move on any qu
62
62
  - Massa-ai Memory: suggest durable navigation facts (entry points, ownership boundaries) only when reusable; the main agent persists.
63
63
  - References: `references/mcp-tools.md`, `references/codebase-investigation.md`, `references/synapse-policy.md`, `references/context-firewall.md`.
64
64
 
65
- ## Model Hint
66
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
67
-
68
65
  ## Validation Sensors
69
66
  - Every claim carries a `path:line` or symbol pointer.
70
67
  - Index-derived claims carry freshness evidence, or are labeled reduced-confidence.
@@ -76,9 +76,6 @@ Never receives full conversation context.
76
76
  - Policy: the main agent owns mode selection, synthesis, plan revision, and the Evidence Gate; this agent owns the critique only.
77
77
  - References: `references/agent-orchestration.md`, `references/the-fool/`, `references/verification-ladder.md`.
78
78
 
79
- ## Model Hint
80
- MiniMax M3 (advisory). Fallback to the workflow's configured default model if unavailable.
81
-
82
79
  ## Validation Sensors
83
80
  - Every challenge ties to a plan section plus a concrete evidence gap or falsifiable check.
84
81
  - No challenge rests on missing conversation history that the packet intentionally excluded.
@@ -53,9 +53,6 @@ Transform an engineering request into a structured implementation plan.
53
53
  - Synapse: none (planning is not a repeated-search task).
54
54
  - References: `references/agent-orchestration.md`, `references/subagent-design.md`.
55
55
 
56
- ## Model Hint
57
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
58
-
59
56
  ## Validation Sensors
60
57
  - Every step in the plan references a concrete file, module, or task.
61
58
  - Every risk has a mitigation or accepted-risk note.
@@ -52,9 +52,6 @@ Analyze requirements before implementation to surface ambiguity, gaps, contradic
52
52
  - Synapse: none (analysis is not a repeated-search task).
53
53
  - References: `references/spec-driven/specify.md`, `references/furps/`.
54
54
 
55
- ## Model Hint
56
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
57
-
58
55
  ## Validation Sensors
59
56
  - Every finding cites a requirement ID or spec section.
60
57
  - Every implicit requirement is flagged for user acceptance or recorded as an assumption.
@@ -54,9 +54,6 @@ Review implementation quality by analyzing the diff and flagging bugs, regressio
54
54
  - Synapse: none (review is not a repeated-search task).
55
55
  - References: `references/agent-orchestration.md`.
56
56
 
57
- ## Model Hint
58
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
59
-
60
57
  ## Validation Sensors
61
58
  - Every finding has a `path:line` pointer.
62
59
  - Static checks (lint, typecheck) run when available.
@@ -54,9 +54,6 @@ Generate a testing strategy that covers unit, integration, edge cases, negative
54
54
  - Synapse: none (test planning is not a repeated-search task).
55
55
  - References: `references/verification-ladder.md`, `references/code-annotation.md`, `references/root-cause-scripts.md`.
56
56
 
57
- ## Model Hint
58
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
59
-
60
57
  ## Validation Sensors
61
58
  - Every acceptance criterion maps to at least one test case.
62
59
  - Edge cases and negative scenarios are enumerated.
@@ -52,9 +52,6 @@ Centralize Verification Ladder logic and validate that a task's output meets its
52
52
  - Synapse: none (verification is not a repeated-search task).
53
53
  - References: `references/verification-ladder.md`, `references/evidence-gate.md`.
54
54
 
55
- ## Model Hint
56
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
57
-
58
55
  ## Validation Sensors
59
56
  - Every acceptance criterion has a PASS/FAIL verdict with evidence.
60
57
  - Skipped checks have a concrete reason.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@massa-ai/codex-plugin",
3
- "version": "1.13.0",
3
+ "version": "1.15.0",
4
4
  "description": "massa-ai plugin for Codex — semantic code search, memory, and context compression",
5
5
  "files": [
6
6
  "agents",
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: MiniMax M3
8
+ model_tier: deep
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -58,9 +58,6 @@ Provide architectural guidance by evaluating structure, suggesting boundaries, a
58
58
  - Synapse: own ephemeral session when evaluation spans multiple modules with repeated searches.
59
59
  - References: `references/architecture-lenses.md`, `references/architecture-domain-lens.md`, `references/architecture-coupling-lens.md`, `references/architecture-deepening-lens.md`.
60
60
 
61
- ## Model Hint
62
- MiniMax M3 (advisory). Fallback to the workflow's configured default model if unavailable.
63
-
64
61
  ## Validation Sensors
65
62
  - Every finding has a `path:line` or metric pointer.
66
63
  - Trade-offs name at least two alternatives.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -73,9 +73,6 @@ All lenses share `references/audit-scope.md` (scope rules) and `references/audit
73
73
  - Synapse: own ephemeral session when the audit spans multiple modules with repeated searches.
74
74
  - References: `references/audit-scope.md`, `references/audit-report-io.md`, plus the per-lens references above.
75
75
 
76
- ## Model Hint
77
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
78
-
79
76
  ## Validation Sensors
80
77
  - Every finding has a `path:line` pointer.
81
78
  - Findings follow the project audit-report format (`references/audit-report-io.md`).
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: write
10
10
  ---
11
11
 
@@ -60,9 +60,6 @@ Implement an approved plan or task by modifying source code with a disjoint writ
60
60
  - Synapse: none (implementation is not a repeated-search task).
61
61
  - References: `references/agent-orchestration.md`, `references/naming-standards.md`, `references/code-annotation.md`, `references/root-cause-scripts.md`.
62
62
 
63
- ## Model Hint
64
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
65
-
66
63
  ## Validation Sensors
67
64
  - Verification commands from the plan pass (tests, build, typecheck, lint).
68
65
  - Diff stays within the assigned write set.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: DeepSeek V4 Pro
8
+ model_tier: light
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -60,9 +60,6 @@ Prepare the minimum high-quality Context Packet required for another agent to do
60
60
  - Synapse: own ephemeral session per `references/synapse-policy.md`; pass `synapseSessionId` on every `search`.
61
61
  - References: `references/context-firewall.md`, `references/synapse-policy.md`, `references/mcp-tools.md`.
62
62
 
63
- ## Model Hint
64
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
65
-
66
63
  ## Validation Sensors
67
64
  - Every file in the Context Packet exists (`test -f`).
68
65
  - Every reference in the packet exists in the symlinked skill tree.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: DeepSeek V4 Pro
8
+ model_tier: light
9
9
  permission: write
10
10
  ---
11
11
 
@@ -58,9 +58,6 @@ Generate engineering documentation artifacts (README, ADR, RFC, changelog, KDoc,
58
58
  - Synapse: none (documentation is not a repeated-search task).
59
59
  - References: `references/adr-authoring.md`, `references/rfc/`.
60
60
 
61
- ## Model Hint
62
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
63
-
64
61
  ## Validation Sensors
65
62
  - Stale-reference scan passes (no dead links to removed files).
66
63
  - Doc format matches the project ADR/RFC template.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -62,9 +62,6 @@ Analyze exactly one FURPS+ dimension of a PRD or ADR against its checklist secti
62
62
  - Synapse: own ephemeral session when >= 2 searches are expected, per `references/synapse-policy.md`.
63
63
  - References: `references/furps/checklist.md`, `references/furps/report-contract.md`, `references/furps/intake.md`, `references/agent-orchestration.md`.
64
64
 
65
- ## Model Hint
66
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
67
-
68
65
  ## Validation Sensors
69
66
  - Source-location proof (quote plus section) for every `covered`/`partial` claim.
70
67
  - Absent-claim detection for every `missing` claim.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: DeepSeek V4 Pro
8
+ model_tier: light
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -61,9 +61,6 @@ Read and understand the codebase to answer engineering questions without modifyi
61
61
  - Synapse: own ephemeral session per `references/synapse-policy.md`; pass `synapseSessionId` on every `search`.
62
62
  - References: `references/codebase-investigation.md`, `references/agent-orchestration.md`, `references/synapse-policy.md`.
63
63
 
64
- ## Model Hint
65
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
66
-
67
64
  ## Validation Sensors
68
65
  - Source-backed evidence for every claim (`path:line`).
69
66
  - Dependency references confirmed via `get_references` or equivalent.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: deepseek-v4-pro
8
+ model_tier: deep
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -83,11 +83,12 @@ next_step: <string>
83
83
  - References: `references/agent-orchestration.md`, `references/audit-report-io.md` (Judge With Debate Report Contracts).
84
84
 
85
85
  ## Model Hint
86
- deepseek-v4-pro (advisory charter default — the Judge-1 slot model). Per-slot diversity is
87
- assigned by the workflow at dispatch: Judge 1 `deepseek-v4-pro`, Judge 2 `minimax-m3`, Judge 3
88
- `GLM-5.2`. Hosts without dispatch-time model selection run this charter default for every slot;
89
- the orchestrator records that as `DIVERSITY DEGRADED` per the workflow contract. Fallback to the
90
- workflow's configured default model if the pinned model is unavailable.
86
+ This charter's `metadata.model_tier` (`deep`) is the fallback every host runs when dispatch-time
87
+ model selection is unavailable. The `judge-with-debate` workflow additionally requests per-slot
88
+ model diversity at dispatch time on hosts that support it — `workflows/judge-with-debate.md` is
89
+ the single source for the current slot assignments, not this file. When dispatch-time selection
90
+ is unavailable, every slot runs the charter default and the orchestrator records
91
+ `DIVERSITY DEGRADED` per the workflow contract.
91
92
 
92
93
  ## Validation Sensors
93
94
  - Every criterion score carries an exact quotation from the artifact.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: kimi-k3
8
+ model_tier: deep
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -74,8 +74,11 @@ overall: weighted-mean
74
74
  - References: `references/agent-orchestration.md`, `references/audit-report-io.md` (Judge With Debate Report Contracts).
75
75
 
76
76
  ## Model Hint
77
- kimi-k3 (advisory). Fallback to the workflow's configured default model if unavailable; the
78
- fallback is recorded by the orchestrator as a diversity warning per the workflow contract.
77
+ This charter's `metadata.model_tier` (`deep`) is the fallback every host runs when dispatch-time
78
+ model selection is unavailable. The `judge-with-debate` workflow additionally requests a specific
79
+ model for this slot at dispatch time on hosts that support it — `workflows/judge-with-debate.md`
80
+ is the single source for the current assignment, not this file. When dispatch-time selection is
81
+ unavailable, the orchestrator records a diversity warning per the workflow contract.
79
82
 
80
83
  ## Validation Sensors
81
84
  - Output parses as YAML; weights sum to 1.0 (±0.001); every criterion carries id, name, weight, scale (min 1, max 5), rubric anchors for 1/3/5, and a non-empty checklist.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -75,9 +75,6 @@ If none are present, refuse with: `Non-mobile target. Refusing mobile-specialist
75
75
  - Synapse: own ephemeral session when guidance spans multiple mobile modules with repeated searches.
76
76
  - References: `references/mobile-context.md`, `references/mobile-diagnosis.md`, `references/maestro.md`.
77
77
 
78
- ## Model Hint
79
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
80
-
81
78
  ## Validation Sensors
82
79
  - At least one detection signal is confirmed present before guidance is given.
83
80
  - Every finding has a `path:line` pointer or a platform constraint citation.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: DeepSeek V4 Pro
8
+ model_tier: light
9
9
  permission: read-only
10
10
  tools: mcp-index
11
11
  ---
@@ -68,9 +68,6 @@ The user's codebase is **already indexed** by massa-ai. The first move on any qu
68
68
  - Massa-ai Memory: suggest durable navigation facts (entry points, ownership boundaries) only when reusable; the main agent persists.
69
69
  - References: `references/mcp-tools.md`, `references/codebase-investigation.md`, `references/synapse-policy.md`, `references/context-firewall.md`.
70
70
 
71
- ## Model Hint
72
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
73
-
74
71
  ## Validation Sensors
75
72
  - Every claim carries a `path:line` or symbol pointer.
76
73
  - Index-derived claims carry freshness evidence, or are labeled reduced-confidence.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: MiniMax M3
8
+ model_tier: deep
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -81,9 +81,6 @@ Never receives full conversation context.
81
81
  - Policy: the main agent owns mode selection, synthesis, plan revision, and the Evidence Gate; this agent owns the critique only.
82
82
  - References: `references/agent-orchestration.md`, `references/the-fool/`, `references/verification-ladder.md`.
83
83
 
84
- ## Model Hint
85
- MiniMax M3 (advisory). Fallback to the workflow's configured default model if unavailable.
86
-
87
84
  ## Validation Sensors
88
85
  - Every challenge ties to a plan section plus a concrete evidence gap or falsifiable check.
89
86
  - No challenge rests on missing conversation history that the packet intentionally excluded.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: deep
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -58,9 +58,6 @@ Transform an engineering request into a structured implementation plan.
58
58
  - Synapse: none (planning is not a repeated-search task).
59
59
  - References: `references/agent-orchestration.md`, `references/subagent-design.md`.
60
60
 
61
- ## Model Hint
62
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
63
-
64
61
  ## Validation Sensors
65
62
  - Every step in the plan references a concrete file, module, or task.
66
63
  - Every risk has a mitigation or accepted-risk note.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: DeepSeek V4 Pro
8
+ model_tier: standard
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -57,9 +57,6 @@ Analyze requirements before implementation to surface ambiguity, gaps, contradic
57
57
  - Synapse: none (analysis is not a repeated-search task).
58
58
  - References: `references/spec-driven/specify.md`, `references/furps/`.
59
59
 
60
- ## Model Hint
61
- DeepSeek V4 Pro (advisory). Fallback to the workflow's configured default model if unavailable.
62
-
63
60
  ## Validation Sensors
64
61
  - Every finding cites a requirement ID or spec section.
65
62
  - Every implicit requirement is flagged for user acceptance or recorded as an assumption.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -59,9 +59,6 @@ Review implementation quality by analyzing the diff and flagging bugs, regressio
59
59
  - Synapse: none (review is not a repeated-search task).
60
60
  - References: `references/agent-orchestration.md`.
61
61
 
62
- ## Model Hint
63
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
64
-
65
62
  ## Validation Sensors
66
63
  - Every finding has a `path:line` pointer.
67
64
  - Static checks (lint, typecheck) run when available.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: write
10
10
  ---
11
11
 
@@ -59,9 +59,6 @@ Generate a testing strategy that covers unit, integration, edge cases, negative
59
59
  - Synapse: none (test planning is not a repeated-search task).
60
60
  - References: `references/verification-ladder.md`, `references/code-annotation.md`, `references/root-cause-scripts.md`.
61
61
 
62
- ## Model Hint
63
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
64
-
65
62
  ## Validation Sensors
66
63
  - Every acceptance criterion maps to at least one test case.
67
64
  - Edge cases and negative scenarios are enumerated.
@@ -5,7 +5,7 @@ license: MIT
5
5
  metadata:
6
6
  author: S1LV4, luizgmassa
7
7
  version: "1.0.0"
8
- model_hint: GLM-5.2
8
+ model_tier: standard
9
9
  permission: read-only
10
10
  ---
11
11
 
@@ -57,9 +57,6 @@ Centralize Verification Ladder logic and validate that a task's output meets its
57
57
  - Synapse: none (verification is not a repeated-search task).
58
58
  - References: `references/verification-ladder.md`, `references/evidence-gate.md`.
59
59
 
60
- ## Model Hint
61
- GLM-5.2 (advisory). Fallback to the workflow's configured default model if unavailable.
62
-
63
60
  ## Validation Sensors
64
61
  - Every acceptance criterion has a PASS/FAIL verdict with evidence.
65
62
  - Skipped checks have a concrete reason.
@@ -79,25 +79,31 @@ dispatch.
79
79
 
80
80
  Before adding a new reusable role, load `references/subagent-design.md` and write a bounded role charter. For one-off tasks, use an existing role plus the prompt contract below instead of inventing a new role.
81
81
 
82
- | Role | Host agent name | Use For | Read/Write | Charter |
83
- |---|---|---|---|---|
84
- | `investigator` | `massa-ai-investigator` | Trace code paths, find entry points, summarize current behavior | read-only | `skills/agents/investigator/SKILL.md` |
85
- | `navigator` | `massa-ai-navigator` | Answer "where is X / who calls Y" from the massa-ai index before reading files | read-only | `skills/agents/navigator/SKILL.md` |
86
- | `implementer` → `builder` | `massa-ai-builder` | Execute one atomic task with a disjoint write set | write | `skills/agents/builder/SKILL.md` |
87
- | `verifier` → `verification-agent` | `massa-ai-verification-agent` | Independently run sensors and inspect whether claims hold | read-only | `skills/agents/verification-agent/SKILL.md` |
88
- | `domain-mapper` → `architecture-specialist` | `massa-ai-architecture-specialist` | Identify subdomains, bounded contexts, language conflicts, cohesion | read-only | `skills/agents/architecture-specialist/SKILL.md` (lens: `domain`) |
89
- | `coupling-auditor` → `architecture-specialist` | `massa-ai-architecture-specialist` | Analyze strength, distance, volatility, and risky dependencies | read-only | `skills/agents/architecture-specialist/SKILL.md` (lens: `coupling`) |
90
- | `deepening-architect` → `architecture-specialist` | `massa-ai-architecture-specialist` | Find shallow modules and deepening opportunities | read-only | `skills/agents/architecture-specialist/SKILL.md` (lens: `deepening`) |
91
- | `audit-specialist` | `massa-ai-audit-specialist` | Findings-only audit through one selected `lens` | read-only | `skills/agents/audit-specialist/SKILL.md` |
92
- | `plan-critic` | `massa-ai-plan-critic` | Stress-test a constructed plan using The Fool mode and return bounded critique | read-only | `skills/agents/plan-critic/SKILL.md` |
93
- | `furps-analyst` | `massa-ai-furps-analyst` | Analyze one FURPS+ dimension of a PRD/ADR against the checklist and return structured findings | read-only | `skills/agents/furps-analyst/SKILL.md` |
94
-
95
- The remaining charters — `planner`, `reviewer`, `context-curator`,
96
- `requirements-analyst`, `test-engineer`, `documentation-agent`,
97
- `mobile-specialist` — follow the same `massa-ai-<role>` convention and are
98
- listed in the Agent Table of `skills/AGENTS.md`.
99
-
100
- **Role mapping:** `investigator`→`investigator` (identical); `implementer`→`builder` (renamed); `verifier`→`verification-agent` (renamed, centralizes Verification Ladder); `domain-mapper`+`coupling-auditor`+`deepening-architect`→`architecture-specialist` (three roles folded into one specialist; the `lens` input field selects the sub-mode). Workflows dispatch the new agent names via named dispatch blocks; the old role names above are kept for traceability only.
82
+ ## Roles
83
+
84
+ **The roster lives in one place: the Agent Table of `skills/AGENTS.md`**, which names
85
+ every shipped specialist with its purpose, trigger, permission, and charter path. Do not
86
+ restate it here. A second roster in this file is what let `judge` and `meta-judge` go
87
+ undocumented for a whole release with every gate green — the guard checked that the
88
+ charter paths *mentioned* here resolve, which a charter that is never mentioned cannot
89
+ fail.
90
+
91
+ This file owns dispatch mechanics. The one roster fact it owns is the **legacy role
92
+ vocabulary**: names earlier workflows dispatched by, kept so an old reference still
93
+ resolves to a current agent.
94
+
95
+ | Legacy role | Current agent | Note |
96
+ |---|---|---|
97
+ | `implementer` | `massa-ai-builder` | renamed |
98
+ | `verifier` | `massa-ai-verification-agent` | renamed; also centralizes the Verification Ladder |
99
+ | `domain-mapper` | `massa-ai-architecture-specialist` | folded in; `lens: domain` |
100
+ | `coupling-auditor` | `massa-ai-architecture-specialist` | folded in; `lens: coupling` |
101
+ | `deepening-architect` | `massa-ai-architecture-specialist` | folded in; `lens: deepening` |
102
+
103
+ `investigator`, `plan-critic` and `furps-analyst` kept their own names; every other
104
+ specialist is new and never had a legacy one. Workflows dispatch the current
105
+ `massa-ai-<role>` name through a named dispatch block — the legacy column is traceability
106
+ only, never a dispatch target.
101
107
 
102
108
  ## Capability Packet
103
109
 
@@ -7,7 +7,7 @@ Use this before making Maestro claims. It defines source authority, fact tags, l
7
7
  1. `official-doc`: current official Maestro documentation, preferably `.md` pages under `https://docs.maestro.dev/`.
8
8
  2. `live-help`: successful local CLI transcript from the installed Maestro binary, including command, exit code, stdout, and stderr.
9
9
  3. `repo-convention`: current repository flows, config, CI, scripts, report paths, and existing naming/tag patterns.
10
- 4. `excluded/unverified`: NotebookLM answers, `/Users/luizmassa/Downloads/questions.md`, blog posts, memory, or assumptions that are not confirmed by the first three sources.
10
+ 4. `excluded/unverified`: NotebookLM answers, a user-supplied coverage checklist, blog posts, memory, or assumptions that are not confirmed by the first three sources.
11
11
 
12
12
  If sources conflict, prefer `official-doc` for product behavior and `live-help` for installed CLI syntax. Mention version drift when `live-help` differs from docs.
13
13
 
@@ -39,7 +39,7 @@ If PATH cannot resolve `maestro`, mark local CLI validation blocked. If the bina
39
39
 
40
40
  ## Coverage Checklist Handling
41
41
 
42
- Use `/Users/luizmassa/Downloads/questions.md` as a checklist to ask "did we cover this surface?" Never cite it as source truth.
42
+ When the user supplies a coverage checklist, use it to ask "did we cover this surface?" Never cite it as source truth, and never assume one exists — if the user supplied none, this section imposes no requirement.
43
43
 
44
44
  Checklist-only facts that must stay non-normative unless independently verified:
45
45
 
@@ -6,7 +6,7 @@ Use this small index from `workflows/maestro/maestro.md`, `workflows/maestro/mae
6
6
 
7
7
  Load `references/maestro/fact-ledger.md` before making any normative Maestro claim. Every Maestro claim must be tagged as `official-doc`, `live-help`, `repo-convention`, or `excluded/unverified`.
8
8
 
9
- Use `/Users/luizmassa/Downloads/questions.md` only as a coverage checklist. If a checklist item is not supported by official Maestro docs, live CLI help, or repository convention, quarantine it as `excluded/unverified`.
9
+ Use a user-supplied coverage checklist, when the user provides one, only as a coverage checklist. If a checklist item is not supported by official Maestro docs, live CLI help, or repository convention, quarantine it as `excluded/unverified`.
10
10
 
11
11
  Official source anchors:
12
12