随着项目增长,如何设计 monorepo 结构与工作流以保持 Claude Code 的一致性?
摘要
开发者提出在项目增长过程中如何设计 monorepo 结构与开发工作流,以让 Claude Code 持续遵守架构规则并减少上下文消耗,涵盖指令管理、上下文优化与验证方法等系统性问题。
我正在使用 Claude Code 开发一个项目,随着代码库的增长,我开始遇到一些问题。首先,我不得不一次又一次地向 Claude 重复同样的规则和约束。尽管我已经编写了项目指令,并通过 ADR(架构决策记录)记录了架构决策,但它逐渐开始违反这些规则、走捷径,或者做出与预期架构不一致的改动。其次,我的上下文窗口消耗速度远超我的预期。我怀疑这可能与我的仓库结构以及项目文档和指令的组织方式有关。这让我开始质疑,当前的 monorepo 结构和开发工作流从长远来看是否真的可持续。我希望获得系统性解决问题的建议,而不是继续用更多指令来打补丁。以下几个方面我特别感兴趣:
仓库架构:构建可维护的 monorepo 的最佳实践,包括如何组织模块、定义边界以及防止架构漂移。我读过 DDD(领域驱动设计)和六边形架构,但不确定它们是否适合我。
Agent 指令与强制执行:CLAUDE.md、AGENTS.md、ADR、skills、hooks 和自动化检查应该如何协同工作?哪些规则应该写成文档,哪些应该通过机制强制执行?
上下文管理:如何在不丢失重要架构知识、也不迫使 Claude 重新阅读整个代码库的前提下,减少不必要的上下文消耗?
工作流与方法论:是否存在经过验证的实践、工具或开发工作流,能让 Claude Code 在项目增长时更加可靠?
其他盲点:我的问题诊断是否正确?主要问题会不会出在我委派任务的方式、范围变更、架构决策的管理,或者对 agent 工作成果的验证上,而不是仓库结构本身?
我不一定在寻找某个具体的 skill 或工具推荐(当然也欢迎)。我更希望了解那些有经验的开发者在用 Claude Code 构建大型项目时行之有效的底层原则和实践。如果要从零开始,既要打造一个可长期维护的代码库,又要让 AI 编码 agent 始终如一地遵守架构约束,你会如何着手?
相似文章
@vincemask: https://x.com/vincemask/status/2056757482152960110
一篇关于如何高效组织 Claude Code 项目中 .claude/ 目录的工程化指南,介绍了目标结构、核心原则、各文件夹分工以及渐进式成长路径。
@vincemask: 很多人用 Claude Code,项目里却只有一个 CLAUDE.md。 真正可维护的配置,通常会拆成几层: 1、CLAUDE.md:项目级上下文与规范 2、settings.json:权限、模型与 hooks 3、rules/:按主题拆…
推荐 Claude Code 项目配置的分层方法,将配置拆分为 CLAUDE.md、settings.json、rules/、commands/、skills/、agents/、hooks/ 等层级,以提高可维护性和复用性。
@alin_zone: Claude Code 和 Codex,别再二选一了。 与其纠结用哪个,不如让它俩分工——一个写、一个审,配合起来比单用哪个都顺手。 这期讲我自己的工作流:Claude Code 负责写,Codex 负责审,整套配合大概五步,最后由你拍板。
介绍了一种工作流:使用Claude Code负责编写代码,Codex负责代码审查,两者配合比单独使用更高效,整套流程约五步,最终由开发者决定。
@vincemask: 我靠,原来 CLAUDE.md 还有这么多门道,以前真是白写了。 以前我一直以为「信息越多越好」,于是把项目历史、技术决策、个人偏好,甚至「写干净代码」这种空泛要求,全塞进 CLAUDE.md。 结果就是:Claude 每次都像在几千行上…
作者反思了对CLAUDE.md的常见误解,指出不应堆砌信息,而应压缩判断标准、约束执行边界和沉淀高频规则,以提升Claude Code等代码代理的工作效率。
@nash_su: https://x.com/nash_su/status/2055541927508881654
本文详细介绍了Claude Code在大型代码库中的最佳实践,强调工具链(CLAUDE.md、钩子、技能、插件、LSP集成、MCP服务器和子代理)比模型本身更重要,并建议团队优先投资代码库设置以获得更好效果。