api-design-principles
πPluginoborchers/fractional-cto
Research-backed, opinionated guidance for designing world-class RESTful APIs β routes, naming, errors, auth, caching, webhooks, and more, distilled from Stripe, GitHub, Twilio, Shopify, Google, and Microsoft
Part of
oborchers/fractional-cto
Installation
/plugin marketplace add oborchers/fractional-cto/plugin install api-design-principles@fractional-ctoMore from this repository10
Zero-tolerance code pedantry β naming precision, casing law, structural symmetry, import discipline, and the obsessive details that separate clean code from correct code
The holy principles of SaaS design: research-backed, opinionated guidance for building fast, predictable, and progressively powerful SaaS products
Transform Claude Code conversation transcripts into polished, first-person blog posts through an interactive 5-stage pipeline β parse, triage, outline, draft, polish β with human editorial gates at every stage
Structured deep research methodology for Claude Code -- query decomposition, parallel web research with source verification, hallucination prevention, and synthesis into well-sourced documents
Chain work across two independent agent processes that share no parent session. One agent passes a baton (a completion signal file) when done, optionally carrying a free-form payload; another waits for it, with a deadline, then starts its dependent task. Harness-agnostic protocol β each agent picks its own waiting mechanism. The baton tells you when, never what: the payload is content, not instructions. Provides /baton-pass and /baton-wait.
Research-backed visual design principles for websites, presentations, documents, and any visual medium β grounded in VisAWI, Gestalt psychology, and empirical aesthetics research
Research-backed best practices for building modern, production-grade Python packages β project structure, pyproject.toml, typing, testing, CI/CD, documentation, versioning, API design, packaging, security, and developer experience
Adversarial plan review using red-team/blue-team agents -- generates what-if questions and grounds answers in plan artifacts with configurable tool scope
Manage Claude Code's plan-mode artifacts, author multi-phase master planning documents, walk through Open Questions interactively, and synthesize dense progress entries to markdown / Linear / GitHub. Provides /plan-context (pre-load with optional ticket fetch), /plan-master (draft with optional ticket fetch), /plan-open-questions (interactive Open-Questions walkthrough with batch apply), /plan-verify (audit), /plan-tick (auto-tick provenly-achieved phases), /plan-progress (per-branch progress entry with SHA-based idempotency), and /plan-delete (per-session cleanup). Integer-only phases, no sizing, project-agnostic.
Compress LLM agent instructions and code documentation markdown files through iterative section-by-section compression with compressor-reviewer loop β lossless structural optimization and lossy semantic compression modes, with auto-approve for hands-off operation