Coding Trade-offs

Use this skill when the feature is already understood, but the work still has meaningful gray areas in UX, behavior, composition, or implementation strategy.

Its job is not to rediscover the product idea or do broad planning. Its job is to help the user make smart local decisions that materially change the result, then write those decisions down so future chats and agents do not have to reopen them.

Goal

Resolve high-leverage UX and implementation trade-offs inside a bounded scope and produce an ADR-style decision artifact that downstream work can trust.

Typical output:

• an ADR-style decision record under docs/<task-slug>/decisions/
• a reusable trade-off record when the repo uses different naming
• another equivalent artifact requested by the user

Inputs