Development · citypaul/.dotfiles

Render the shape of code — module boundaries, the types that cross them, signatures, and a cited call graph — for code that already exists or a change about to be built.

citypaul/.dotfiles

Design, audit, and evolve physical source and package structures that expose real architectural boundaries while keeping related behavior together.

citypaul/.dotfiles

A skill your agent uses when modifying existing code that lacks tests and you need to document its actual current behavior before making changes -- the legacy code dilemma where you need tests to…

citypaul/.dotfiles

Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh.

citypaul/.dotfiles

A skill your agent uses when existing code has untestable dependencies that prevent writing tests -- direct construction of collaborators, static or global function calls, tight coupling to external…

citypaul/.dotfiles

Refactoring assessment and behavior-preserving patterns for code with a passing baseline and proportionate preservation evidence.

citypaul/.dotfiles

Decide whether planned vertical implementation work should ship as independent pull requests or as a stack of small ordered pull requests, then plan, build, review, update, and merge the stack safely.

citypaul/.dotfiles

TypeScript strict mode patterns including schema-first development, branded types, type vs interface guidance, and tsconfig strict flags.

citypaul/.dotfiles

WHEN diagnosing a reproducible or observable software failure outside a CI-pipeline-specific workflow; NOT for speculative cleanup, general code review, or speculative behavior changes presented as…

citypaul/.dotfiles

Audit an existing repository or multi-module subsystem for evidence-backed architecture improvements, rank bounded candidates, and present them in a visual HTML report with before-and-after diagrams…

citypaul/.dotfiles

Unix-composable CLI design patterns. An agent skill from citypaul/.dotfiles.

citypaul/.dotfiles

Domain-Driven Design patterns for TypeScript. An agent skill from citypaul/.dotfiles.

citypaul/.dotfiles

Event sourcing patterns for functional TypeScript — persist state as an append-only log of past events and rebuild it by folding them.

citypaul/.dotfiles

A skill your agent uses when the user or project explicitly adopts hexagonal (ports and adapters) architecture — a README, CLAUDE.md, or ADR that says so is the opt-in.

citypaul/.dotfiles

Planning work as vertical slices or an explicitly selected mechanism-reduction program in small, known-good increments, with independent pull requests or an optional stacked-PR topology across one…

citypaul/.dotfiles

One ubiquitous language per bounded context, with a repository-declared glossary as the naming authority and explicit decisions for language changes.

citypaul/.dotfiles

WHEN deciding whether a PR, branch, diff, or current implementation satisfies an authoritative issue, specification, or decision contract; NOT for improving the written artifact, reconstructing…

citypaul/.dotfiles

Create or audit maintainable diagrams when relationships, sequence, state, hierarchy, or quantitative comparisons are materially clearer visually than in prose.

citypaul/.dotfiles

Writing developer-facing prose that can be skimmed first and trusted enough to finish — READMEs, guides, tutorials, reference docs, proposals, PR descriptions, release notes.

citypaul/.dotfiles