---
name: configuration-persist-boundary
scope:
  - '*'
products:
  - '*'
id: ka-hard-rule-配置落盘边界规则
type: governance_rule
asset_kind: governance_rule
lifecycle_status: active
authority: canonical
owner_mechanism_id: mc-config-write-boundary
routes:
  - operation
primary_triggers:
  - init
  - sync-templates
  - 配置落盘
secondary_triggers:
  - config.yaml
  - .soloforge
negative_triggers:
  - 只读验证
priority: P1
specificity: 4
consumes:
  - config_write_boundary
hard_blocks:
  - runtime_inference_persisted
  - existing_project_write_without_confirm
fallback: manual_required
required_evidence:
  - config_write_decision
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["*"]
---

# 配置落盘边界规则

运行时推断、已有项目探测和空项目蓝图必须区分处理。

## 硬规则

- 运行时推断结果不得自动写入项目配置。
- 已有项目写入 `.soloforge/`、`.mcp.json`、`CLAUDE.md` 或 adapter 配置时必须有用户确认。
- 空项目初始化可以创建 SoloForge 管理文件。
- 同步模版不得覆盖用户已修改资产。
