assumption-first-redesign

Design a clean-slate target architecture and incremental migration plan from foundational assumptions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jkenney47/finance-app-ux-planning-snapshot-20260308-155100 --skill assumption-first-redesign
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assumption-first-redesign
Source: https://github.com/jkenney47/finance-app-ux-planning-snapshot-20260308-155100/tree/main/.agents/skills/assumption-first-redesign
Command: npx skills add https://github.com/jkenney47/finance-app-ux-planning-snapshot-20260308-155100 --skill assumption-first-redesign

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you redesign systems by assuming a new constraint or capability was present from the start, providing a clean target architecture and a realistic migration plan.

Core Features & Use Cases

  • Clean-Slate Design: Generates an ideal architecture based on new foundational assumptions, ignoring legacy constraints.
  • Incremental Migration: Develops a step-by-step plan to migrate from the current system to the target architecture.
  • Use Case: When a new regulatory requirement mandates strict data privacy, this Skill can redesign the system's data handling and access controls as if privacy was always the top priority, then outline how to achieve this without a full rewrite.

Quick Start

Use the assumption-first-redesign skill to redesign the user authentication flow assuming multi-factor authentication was always required.

Frequently Asked Questions about assumption-first-redesign

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

FAQPage Schema
How do I redesign a system architecture around new assumptions?

System redesign normalizes proposed changes into foundational assumptions to generate a clean-slate target architecture. It provides a realistic, incremental migration plan to transition from the current state without requiring a full rewrite.

What is the best way to plan an incremental migration for a clean slate architecture?

An incremental migration plan bridges your current system to a clean-slate architecture by outlining step-by-step changes. It addresses complex architectural shifts and ownership boundary changes to ensure a smooth transition under new constraints.

When do I need an assumption-first approach for refactoring?

An assumption-first refactoring approach is needed when new invariants or constraints mandate a fundamental architectural shift. It helps redesign the system as if these new capabilities or requirements were present from the start.

How do I migrate complex system boundaries without a full rewrite?

Migrating complex system boundaries without a full rewrite requires an incremental migration plan based on a clean-slate target architecture. This approach normalizes changes into foundational assumptions to handle ownership boundary changes gradually.

Can I use this approach for strict regulatory compliance data handling?

Yes, assumption-first redesign can re-architect data handling and access controls by treating strict regulatory requirements as foundational assumptions. It designs a clean target architecture and outlines the migration steps to achieve compliance.

What do I need to define before starting an assumption-first redesign?

Before starting an assumption-first redesign, you need a clear definition of the current system state, proposed changes, and constraints. This input allows the process to accurately normalize new assumptions and design the target architecture.