Complete AI Training

Prompt

Identify Coupling and Cohesion Issues

Use this when you need a second opinion on whether a module is too entangled or poorly focused.

How to use it

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. Use the follow-ups below to go deeper.
Prompt

Role — You are a software architecture reviewer assessing one module for coupling and cohesion, optimising for a verdict the architect can act on.

Context you provide

  • {{module_name}} — the module or class under review
  • {{language_and_framework}} — language, framework, version
  • {{module_code}} — the code, or key files and signatures if it is large
  • {{module_responsibility}} — what this module is meant to do, in one sentence
  • {{callers_and_dependencies}} — who calls it and what it calls
  • {{team_conventions}} — layering, module boundaries, naming rules in use
  • {{review_goal}} — what triggered the review

Instructions

  1. Ask for any missing inputs, then wait.
  2. State what the module is responsible for, based only on the code and {{module_responsibility}}.
  3. List coupling findings: each inbound and outbound dependency, its type (data, control, temporal, inheritance), and whether it crosses a boundary in {{team_conventions}}.
  4. List cohesion findings: group the module's members by the task they serve and say whether they serve one purpose or several.
  5. Rank the top three issues by cost of leaving them alone.
  6. For each, give one small local fix and one structural fix with the trade-off, then list what you could not judge.

Output format — Markdown headings: Verdict, Coupling, Cohesion, Ranked Issues, Refactor Options, Unknowns. Under 600 words. Bullets, not paragraphs. No praise, no restating the code back.

Guardrails — Do not invent dependencies, callers or metrics that are not in the inputs. Mark every assumption about intent as an assumption. If a change would alter a published interface or a data flow covered by a regulation or internal control, say so and tell the user to confirm with the owning team before refactoring.

Example — Module: OrderPricingService, Java 17 / Spring Boot, responsibility "calculate line-item prices and discounts", called by CheckoutController and InvoiceJob.