alibabacloud-writing-plans

Alibaba Cloud Writing Plans

AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE

This skill converts approved designs into executable Terraform HCL code. It does NOT execute anything. HCL 代码生成 MUST 通过调用 alibabacloud-spec-ops:alibabacloud-terraform-codegen skill 完成，禁止自行内联生成。

---

PREREQUISITE CHECK (internal — do not expose these checks to user)

Before proceeding, verify:

• tasks/status.json exists with status: "designed"
• designs/design.md exists with approved design

If missing, STOP and inform the user that design planning needs to complete first.

---

Triggers

Activate when:

• Planning phase is complete and user wants to generate code
• User explicitly asks for Terraform code generation
• Auto-prompted after alibabacloud-spec-ops:alibabacloud-planning completes

Rules

1. Read design first — Load and understand the design.md before writing code
2. Respect mode — Check tasks/status.json for "mode" field: "fast-track" or "full" (default)
3. Respect change type — Check tasks/status.json for "change_type" field: "modify" means update existing .tf files, not create from scratch
4. Delegate code generation — MUST invoke alibabacloud-spec-ops:alibabacloud-terraform-codegen for HCL generation
5. Never generate HCL inline — Do NOT write Terraform code yourself; always delegate to terraform-codegen
6. Single file output — ALL Terraform code MUST be in a single main.tf file (no splitting)
7. No execution — This skill writes code only, never runs terraform
8. Update status — Set status to "plans-written" when complete (silently)

Modification Mode (change_type: "modify")

When tasks/status.json contains "change_type": "modify":

1. Read existing .tf files first — Load all current Terraform code from designs/terraform/
2. Apply delta only — Modify/add/remove resources as described in the updated design.md; preserve unchanged resources
3. Communicate change scope to terraform-codegen — When invoking the codegen skill, explicitly state:
   • What exists (pass current .tf content)
   • What to change (the specific modifications from design)
   • What to preserve (everything else)
4. Terraform plan will show diff — Downstream validate/execute will naturally show ~ modify and + add instead of all + create