ship-design

Present architectural approaches for software features with trade-offs.

9|3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/dilhanz/ship --skill ship-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-design
Source: https://github.com/dilhanz/ship/tree/main/.claude/skills/ship-design
Command: npx skills add https://github.com/dilhanz/ship --skill ship-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you select the best architectural approach for a new feature by presenting distinct philosophies and their trade-offs, ensuring a well-considered plan before development begins.

Core Features & Use Cases

  • Architecture Comparison: Presents three distinct architectural philosophies (Minimal Changes, Clean Architecture, Pragmatic Balance) for a given feature.
  • Informed Decision Making: Guides the user to choose an approach based on summaries, pros, cons, and implementation details.
  • Use Case: When starting a new feature, run /ship-design to get expert recommendations on how to structure the code, helping you avoid technical debt and ensure maintainability.

Quick Start

Use the ship-design skill to present architecture options for the 'user-authentication' feature.

Frequently Asked Questions about ship-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right software architecture for a new feature?

Software architecture comparison for feature development presents distinct design philosophies such as minimal changes, clean architecture, and pragmatic balance. It analyzes codebase context and feature requirements to detail trade-offs and implementation specifics, ensuring informed decision-making.

What is the best way to plan software architecture before coding?

The best way to plan software architecture is to evaluate distinct design philosophies by their summaries, pros, cons, and implementation specifics. Comparing these approaches against your codebase context prevents technical debt and ensures informed decision-making before task planning.

How do I compare minimal changes versus clean architecture for feature development?

Comparing minimal changes versus clean architecture involves evaluating trade-offs against your feature requirements. Minimal changes focus on reducing codebase impact, while clean architecture prioritizes structural separation, allowing you to select a pragmatic balance if needed.

When do I need architectural design analysis for my codebase?

You need architectural design analysis when starting a new feature to ensure a well-considered plan before development begins. It helps avoid technical debt by proposing distinct design philosophies tailored to your codebase context and specific feature requirements.

Does architectural planning help avoid technical debt in software development?

Architectural planning helps avoid technical debt in software development by facilitating the selection of design approaches based on detailed trade-offs. Evaluating implementation specifics before coding ensures your feature structure aligns with long-term maintainability goals.