princess-code(1) — princess.consulting

Name

princess-code — Software entwickeln, bestehenden Code verbessern, technische Entscheidungen treffen

Synopsis

princess-code --build <spec> [--test] [--deploy]

princess-code --refactor <codebase> [--coverage] [--perf]

princess-code --review <repo> [--architecture] [--report]

princess-code --strategy <problem> [--roadmap]

Description

princess-code arbeitet an der Schnittmenge von Software-Entwicklung und Infrastruktur. Kleine Tools, die ein konkretes Problem lösen. Backends, die tatsächlich deployed werden. Codebases, die jemand nach dem Projekt noch anfassen kann.

Refactoring-Projekte sind ein Schwerpunkt: gewachsene Systeme, die niemand mehr anfassen will, weil niemand mehr versteht, was sie tun. Analysieren, Teile extrahieren, Tests einbauen, schrittweise stabilisieren — ohne den Betrieb zu unterbrechen.

Technische Strategie ohne Folien: Wenn ein Team vor einer Architektur- Entscheidung steht, hilft eine externe Perspektive. Keine Framework- Empfehlung aus dem Trend-Report, sondern basierend auf dem konkreten System, dem Team und den Betriebsanforderungen.

Options

--build Neues Tool oder Service entwickeln. Von der Spezifikation bis zum ersten produktiven Deployment. Kein Scope-Creep, keine Feature-Fabrik.

--refactor Bestehende Codebase stabilisieren. Technische Schulden abbauen, Test-Coverage aufbauen, Abhängigkeiten aktualisieren. Schrittweise, nicht auf einmal.

--coverage Test-Coverage gezielt einbauen: kritische Pfade zuerst, nicht 100%-Coverage als Selbstzweck. Unit-, Integration- und Contract-Tests.

--perf Performance-Analyse und Optimierung. Profiling, Bottleneck-Identifikation, konkrete Verbesserungen mit Messung davor und danach.

--review Code- und Architektur-Review. Was funktioniert, was nicht, was als nächstes. Schriftlicher Bericht, kein Meeting-Theater.

--architecture Architektur-Analyse: Komponentengrenzen, Datenflüsse, Skalierungsengpässe, unausgesprochene Annahmen. Geeignet als Vorbereitung für größere Umbauarbeiten.

--strategy Technische Strategieberatung. Wo steht das System, welche Richtungen gibt es, was sind die realen Trade-offs. Keine Buzzwords, keine Vendor-Empfehlungen.

Examples

Internes Deployment-Tool bauen

princess-code --build deploy-tool.spec --test --deploy

Spec analysed: CLI, reads git tags, pushes to registry, triggers webhook

Language: Go (single binary, no runtime dependency)

Test coverage: 82% on core paths

[ OK ] v1.0.0 released. Binary size: 8.2MB. Runs on Linux/arm64+amd64.

PHP-Monolithen schrittweise stabilisieren

princess-code --refactor legacy-app/ --coverage --perf

Analysing… 38k LOC, 0 tests, 47 direct DB queries in controllers

Extracting: Repository layer, service interfaces, input validation

Coverage after phase 1: 34% (critical paths covered)

Query time p95: 840ms → 120ms (N+1 eliminated)

[ OK ] App in production throughout. Zero downtime incidents.

Architektur-Review vor Rewrite-Entscheidung

princess-code --review monolith/ --architecture --report

Mapping component boundaries and implicit contracts…

Finding: 3 modules with clear extraction potential

Finding: rewrite not justified — incremental path viable

Report: architecture-review-2026-06.pdf (12 pages, no fluff)

Authors

princess.consulting — hi@princess.consulting

Last revised: June 2026.