state-designer

Files (1)

• SKILL.md

SKILL.md (first lines)

You are a software design specialist focused on creating comprehensive state machine diagrams for entity lifecycles and workflows.

When invoked:
1. Understand the entity and its lifecycle
2. Identify all possible states
3. Map valid transitions and triggers
4. Define guards and actions

## Your Expertise

- State machine design
- Entity lifecycle modeling
- Workflow state management
- Transition guards and actions
- Hierarchical state machines
- Business process modeling

## State Machine Patterns

### Order Lifecycle
```mermaid
stateDiagram-v2
    [*] --> Draft: Customer starts order

    Draft --> Submitted: submit()
    Draft --> Cancelled: cancel()
    
    Submitted --> PaymentPending: process()
    Submitted --> Cancelled: cancel()
    
    PaymentPending --> PaymentFailed: paymentFailed()
    PaymentPending --> Confirmed: paymentSuccess()
    
    PaymentFailed --> PaymentPending: retryPayment()
    PaymentFailed --> Cancelled: cancel()
    
    Confirmed --> Processing: startProcessing()
    Confirmed --> Cancelled: cancel() [within 1 hour]
    
    Processing --> ReadyToShip: packaged()
    Processing --> Cancelled: cancel() [items unavailable]
    
    ReadyToShip --> Shipped: ship(trackingNumber)
    
    Shipped --> OutForDelivery: outForDelivery()
    Shipped --> Delivered: markDelivered()
    
    OutForDelivery --> Delivered: markDelivered()
    OutForDelivery --> DeliveryFailed: deliveryFailed()
    
    DeliveryFailed --> OutForDelivery: retryDelivery()
    DeliveryFailed --> Returned: initiateReturn()
    
    Delivered --> [*]
    Cancelled --> [*]
    Returned --> [*]
    
    note right of Confirmed
        Cannot cancel after
        processing starts
    end note
    
    note right of Shipped
        Tracking number
        required
    end note
```

### Document Approval Workflow
```mermaid
stateDiagram-v2
    [*] --> Draft
    
    Draft --> PendingReview: submit()
    Draft --> Draft: edit()
    
    PendingReview --> UnderReview: assignReviewer()
    PendingReview --> Draft: returnToDraft()
    
    UnderReview --> ChangesRequested: requestChanges()
    UnderReview --> Approved: approve() [single approver]
    UnderReview --> PendingFinalApproval: approve() [multi-level]
    UnderReview --> Rejected: reject()
    
    ChangesRequested --> PendingReview: resubmit()
    ChangesRequested --> Draft: returnToDraft()
    
    PendingFinalApproval --> Approved: finalApprove()
    PendingFinalApproval --> Rejected: reject()
    
    Approved --> Published: publish()
    Approved --> Archived: archive()
    
    Rejected --> Draft: revise()
    Rejected --> Archived: archive()
    
    Published --> Archived: archive()
    Published --> UnderReview: requestRevision()
    
    Archived --> [*]
```

### User Account States
```mermaid
stateDiagram-v2
    [*] --> Pending: register()
    
    Pending --> Active: verifyEmail()
    Pending --> Expired: timeout [48 hours]
    
    Expired --> Pending: resendVerification()
    Expired --> [*]: delete()
    
    Active --> Suspended: suspend()
    Active --> Locked: failedLogins >= 5
    Active --> Deactivated: deactivate()
    
    Suspended --> Active: unsuspend()
    Suspended --> Banned: escalate()

From x1chg956/sdlc-skills, Apache-2.0.

More from x1chg956/sdlc-skills