evaluate-mmi

Files (1)

• SKILL.md

SKILL.md (first lines)

# MMI Evaluation

Shared files: a path written `@rules/…`, `@skills/…`, `@templates/…` or `@docs/…` is relative to the
plugin root, `${CLAUDE_PLUGIN_ROOT}` — not to the project being worked on. Read it from there.

**Usage:** `/architect:evaluate-mmi [target_path]`

## Desired Outcome

Evaluate each module of the target system across the 4 MMI axes and determine microservice readiness.

## Decision Criteria

For detailed scoring criteria and algorithms, refer to:
@rules/evaluation-frameworks.md

- 4 axes: Cohesion (30%), Coupling (30%), Independence (20%), Reusability (20%)
- Each axis scored 1-5
- MMI = (0.3 × C + 0.3 × K + 0.2 × I + 0.2 × R) / 5 × 100
- Maturity: 80-100 (Ready), 60-80 (Moderate), 40-60 (Needs Improvement), 0-40 (Immature)

## Prerequisites

| File | Required/Recommended | Source |
|------|---------------------|--------|
| reports/01_analysis/ | Required | /architect:analyze |

## Execution

### Step 1: Identify Modules

Glob for `reports/before/**/codebase-structure.md` to find the investigate-phase output, then read the found file. Also read `reports/01_analysis/domain-code-mapping.md`. Extract the list of modules to evaluate and record module names — these will be passed to sub-agents.

### Step 2: Collect Input File Paths

Glob for all analysis documents: `reports/01_analysis/**/*.md`

Record the full list of found file paths — these will be passed to all sub-agents.

### Step 3: Spawn Four Parallel Axis Evaluators

In a **single message**, issue all four Agent() calls simultaneously so they run in parallel.
Each evaluator scores ALL identified modules on its specific axis.

**Task A — Cohesion Axis**
```
Agent(
  subagent_type: "general-purpose",
  model: "sonnet",
  description: "MMI cohesion axis evaluation for all modules",
  prompt: """
You are evaluating COHESION (functional coherence within a module) for each module in a software system.

Modules to evaluate:
<MODULE_LIST>
[Insert the module names identified in Step 1, one per line]
</MODULE_LIST>

Read all analysis documents using the Read tool:
<FILE_LIST>
[Insert the full list of file paths found in Step 2, one per line]
</FILE_LIST>

For each module, score its Cohesion on a scale of 1-5:
- 5 (Exemplary): Single clear responsibility, all components tightly related, no leakage
- 4 (Good): Minor mixed concerns but mostly cohesive
- 3 (Acceptable): Some mixed responsibilities, identifiable but imperfect boundaries
- 2 (Concerning): Multiple unrelated responsibilities coexist
- 1 (Critical): No clear responsibility, god-class or utility-dumping-ground pattern

Return ONLY this JSON (no markdown fences, no explanation):
{
  "axis": "Cohesion",
  "weight": 0.30,
  "modules": [
    {
      "name": "<module name>",
      "score": <integer 1-5>,
      "rationale": "<1-2 sentence explanation>"
    }
  ]
}
"""
)
```

**Task B — Coupling Axis**
```
Agent(
  subagent_type: "general-purpose",
  model: "sonnet",
  description: "MMI coupling axis evaluation for all modules",
  prompt: """
You are evaluating COUPLING (degree of inter-module dependencies) for each module in a software system.

Modules to evaluate:
<MODULE_LIST>
[Insert the module names identified in Step 1, one per line]
</MODULE_LIST>

Read all analysis documents using the Read tool:
<FILE_LIST>
[Insert the full list of file paths found in Step 2, one per line]
</FILE_LIST>

For each module, score its Coupling (lower coupling = higher score) on a scale of 1-5:
- 5 (Exemplary): Minimal dependencies, well-defined interfaces, no circular dependencies
- 4 (Good): Few dependencies, mostly unidirectional
- 3 (Acceptable): Moderate dependencies, some bidirectional coupling
- 2 (Concerning): High fan-out or fan-in, implicit dependencies
- 1 (Critical): Circular dependencies, tight coupling, impossible to change in isolation

Return ONLY this JSON (no markdown fences, no explanation):
{
  "axis": "Coupling",
  "weight": 0.30,
  "modules": [
    {
      "name": "<module name>",

From wfukatsu/nexus-architect, MIT.

More from wfukatsu/nexus-architect