docs(rules): 阶段 1 · PR 1/3 — R0 元原则 + PM 工具彻底占位化#17
资深架构审视发现 P0 问题:脚手架承诺「通用 AI Agent 协作框架」,实际深度绑定 Java/Spring/TAPD。
本 PR 是阶段 1 三连 PR 的第一步,解决两件事:
rules/meta-principles.md
把 5 条元原则独立成"框架宪法",技术栈无关:
@Disabled
skip
每条原则都有:硬约束 / 反模式信号 / 适用范围。元原则与反模式互为镜像(附录对照表)。
避免元原则被重复定义导致漂移:
rules/git-conventions.md
<PM-Tool>
rules/project-architecture.md
<Chat-Tool>
rules/requirement-expansion.md
.codebuddy/README.md
tapd
.codebuddy/README.md 的规则索引把 R0 放在第一行(和其他规则并列展示),强调:
LESSONS 保留浓缩摘要,避免维护两份同样内容。
规则层 (rules/ + governance/主体) 未占位化的 TAPD:0 处 (唯一保留:git-conventions.md §2.6 里 Refs 示例对照 TAPD#1234567 / JIRA-1234 / LIN-456 —— 这是作为占位符示例展示 不同 PM 工具的具体形态,属于教学用途)
7 files changed, 289 insertions(+), 90 deletions(-) 新增: rules/meta-principles.md (228 行)
read_lints
backend-development.md
backend-core.md
.archived/backend-java-spring.md
frontend-development.md
<CI-Platform>
.project.json
为什么做这个
资深架构审视发现 P0 问题:脚手架承诺「通用 AI Agent 协作框架」,实际深度绑定 Java/Spring/TAPD。
本 PR 是阶段 1 三连 PR 的第一步,解决两件事:
做了什么
1. 新增
rules/meta-principles.md(R0,alwaysApply: true)把 5 条元原则独立成"框架宪法",技术栈无关:
@Disabled/skip占位每条原则都有:硬约束 / 反模式信号 / 适用范围。元原则与反模式互为镜像(附录对照表)。
2. testing-standards.md 去重
避免元原则被重复定义导致漂移:
3. PM 工具占位化(R0 原则 4 落地)
rules/git-conventions.md<PM-Tool>,分支号/Refs/Tag/工作流rules/project-architecture.md<PM-Tool>/<Chat-Tool>rules/requirement-expansion.md<PM-Tool>,Javis → 需求对接人.codebuddy/README.md<PM-Tool>,tapdskill 标注为「参考实现,可整体替换」4. 规则索引表新增 R0 行
.codebuddy/README.md的规则索引把 R0 放在第一行(和其他规则并列展示),强调:5. LESSONS.md §一 指向 meta-principles 作为权威定义
LESSONS 保留浓缩摘要,避免维护两份同样内容。
抽象化自检
改动统计
自举验证
read_lints0 错误下一步(阶段 1 后续)
backend-development.md拆层 —— 抽出backend-core.md(分层/API/异常/幂等/事务,技术栈无关),原文归档到.archived/backend-java-spring.md作为 Java 参考实现frontend-development.md同模式拆层 + governance/skills 描述适配 + 元原则引用补齐通用性声明
<PM-Tool><Chat-Tool><CI-Platform>均已在 governance/tooling-landscape.md §一 登记.project.json中的实际工具凭证,规则层一行不用改