forensic-organizational-alignment

Analyzes module-to-team maps to detect organizational misalignment and compute alignment scores.

3|2|Updated Oct 27, 2025
One-click install
npx skills add https://github.com/AlabamaMike/forensic-skills --skill forensic-organizational-alignment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forensic-organizational-alignment
Source: https://github.com/AlabamaMike/forensic-skills/tree/main/.claude/skills/forensic-organizational-alignment
Command: npx skills add https://github.com/AlabamaMike/forensic-skills --skill forensic-organizational-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps organizations assess whether code architecture aligns with team boundaries, enabling early detection of Conway's Law violations and guiding reorganization decisions.

Core Features & Use Cases

  • Alignment scoring across modules and teams
  • Identification of misaligned modules and owners
  • Cross-team coupling indicators and integration recommendations
  • Research-backed justification for organizational changes

Quick Start

Run the alignment analysis against your repository to produce a module-to-team map, an overall alignment score, and a prioritized list of misaligned modules with recommendations.

Frequently Asked Questions about forensic-organizational-alignment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect Conway's Law violations in my codebase?

Cross-team coupling occurs when multiple teams share ownership of tightly coupled code modules. This Skill identifies cross-team coupling indicators by scoring alignment between module boundaries and team structures.

What is the best way to score organizational alignment before a team reorganization?

Scoring organizational alignment involves mapping code modules to their respective teams to calculate a quantitative alignment score. This provides research-backed justification to guide team reorganization decisions.

How do I identify misaligned modules during a microservice extraction?

Identify misaligned modules by running an alignment analysis against your repository to produce a prioritized list. This reveals ownership boundaries that contradict your intended microservice architecture.

Can I check organizational health across multiple modules and teams?

Yes, you can perform an organizational health check across multiple modules and teams. The analysis outputs a module-to-team map and actionable integration recommendations to resolve coupling.