@scemoon/cdh 1.0.4 → 1.0.5

package/ai-dlc-skill/SKILL.md

@@ -52,7 +52,7 @@ metadata:
 | WXA | WeChat Mini | `apps/wxa/` | `WXA-FR-NNN` |
 | MYA | Alipay Mini | `apps/mya/` | `MYA-FR-NNN` |
 | TTA | TikTok Mini | `apps/tta/` | `TTA-FR-NNN` |
-| INT | Contracts | `contracts/`, `packages/shared/` | `INT-FR-NNN` |
+| INT | Contracts | `aidlc/contracts/`, `aidlc/packages/shared/` | `INT-FR-NNN` |
 
 ## Adaptive Flow
 
@@ -60,9 +60,11 @@ See `core/adaptive-flow.md` for complexity assessment.
 
 1. Analyze intent → determine complexity (L1-L5)
 2. Select phases to execute
-3. Delegate each phase via `Task(agent_type="general", prompt=...)` using the phase's `prompt.md`
+3. Delegate each phase via `Spawn(agent_type="general", prompt=...)` using the phase's `prompt.md`
 4. Collect results, enforce gates, iterate or advance
 
+```
+
 ## Phase Reference
 
 | Phase | Lifecycle | Rules | Practices |

package/ai-dlc-skill/agents/master.md

@@ -10,6 +10,12 @@
 4. **收集结果**：检查每个 phase 的 Gate 是否通过
 5. **Human Gate**：关键决策点（breaking change、production deploy）暂停等待用户确认
 
+## ⚠️ 角色边界（重要）
+
+- **你（主 Agent）负责所有规划**：分析复杂度、创建 TODO、判断直行还是 Spawn
+- **子 Agent 是叶子节点**：只做实现，不可嵌套
+- **禁止**：把"分析复杂度"或"判断是否 Spawn"的逻辑下放给子 Agent
+
 ## 复杂度判断
 
 见 `core/adaptive-flow.md`。

package/ai-dlc-skill/agents/plan-agent.md

@@ -11,8 +11,8 @@
 
 ## 关键产出
 
-1. Design Doc → `openspec/changes/{id}/design.md`
-2. Task DAG → `openspec/changes/{id}/task-list.md`
+1. Design Doc → `aidlc/openspec/changes/{id}/design.md`
+2. Task DAG → `aidlc/openspec/changes/{id}/task-list.md`
 3. Test Plan → embedded in task-list
 4. Contract Plan → `contract-diff.md` 占位
 

package/ai-dlc-skill/agents/understand-agent.md

@@ -11,11 +11,11 @@
 
 ## 关键产出
 
-1. Intent 捕获 → `requirements.md`
-2. Spec Delta (EARS) → `openspec/changes/{id}/spec-delta.md`
+1. Intent 捕获 → `aidlc/requirements.md`
+2. Spec Delta (EARS) → `aidlc/openspec/changes/{id}/spec-delta.md`
 3. BDD Feature 文件 → `apps/{component}/features/`
-4. 跨组件 Feature 文件 → `features/cross-stack/`（如适用）
-5. 合约文件 → `contracts/{api,events}/`（跨组件时）
+4. 跨组件 Feature 文件 → `aidlc/features/cross-stack/`（如适用）
+5. 合约文件 → `aidlc/contracts/{api,events}/`（跨组件时）
 
 ## 约束
 

package/ai-dlc-skill/agents/verify-agent.md

@@ -16,7 +16,7 @@
 3. BDD step defs → `apps/{component}/features/steps/`
 4. 合约测试 → `tests/contract/`
 5. 跨组件 e2e → `tests/cross-stack/`
-6. Contract Diff → `openspec/changes/{id}/contract-diff.md`
+6. Contract Diff → `aidlc/openspec/changes/{id}/contract-diff.md`
 
 ## 质量门禁
 

package/ai-dlc-skill/architecture/project-structure.md

@@ -12,27 +12,27 @@
 │   ├── wxa/             # WXA-FR-*      WeChat Mini Program (Vant Weapp/JavaScript)
 │   ├── mya/             # MYA-FR-*      Alipay Mini Program (Ant Design Mini/JavaScript)
 │   └── tta/             # TTA-FR-*      TikTok Mini Program (TypeScript)
-├── contracts/           # INT-FR-*      OpenAPI / AsyncAPI / Runtime Contract
+├── aidlc/contracts/           # INT-FR-*      OpenAPI / AsyncAPI / Runtime Contract
 │   ├── api/
 │   ├── events/
 │   └── functions/
-├── packages/shared/     # INT-FR-*      从 contracts 生成的共享类型
-├── features/            # BDD feature 文件
+├── aidlc/packages/shared/     # INT-FR-*      从 contracts 生成的共享类型
+├── aidlc/features/            # BDD feature 文件
 │   └── cross-stack/     # 跨组件集成场景
-├── tests/
+├── aidlc/tests/
 │   ├── contract/        # 合约测试 (INT-FR 级别, provider-agnostic)
 │   └── cross-stack/     # 跨组件 e2e 测试 (对 STACK_URL 运行)
-├── openspec/            # AI-DLC 生命周期产出物
+├── aidlc/openspec/            # AI-DLC 生命周期产出物
 │   └── changes/{id}/
 │       ├── spec-delta.md
 │       ├── design.md
 │       ├── task-list.md
 │       ├── contract-diff.md
 │       └── walkthrough.md
-├── providers/           # 云平台部署配置
+├── aidlc/providers/           # 云平台部署配置
 │   ├── tcb/
 │   └── aliyun/
-├── tools/               # 脚手架脚本
+├── aidlc/tools/               # 脚手架脚本
 │   ├── generate_shared.py
 │   └── contract_diff.py
 ├── .opencode/           # OpenCode 配置
@@ -41,7 +41,7 @@
 │   ├── config.yaml
 │   ├── state.json
 │   └── SKILL.md
-└── AI-DLC-CONTEXT.md    # Brownfield 上下文摘要 (自动生成)
+└── aidlc/AI-DLC-CONTEXT.md    # Brownfield 上下文摘要 (自动生成)
 ```
 
 ## 组件内部结构 (标准模板)
@@ -74,5 +74,5 @@ apps/{component}/
 | WXA-FR-NNN | `apps/wxa/` | `apps/wxa/tests/` | BACKEND_URL |
 | MYA-FR-NNN | `apps/mya/` | `apps/mya/tests/` | BACKEND_URL |
 | TTA-FR-NNN | `apps/tta/` | `apps/tta/tests/` | BACKEND_URL |
-| INT-FR-NNN | `contracts/` + `packages/shared/` | `tests/contract/` | generated types |
-| 跨组件 | `features/cross-stack/` | `tests/cross-stack/` | STACK_URL |
+| INT-FR-NNN | `aidlc/contracts/` + `aidlc/packages/shared/` | `aidlc/tests/contract/` | generated types |
+| 跨组件 | `aidlc/features/cross-stack/` | `aidlc/tests/cross-stack/` | STACK_URL |

package/ai-dlc-skill/brownfield/README.md

@@ -5,7 +5,7 @@
 ## 使用方式
 
 ```bash
-# 一键生成 AI-DLC-CONTEXT.md
+# 一键生成 aidlc/AI-DLC-CONTEXT.md
 ./brownfield/generate-context.sh
 
 # 单独步骤
@@ -16,7 +16,7 @@
 
 ## 产出
 
-`AI-DLC-CONTEXT.md` 文件包含：
+`aidlc/AI-DLC-CONTEXT.md` 文件包含：
 1. 发现的组件列表 + 技术栈
 2. API 端点摘要
 3. 跨组件依赖 Mermaid 图

package/ai-dlc-skill/brownfield/generate-context.sh

@@ -4,7 +4,7 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-OUTPUT="$PROJECT_ROOT/AI-DLC-CONTEXT.md"
+OUTPUT="$PROJECT_ROOT/aidlc/AI-DLC-CONTEXT.md"
 
 echo "# AI-DLC Context — $(basename "$PROJECT_ROOT")"
 echo ""
@@ -29,8 +29,8 @@ echo ""
 # 2. API surface
 echo "## API Surface"
 echo ""
-if [ -d "$PROJECT_ROOT/contracts/api" ]; then
-  find "$PROJECT_ROOT/contracts/api" -name "*.yaml" -o -name "*.yml" | while read -r f; do
+if [ -d "$PROJECT_ROOT/aidlc/contracts/api" ]; then
+  find "$PROJECT_ROOT/aidlc/contracts/api" -name "*.yaml" -o -name "*.yml" | while read -r f; do
     echo "- $(basename "$f")"
   done
 else

package/ai-dlc-skill/brownfield/scripts/extract-api.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# extract-api.sh — Extract API surface from contracts/ directory
+# extract-api.sh — Extract API surface from aidlc/contracts/ directory
 set -euo pipefail
 
 PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
@@ -7,13 +7,13 @@ PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
 echo "# API Surface"
 echo ""
 
-if [ ! -d "$PROJECT_ROOT/contracts" ]; then
-  echo "(No contracts/ directory found)"
+if [ ! -d "$PROJECT_ROOT/aidlc/contracts" ]; then
+  echo "(No aidlc/contracts/ directory found)"
   exit 0
 fi
 
 # OpenAPI
-for f in "$PROJECT_ROOT"/contracts/api/*.yaml "$PROJECT_ROOT"/contracts/api/*.yml; do
+for f in "$PROJECT_ROOT"/aidlc/contracts/api/*.yaml "$PROJECT_ROOT"/aidlc/contracts/api/*.yml; do
   [ -f "$f" ] || continue
   echo "## File: $(basename "$f")"
   python3 -c "
@@ -31,7 +31,7 @@ if 'info' in d:
 done
 
 # AsyncAPI
-for f in "$PROJECT_ROOT"/contracts/events/*.yaml "$PROJECT_ROOT"/contracts/events/*.yml; do
+for f in "$PROJECT_ROOT"/aidlc/contracts/events/*.yaml "$PROJECT_ROOT"/aidlc/contracts/events/*.yml; do
   [ -f "$f" ] || continue
   echo "## File: $(basename "$f")"
   python3 -c "

package/ai-dlc-skill/components/backend.md

@@ -28,7 +28,7 @@
 
 ## 特定约束
 - 后端组件是 Stack 部署的入口点（先部署再暴露 BACKEND_URL）
-- API 合约定义在 `contracts/api/`（OpenAPI 3.1）
+- API 合约定义在 `aidlc/contracts/api/`（OpenAPI 3.1）
 - 依赖注入使用 provider pattern
 - 所有输入必须验证（SEC-002）
 - DB 查询必须使用参数化语句（SEC-003）

package/ai-dlc-skill/components/web.md

@@ -27,5 +27,5 @@
 
 ## 特定约束
 - Web 组件在构建时接收 `BACKEND_URL` 环境变量
-- 使用 `packages/shared/` 中的生成类型
-- API 调用走 `packages/shared/api/`
+- 使用 `aidlc/packages/shared/` 中的生成类型
+- API 调用走 `aidlc/packages/shared/api/`

package/ai-dlc-skill/contracts/README.md

@@ -9,15 +9,15 @@ contracts/
 └── functions/        ← Runtime Contract — Serverless 函数接口 (新增)
 ```
 
-## contracts/api/
+## aidlc/contracts/api/
 HTTP API 描述，使用 OpenAPI 3.1 格式。
 每个文件对应一个 INT-FR-NNN，描述请求/响应 schema。
 
-## contracts/events/
+## aidlc/contracts/events/
 事件驱动合约，使用 AsyncAPI 3.0 + CloudEvents 格式。
 描述事件的生产/消费关系。
 
-## contracts/functions/
+## aidlc/contracts/functions/
 Serverless 函数接口描述，Provider-agnostic。
 描述函数的触发器、资源需求、环境变量。
 部署时根据选择的 provider + compute_mode 自动映射到具体平台。

package/ai-dlc-skill/cross-tool/cline/export.sh

@@ -15,7 +15,7 @@ AI-DLC: Intent → Spec (EARS) → BDD → Design → TDD → Deploy
 ## FR Namespaces
 NATIVE apps/native | DESKTOP apps/desktop | WEB apps/web
 BE apps/backend | WXA apps/wxa | MYA apps/mya | TTA apps/tta
-INT contracts/ + packages/shared/
+INT aidlc/contracts/ + aidlc/packages/shared/
 
 ## Quality Gates
 - Coverage >= 80%

package/ai-dlc-skill/cross-tool/copilot/export.sh

@@ -26,7 +26,7 @@ Follow the AI-Driven Development Lifecycle:
 - WXA-FR-* → apps/wxa/
 - MYA-FR-* → apps/mya/
 - TTA-FR-* → apps/tta/
-- INT-FR-* → contracts/ + packages/shared/
+- INT-FR-* → aidlc/contracts/ + aidlc/packages/shared/
 
 ## Quality Gates
 - Coverage ≥80%

package/ai-dlc-skill/cross-tool/onecode/export-skills.sh

@@ -2,9 +2,13 @@
 # export-skills.sh — Generate per-component .skill/SKILL.md from components/*.md
 set -euo pipefail
 
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-SKILL_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
-PROJECT_ROOT="$(cd "$SKILL_DIR/.." && pwd)"
+PROJECT_ROOT="${1:-$PWD}"
+SKILL_DIR="${2:-${AI_DLC_SKILL_DIR:-$HOME/.cdh/skills/ai-dlc-skill}}"
+
+if [ ! -d "$SKILL_DIR" ]; then
+  echo "  ✗ ai-dlc-skill not found at $SKILL_DIR" >&2
+  exit 1
+fi
 
 echo "Generating component skills in $PROJECT_ROOT/apps/*/.skill/"
 

package/ai-dlc-skill/cross-tool/onecode/export.sh

@@ -2,21 +2,27 @@
 # onecode/export.sh — Export AI-DLC rules to onecode format
 set -euo pipefail
 
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-# ai-dlc-skill root: onecode/.. → cross-tool/.. → ai-dlc-skill
-SKILL_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
-# project root: ai-dlc-skill → skills → .opencode → project
-PROJECT_ROOT="$(cd "$SKILL_DIR/.." && pwd)"
+# Project root: first arg or current working directory
+PROJECT_ROOT="${1:-$PWD}"
+# Skill dir: CDH platform skill pool or AI_DLC_SKILL_DIR env var
+SKILL_DIR="${AI_DLC_SKILL_DIR:-$HOME/.cdh/skills/ai-dlc-skill}"
+
+if [ ! -d "$SKILL_DIR" ]; then
+  echo "  ✗ ai-dlc-skill not found at $SKILL_DIR" >&2
+  echo "  Run: cdh skill install ai-dlc-skill" >&2
+  exit 1
+fi
 
-echo "  Exporting onecode configs..."
+echo "  Exporting onecode configs for project: $(basename "$PROJECT_ROOT")"
 
 CDH_DIR="$PROJECT_ROOT/.cdh"
+CROSS_TOOL_DIR="$SKILL_DIR/cross-tool/onecode"
 
 # 1. Generate .cdh/config.yaml if not exists
 if [ ! -f "$CDH_DIR/config.yaml" ]; then
   mkdir -p "$CDH_DIR"
   sed "s/{{project_name}}/$(basename "$PROJECT_ROOT")/g; s/{{cloud_provider}}/tcb/g; s/{{current_phase}}/understand/g; s/{{compute_mode}}/cloudbase-functions/g" \
-    "$SCRIPT_DIR/config.yaml.tpl" > "$CDH_DIR/config.yaml"
+    "$CROSS_TOOL_DIR/config.yaml.tpl" > "$CDH_DIR/config.yaml"
   echo "  ✓ $CDH_DIR/config.yaml created"
 else
   echo "  - $CDH_DIR/config.yaml exists, skipping"
@@ -43,6 +49,6 @@ cp "$SKILL_DIR/SKILL.md" "$CDH_DIR/SKILL.md"
 echo "  ✓ $CDH_DIR/SKILL.md updated"
 
 # 4. Generate component skills into apps/*/.skill/
-bash "$SCRIPT_DIR/export-skills.sh"
+bash "$CROSS_TOOL_DIR/export-skills.sh" "$PROJECT_ROOT" "$SKILL_DIR"
 
 echo "  onecode export complete."

package/ai-dlc-skill/phases/deliver/lifecycle.md

@@ -103,8 +103,8 @@ pytest apps/tta/tests/e2e/ --backend-url $BACKEND_URL
 ## Cross-Stack E2E
 
 ```bash
-pytest tests/cross-stack/ --stack-url $STACK_URL --verbose
-# Runs the full multi-client ↔ backend flow defined in features/cross-stack/
+pytest aidlc/tests/cross-stack/ --stack-url $STACK_URL --verbose
+# Runs the full multi-client ↔ backend flow defined in aidlc/features/cross-stack/
 ```
 
 **Rule STK-001:** All `cross-stack` scenarios must pass before staging or production.
@@ -114,7 +114,7 @@ pytest tests/cross-stack/ --stack-url $STACK_URL --verbose
 ```bash
 deploy_stack --env staging
 export STAGING_URL=$(deploy_stack --env staging --output url)
-pytest tests/cross-stack/ --stack-url $STAGING_URL
+pytest aidlc/tests/cross-stack/ --stack-url $STAGING_URL
 smoke-test $STAGING_URL
 ```
 
@@ -158,7 +158,7 @@ deploy_stack --rollback ${LAST_STABLE_STACK_VERSION}
 deploy_stack --rollback --stack-version v1.2.3
 ```
 
-The previous stable stack version is identified by the `contracts/CHANGELOG.md` version at the time of the last green BVT.
+The previous stable stack version is identified by the `aidlc/contracts/CHANGELOG.md` version at the time of the last green BVT.
 
 ## Artifacts
 
@@ -167,7 +167,7 @@ The previous stable stack version is identified by the `contracts/CHANGELOG.md`
 | `STACK_URL` / `BACKEND_URL` | Dynamic, per-platform, per-env |
 | Per-component e2e report | Scenario pass/fail per component |
 | Cross-stack e2e report | Full flow pass/fail |
-| `openspec/changes/{id}/contract-diff.md` | Final contract change record |
+| `aidlc/openspec/changes/{id}/contract-diff.md` | Final contract change record |
 | BVT report | Stack-level health check results |
 | Deploy log | Stack version, timestamp, component versions |
 
@@ -182,4 +182,4 @@ The previous stable stack version is identified by the `contracts/CHANGELOG.md`
 - [ ] Production stack deploy succeeded
 - [ ] Stack BVT passed
 - [ ] (If BVT failed) Stack rollback executed and confirmed
-- [ ] `openspec/changes/{id}/contract-diff.md` archived
+- [ ] `aidlc/openspec/changes/{id}/contract-diff.md` archived

package/ai-dlc-skill/phases/deliver/prompt.md

@@ -4,7 +4,7 @@
 由 Master Agent 委派处理部署交付。
 
 ## 输入
-- `openspec/changes/{id}/contract-diff.md`
+- `aidlc/openspec/changes/{id}/contract-diff.md`
 - 所有 e2e 测试报告
 
 ## 任务
@@ -18,7 +18,7 @@
    - 使用动态解析的 URL
 
 3. **Cross-Stack e2e**
-   - `pytest tests/cross-stack/ --stack-url ${STACK_URL}`
+   - `pytest aidlc/tests/cross-stack/ --stack-url ${STACK_URL}`
 
 4. **Staging Deploy + Smoke**
    - `deploy_stack --env staging`

package/ai-dlc-skill/phases/deliver/rules.md

@@ -3,7 +3,7 @@
 ## DLV-001: Unified Stack Preview Before Production
 **Severity:** MUST
 **Description:** Every release MUST deploy as unified stack preview with per-component e2e + cross-stack e2e passing before production.
-**Valid:** `deploy_stack --preview` → `pytest tests/cross-stack/ --stack-url $STACK_URL`.
+**Valid:** `deploy_stack --preview` → `pytest aidlc/tests/cross-stack/ --stack-url $STACK_URL`.
 **Invalid:** Deploying only one component to preview.
 
 ## DLV-002: Production Approval Gate

package/ai-dlc-skill/phases/plan/lifecycle.md

@@ -52,27 +52,27 @@ A multi-component design doc is organized by **component sections** plus an **in
 ### Component: web (WEB-FR-*)
 - Architecture: {{SPA / SSR}}
 - Routes: {{...}}
-- Data flow: {{uses packages/shared generated from INT-FR-001}}
+- Data flow: {{uses aidlc/packages/shared generated from INT-FR-001}}
 
 ### Component: native (NATIVE-FR-*)
 - Architecture: {{native architecture}}
-- Data flow: {{uses packages/shared generated from INT-FR-*}}
+- Data flow: {{uses aidlc/packages/shared generated from INT-FR-*}}
 
 ### Component: desktop (DESKTOP-FR-*)
 - Architecture: {{desktop architecture}}
-- Data flow: {{uses packages/shared generated from INT-FR-*}}
+- Data flow: {{uses aidlc/packages/shared generated from INT-FR-*}}
 
 ### Component: wxa (WXA-FR-*)
 - Architecture: {{WeChat Mini Program}}
-- Data flow: {{uses packages/shared generated from INT-FR-*}}
+- Data flow: {{uses aidlc/packages/shared generated from INT-FR-*}}
 
 ### Component: mya (MYA-FR-*)
 - Architecture: {{Mini Program}}
-- Data flow: {{uses packages/shared generated from INT-FR-*}}
+- Data flow: {{uses aidlc/packages/shared generated from INT-FR-*}}
 
 ### Component: tta (TTA-FR-*)
 - Architecture: {{TikTok Mini Program}}
-- Data flow: {{uses packages/shared generated from INT-FR-*}}
+- Data flow: {{uses aidlc/packages/shared generated from INT-FR-*}}
 
 ### Integration
 - Flow: {{web → backend → DB; or app → backend → event → ...}}
@@ -130,7 +130,7 @@ units:
     fr: INT-FR-001
     affects: [contracts]
     depends_on: []
-    deliverables: [contracts/api/auth.yaml]
+    deliverables: [aidlc/contracts/api/auth.yaml]
   - id: be-unit-1
     fr: BE-FR-001
     affects: [backend]
@@ -180,7 +180,7 @@ Test cases:
 
 For each contract change, list:
 - Old version, new version
-- Breaking? (yes / no) → if yes, plan migration in `contracts/CHANGELOG.md`
+- Breaking? (yes / no) → if yes, plan migration in `aidlc/contracts/CHANGELOG.md`
 - Consumers affected (which components will pull the new shared types)
 - Backward-compat strategy (additive vs. deprecate-then-remove)
 
@@ -188,10 +188,10 @@ For each contract change, list:
 
 | Artifact | Location | Purpose |
 |----------|----------|---------|
-| Design doc | `openspec/changes/{id}/design.md` | Per-component + integration |
-| Task list | `openspec/changes/{id}/task-list.md` | DAG with cross-component edges |
+| Design doc | `aidlc/openspec/changes/{id}/design.md` | Per-component + integration |
+| Task list | `aidlc/openspec/changes/{id}/task-list.md` | DAG with cross-component edges |
 | Test plan | Embedded in task-list or separate | Per-scenario, per-layer |
-| Contract plan | `openspec/changes/{id}/contract-diff.md` placeholder | Filled in Verify |
+| Contract plan | `aidlc/openspec/changes/{id}/contract-diff.md` placeholder | Filled in Verify |
 
 ## Gate
 

package/ai-dlc-skill/phases/plan/prompt.md

@@ -4,18 +4,18 @@
 由 Master Agent 委派处理方案设计。
 
 ## 输入
-- `openspec/changes/{id}/spec-delta.md`
+- `aidlc/openspec/changes/{id}/spec-delta.md`
 - BDD feature 文件
 
 ## 任务
 
 1. **SDD: Design Doc**
-   - 在 `openspec/changes/{id}/design.md` 输出
+   - 在 `aidlc/openspec/changes/{id}/design.md` 输出
    - 包含：架构图（Mermaid）、数据模型、API 表、状态机
    - 每组件独立 section + 集成 section
 
 2. **SDD: Task Decomposition**
-   - 在 `openspec/changes/{id}/task-list.md` 输出
+   - 在 `aidlc/openspec/changes/{id}/task-list.md` 输出
    - YAML 格式，unit 带 `depends_on` DAG
    - 跨组件 task 显示声明 `depends_on` 关系
 
@@ -28,9 +28,9 @@
    - 如需 breaking change 标记为 human-approval 阻塞
 
 ## 输出产物
-- `openspec/changes/{id}/design.md`
-- `openspec/changes/{id}/task-list.md`
-- `openspec/changes/{id}/contract-diff.md`（占位）
+- `aidlc/openspec/changes/{id}/design.md`
+- `aidlc/openspec/changes/{id}/task-list.md`
+- `aidlc/openspec/changes/{id}/contract-diff.md`（占位）
 
 ## 约束
 - 遵守 `rules.md` 中的 PLN-001 到 PLN-004

package/ai-dlc-skill/phases/plan/rules.md

@@ -3,7 +3,7 @@
 ## PLN-001: Design Documentation
 **Severity:** MUST
 **Description:** Each feature MUST have a design document covering architecture, data model, API contracts, and state machine. For multi-component features, MUST have per-component sections and an integration section.
-**Valid:** `openspec/changes/{id}/design.md` with `## Component: backend`, `## Component: web`, `## Integration`.
+**Valid:** `aidlc/openspec/changes/{id}/design.md` with `## Component: backend`, `## Component: web`, `## Integration`.
 **Invalid:** A single flat architecture section with no per-component concerns.
 
 ## PLN-002: Dependency DAG

package/ai-dlc-skill/phases/understand/entry.md

@@ -23,4 +23,4 @@ See `prompt.md` for the sub-agent delegation prompt template.
 1. 读取 intent 输入
 2. 按 SDD 方法生成 spec-delta（EARS 格式）
 3. 为每个 FR 写 BDD feature 文件（≥3 scenarios: positive, negative, edge）
-4. 输出到 `openspec/changes/{id}/`
+4. 输出到 `aidlc/openspec/changes/{id}/`

package/ai-dlc-skill/phases/understand/lifecycle.md

@@ -23,7 +23,7 @@ SDD: Spec Delta (EARS format — ADDED/MODIFIED/REMOVED, FR namespaces)
   ▼
 BDD: Feature Files
   - features/{component}/{domain}/{feature}.feature   (per-component)
-  - features/cross-stack/{domain}/{feature}.feature   (full flow, if applies)
+  - aidlc/features/cross-stack/{domain}/{feature}.feature   (full flow, if applies)
   │
   ▼
 Gate: Human review → approved or revise
@@ -167,11 +167,11 @@ Feature: Cross-stack login flow
 
 | Artifact | Location | Purpose |
 |----------|----------|---------|
-| Intent | `requirements.md` | Business need + `affects` |
-| Spec delta | `openspec/changes/{id}/spec-delta.md` | EARS, FR namespaces, `affects` |
+| Intent | `aidlc/requirements.md` | Business need + `affects` |
+| Spec delta | `aidlc/openspec/changes/{id}/spec-delta.md` | EARS, FR namespaces, `affects` |
 | Per-component BDD | `apps/{component}/features/{domain}/{feature}.feature` | Component behavior |
-| Cross-stack BDD | `features/cross-stack/{domain}/{feature}.feature` | End-to-end flow |
-| Contract spec | `contracts/{api,events}/{name}.{yaml,graphql}` | INT-FR-NNN source of truth |
+| Cross-stack BDD | `aidlc/features/cross-stack/{domain}/{feature}.feature` | End-to-end flow |
+| Contract spec | `aidlc/contracts/{api,events}/{name}.{yaml,graphql}` | INT-FR-NNN source of truth |
 
 ## Gate
 
@@ -179,6 +179,6 @@ Feature: Cross-stack login flow
 - [ ] `affects: [...]` declared in spec-delta
 - [ ] Spec delta uses EARS format
 - [ ] Per-component FRs: each tagged `@FR-{PREFIX}-NNN` (e.g. `@NATIVE-`, `@DESKTOP-`, `@WEB-`, `@BE-`, `@WXA-`, `@MYA-`, `@TTA-`), ≥3 scenarios (positive/negative/edge)
-- [ ] If `affects` includes ≥2 components: at least one `INT-FR-NNN` and a `features/cross-stack/*.feature` with ≥3 scenarios
-- [ ] If `affects` includes contracts: contract file present in `contracts/`
+- [ ] If `affects` includes ≥2 components: at least one `INT-FR-NNN` and a `aidlc/features/cross-stack/*.feature` with ≥3 scenarios
+- [ ] If `affects` includes contracts: contract file present in `aidlc/contracts/`
 - [ ] Human reviewed and approved

package/ai-dlc-skill/phases/understand/prompt.md

@@ -10,30 +10,30 @@
 ## 任务
 
 1. **SDD: Intent Capture**
-   - 在 `requirements.md` 记录 Why / What / Success Criteria / Scope
+   - 在 `aidlc/requirements.md` 记录 Why / What / Success Criteria / Scope
    - 声明 `affects: [native|desktop|web|backend|wxa|mya|tta|contracts]`
 
 2. **SDD: Spec Delta (EARS)**
-   - 在 `openspec/changes/{id}/spec-delta.md` 输出
+   - 在 `aidlc/openspec/changes/{id}/spec-delta.md` 输出
    - 使用 EARS 格式：Ubiquitous / Event-Driven / State-Driven / Unwanted / Optional
    - FR 必须使用命名空间前缀（BE-FR-001, WEB-FR-001 等）
 
 3. **BDD: Feature Files**
    - 每个 FR ≥3 个 scenario（positive / negative / edge）
    - Per-component: `apps/{component}/features/{domain}/{feature}.feature`
-   - Cross-stack: `features/cross-stack/{domain}/{feature}.feature`
+   - Cross-stack: `aidlc/features/cross-stack/{domain}/{feature}.feature`
    - Tag 使用 `@FR-PREFIX-NNN`
 
 4. **Contract First**（跨组件时）
-   - 在 `contracts/{api,events}/` 创建合约文件
+   - 在 `aidlc/contracts/{api,events}/` 创建合约文件
    - 引用 INT-FR-NNN
 
 ## 输出产物
-- `requirements.md`
-- `openspec/changes/{id}/spec-delta.md`
+- `aidlc/requirements.md`
+- `aidlc/openspec/changes/{id}/spec-delta.md`
 - `apps/{component}/features/{domain}/{feature}.feature`
-- `features/cross-stack/{domain}/{feature}.feature`（跨组件时）
-- `contracts/{api,events}/{name}.yaml`（跨组件时）
+- `aidlc/features/cross-stack/{domain}/{feature}.feature`（跨组件时）
+- `aidlc/contracts/{api,events}/{name}.yaml`（跨组件时）
 
 ## 约束
 - 遵守 `rules.md` 中的 UND-001 到 UND-006

package/ai-dlc-skill/phases/understand/rules.md

@@ -3,7 +3,7 @@
 ## UND-001: Intent Documentation
 **Severity:** MUST
 **Description:** Before any specification or implementation, the business intent MUST be documented. Intent includes: what is being built, why, and how success is measured.
-**Valid:** Intent captured in `requirements.md` with `affects: [...]` before spec delta.
+**Valid:** Intent captured in `aidlc/requirements.md` with `affects: [...]` before spec delta.
 **Invalid:** Starting spec delta or feature files without documented intent or without an `affects` declaration.
 
 ## UND-002: EARS Format
@@ -26,12 +26,12 @@
 
 ## UND-005: Cross-Component Feature Decomposition
 **Severity:** MUST
-**Description:** A feature that affects ≥2 components MUST be split into: one FR per component, one or more `INT-*` FRs, and a `features/cross-stack/*.feature` file.
+**Description:** A feature that affects ≥2 components MUST be split into: one FR per component, one or more `INT-*` FRs, and a `aidlc/features/cross-stack/*.feature` file.
 **Valid:** `affects: [web, backend]` → `WEB-FR-001`, `BE-FR-001`, `INT-FR-001`, plus cross-stack feature file.
 **Invalid:** A single feature file claiming to test both web and backend behavior.
 
 ## UND-006: Contract-First for Cross-Component
 **Severity:** MUST
-**Description:** When a feature introduces or changes a public API or event consumed by another component, a contract file MUST be added or updated in `contracts/` before any per-component implementation.
-**Valid:** `contracts/api/auth.yaml` defines `POST /auth/login` before any code.
-**Invalid:** Per-component code that depends on a contract not in `contracts/`.
+**Description:** When a feature introduces or changes a public API or event consumed by another component, a contract file MUST be added or updated in `aidlc/contracts/` before any per-component implementation.
+**Valid:** `aidlc/contracts/api/auth.yaml` defines `POST /auth/login` before any code.
+**Invalid:** Per-component code that depends on a contract not in `aidlc/contracts/`.