vladikk/modularity

解决的问题

本项目提供了一种防止 AI 生成代码库中出现 "大泥球" 架构和技术债务的方法。它超越了简单的代码级反馈，解决了架构上的低效、错误的边界划分以及软件组件间未管理的耦合问题。

工作原理

这是一个为 Claude Code 设计的插件，实现了平衡耦合模型。该模型从三个维度评估软件耦合：集成强度（共享知识量）、距离（演进的社会技术成本）和波动性（变更概率）。

该插件提供两种主要功能：

• /modularity:review：分析现有代码和需求，识别耦合失衡，并提供可操作的改进建议。
• /modularity:design：根据功能需求生成模块化架构，产出设计文档、集成契约和测试规范，并在设计清晰前持续迭代。

适用人群

使用 Claude Code 并希望确保系统保持模块化和可维护性的软件架构师和开发者，尤其适用于处理快速生成的 AI 代码时。

亮点

• 架构导向：聚焦于高层次系统设计，而非逐行代码审查。
• 平衡耦合模型：所有建议均基于明确的类数学规则，而非直觉判断。
• 自动化设计：可从功能需求自动生成完整的模块设计规格和集成契约。
• Claude Code 集成：直接作为插件在 Claude Code 环境中运行。