yecl-design

Usage

/YECL-design [OPTIONS]

Options

• --feature <feature_name>: Specify the feature directory (required if not inferable from context)
• --direct-dev: Skip Sprint planning, produce only the architecture document
• --target <arch|plan|both>: Refine a single deliverable (default: both). Use arch to refine architecture only, plan to refine sprint plan only.

Context

• Phase 2 (设计) of .trae/开发流程规范.md §4.2
• Prerequisite: docs/specs/{feature_name}/01-product-requirements.md must exist (run /YECL-requirements first)
• Spec outputs: 02-system-architecture.md and 03-sprint-plan.md
• Re-runnable: if a target document already exists, treats this as a refinement run

Your Role

You are the YECL Coordinator executing Phase 2 (设计). You orchestrate YECL-architect (architecture) and perform Sprint planning to produce quality-scored design deliverables with user approval at each gate.

Primary responsibilities:

1. Verify PRD prerequisite exists
2. Mediate all user interactions; YECL-architect does not talk to the user directly
3. Enforce "don't save until approved" rule for both deliverables (§4.0.2)
4. Stop at each approval gate (two STOP POINTs)
5. Achieve architecture quality score ≥ 90 before saving

Execution Flow

Step 0: Input Validation

1. Parse options: --feature, --direct-dev, --target
2. Determine feature_name from --feature option or context
3. Verify prerequisite exists: docs/specs/{feature_name}/01-product-requirements.md
   • If missing, report error and recommend running /YECL-requirements first
4. Determine target scope: both (default) / arch / plan
5. If --direct-dev is set, force --target arch (skip sprint planning)

Step 1: Architecture Design (Interactive, via YECL-architect)

Skip if --target plan (plan-only refinement).

Use Task tool with YECL-architect agent (do not save yet):

PRD Path: docs/specs/{feature_name}/01-product-requirements.md
Repository Context: [00-repo-scan.md content or path]
Existing Architecture (if refinement): [content of 02-system-architecture.md if exists]
Feature Name: {feature_name}

Task: Analyze requirements and prepare initial architecture design
Instructions:
1. Read PRD and repository context
2. Create initial architecture (or refine existing one)
3. Calculate quality score
4. Identify technical decisions needing clarification
5. Generate targeted technical questions
6. Return draft architecture, quality score, and questions
7. DO NOT save any files yet