first-principles-architecture

Analyzes codebase architecture using first-principles thinking to remove bloated abstractions and dependencies.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/chrisschouk/chrisscho-uk-marketing-skills --skill first-principles-architecture-chrisschouk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: first-principles-architecture
Source: https://github.com/chrisschouk/chrisscho-uk-marketing-skills/tree/main/skills/_parked/first-principles-architecture
Command: npx skills add https://github.com/chrisschouk/chrisscho-uk-marketing-skills --skill first-principles-architecture-chrisschouk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Codebases accumulate legacy assumptions, heavy frameworks, and unnecessary abstraction layers that inflate memory usage, latency, and maintenance cost. This Skill provides a structured method to deconstruct a system to its fundamental primitives and propose a simpler, faster architecture. ## Core Features & Use Cases - First-Principles Deconstruction: Strips away framework conventions and third-party libraries to identify physical and computational constraints like memory, CPU cycles, and network bandwidth. - Assumption Auditing: Challenges existing design choices, such as replacing heavy headless browsers with native capture tools or polling loops with streaming connections. - Unblocking Audit Template: Produces a physics audit (memory footprint, latency, dependency overhead), a list of high-impact simplifications, and a concrete refactoring action plan. - Use Case: Point it at a service that uses a full browser automation stack for screenshots, and receive a step-by-step plan to replace it with lightweight native primitives. ## Quick Start Ask the assistant to run a first-principles analysis on your project architecture and suggest simplifications to reduce dependencies and latency.

Frequently Asked Questions about first-principles-architecture

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

FAQPage Schema
How do I simplify a bloated codebase architecture?▼

Apply first-principles analysis by deconstructing the system to its fundamental primitives, questioning each framework and dependency assumption, then rebuilding with minimal moving parts. The audit template lists three bloated abstractions to remove and two direct primitives to adopt.

What is first-principles thinking in software architecture?▼

First-principles thinking strips away conventions and legacy assumptions to reason from physical and computational constraints like memory, CPU cycles, and bandwidth. It then rebuilds the architecture from the ground up based strictly on efficiency and simplicity.

When should I replace a heavy framework with native tools?▼

Replace heavy frameworks when a simpler primitive achieves the same result with far less overhead, such as using a native screen capture tool instead of a headless browser. The skill audits memory footprint and latency per execution loop to justify the swap.

What are the limitations of first-principles architecture analysis?▼

The analysis produces recommendations and refactoring plans but does not execute code changes itself. It also requires human judgment to validate that proposed simplifications preserve required business functionality and team conventions.

How does the codebase unblocking audit work?▼

The audit runs in three stages: a fundamental physics audit of memory, latency, and dependency overhead; a list of high-impact simplifications; and a concrete action plan with line-by-line refactoring justification.