SDD Cross-Layer Proposal (/sdd-layer-edit)

Output language: All output mirrors the language of the invoking prompt. Vietnamese prompt → Vietnamese output; English prompt → English output. Canonical tokens (PENDING HUMAN REVIEW, APPROVED), @ears references, file paths, and CLI commands are language-invariant.

Dùng để chuẩn bị bounded cross-layer change proposal xuyên Clean Architecture, giữ contract: interface gọi usecase; usecase phụ thuộc domain và port; infra triển khai port. Skill này chỉ đề xuất, không tự thực thi: nó không sửa src/, không cấp execution grant, không thay thế /add-execute và không phải shortcut để bỏ qua TASKS.md, Shadow Plan, Action Record hoặc material checkpoint.

Khi nào dùng / không dùng

• Dùng khi: feature đã có SPEC.md, PLAN.md, TASKS.md và cần map bounded cross-layer change qua nhiều layer trước khi task được dispatch.
• Không dùng khi: cần sửa source ngay (route /add-execute --feature=<slug> --task=<T00X>), requirement/contract thay đổi (dùng /sdd-update), hoặc cần đổi governance (dùng /sdd-agents-edit, /sdd-claude-edit hoặc /sdd-rfc).

Architecture Profile gate (BLOCKING)

Tuân thủ Architecture Profile Protocol.

• Đọc profile, constraint, feature SPEC.md, PLAN.md, TASKS.md và review block trước khi lập proposal.
• Domain/usecase có thể được plan bằng core-only TypeScript. Interface/infra chỉ được đề xuất adapter khi HTTP framework, validation, database hoặc ORM/query layer tương ứng đã selected, evidenced và APPROVED.
• Thiếu binding, exact test/build/lint command hoặc Human Final Review: dừng, lưu PENDING HUMAN REVIEW. Không sinh controller, repository, migration, DTO decorator, cache client hoặc command suy đoán.
• Xuất Shadow Plan gồm profile evidence, file scope, exact command và risk; proposal ở PENDING HUMAN REVIEW cho tới khi Human reviewer có thẩm quyền APPROVED execution scope.

Tham số

• --feature=<feature-slug>: Feature chứa Spec tương ứng.
• --action=<add|modify|refactor>: Loại thay đổi.
• --target=<name>: Usecase hoặc Entity mục tiêu, ví dụ CreateOrder.

Layer boundary

1. Domain (src/domain/): Entity, Value Object hoặc Domain Event thuần TypeScript; không import third-party package hoặc adapter.
2. Usecase (src/usecase/): Interactor/Application Service và port cho repository/external service; business method có @ears .sdd/features/{slug}/SPEC.md#REQ-XXX.
3. Interface (src/interface/): Chỉ dùng transport, validation, authentication adapter đã approved; chỉ gọi usecase, không gọi DB/repository trực tiếp.
4. Infra (src/infra/): Triển khai port bằng DB/cache/external client đã approved; cấm hardcode API key/password, raw DELETE không WHERE và thao tác trái safety constraint.

AI Recommendation và Human Final Review

Skill này chỉ tạo canonical recommendation từ .claude/skills/_shared/ai-review-protocol.md, gồm requirement, boundary, file, risk, alternative và verification, lưu trong feature artifact/review với Human Final Review.Status: PENDING. Human reviewer có thẩm quyền APPROVED proposal và execution scope. Skill không tự sửa src/, không cấp grant và không tự approve; phần write chỉ chạy trong /add-execute với task grant hợp lệ, nơi Action Record được persist.

Hướng dẫn sử dụng

• Khi dùng: Chuẩn bị bounded cross-layer proposal từ locked Spec/Plan/Tasks; không phải write path.
• Không dùng: Không dùng để independently execute or edit source, bypass TASKS/Shadow Plan, cấp grant, hoặc thay /add-execute.
• Input: --feature, --action=add|modify|refactor, --target; reject unapproved adapter/package/command and direct write requests.
• Điều kiện trước: Reviews, Feature Lock, profile bindings and exact command are readable; proposal recommendation remains PENDING HUMAN REVIEW.
• Evidence: Canonical recommendation, Shadow Plan, layer/file boundary, profile evidence, risk and exact verification proposal.
• Dừng khi: Missing binding/command/review, scope crosses locked boundary, contract owner absent, or material checkpoint is not approved.
• Human quyết định: Human approves proposal and task scope; actual writes happen only in /add-execute under a matching approved task grant.
• Lệnh tiếp theo: /add-execute --feature=<feature-slug> --task=<T00X> using the approved task and persisted Follow-up; never run layer-edit as executor.
• Ví dụ: /sdd-layer-edit --feature=feat-orders --action=modify --target=CreateOrder prepares proposal only.

Completion output

Dùng Completion output contract. Nêu requirement, layer/file boundary, profile binding, Shadow Plan, exact command, checkpoint/review state và proposed evidence; skill này không có changed-source evidence vì không ghi file. Kết quả là Human decision required cho review target đã persist, và Lệnh tiếp theo là /add-execute --feature=<feature-slug> --task=<T00X> sau approval. Binding/exact command/review thiếu là BLOCKED; không sinh controller, repository, migration, decorator, cache client hoặc command adapter-specific.