Update a project generated by python-package-copier from the latest template version while preserving local customizations (README, docs, CI workflows, dependencies, source code). Use when working inside a generated repo and the user wants to pull in template improvements, sync with upstream template changes, or apply template updates. Handles intelligent 3-tier conflict resolution using copier update with .rej files. Triggers on requests like "update from template", "sync template", "pull template changes", "upgrade template", or "apply template updates".
Generate and structure information-oriented reference documentation for Python packages following Diátaxis principles. Use when asked to write API reference docs, CLI reference, configuration reference, error code reference, or any documentation that provides austere technical description of the machinery. Triggers on "write reference docs", "API documentation", "document the API", "CLI reference", "configuration reference", "error reference", "describe the interface".
Audit, plan, and structure Python package documentation following the Diátaxis framework (tutorials, how-to guides, reference, explanation). Use when asked to plan documentation, audit existing docs, identify documentation gaps, restructure docs, create a documentation roadmap, or organize documentation for a Python package. Triggers on "plan docs", "audit documentation", "structure docs", "documentation roadmap", "what docs do I need", "organize documentation".
Generate understanding-oriented explanation documentation for Python packages following Diátaxis principles. Use when asked to write conceptual docs, architecture overview, design decisions, "about" pages, "why" docs, background context, or any documentation that helps the reader understand a topic through reflection and discussion. Triggers on "write an explanation", "conceptual docs", "architecture overview", "design decisions", "why did we choose", "background", "about the design", "explain the architecture".
Generate task-oriented how-to guide documentation for Python packages following Diátaxis principles. Use when asked to write a how-to guide, cookbook entry, recipe, procedure, troubleshooting guide, or any documentation that helps an already-competent user accomplish a specific real-world task. Triggers on "write a how-to", "how to configure", "how to deploy", "how to integrate", "troubleshooting guide", "cookbook", "recipe", "procedure for".
Write or rework marimo example notebooks following Diataxis principles. Use when asked to create, edit, or rework interactive notebook examples that serve as tutorial or how-to companions to documentation pages. Triggers on "write a notebook example", "rework notebook", "example notebook", "interactive example", "marimo example", "tutorial notebook", "how-to notebook".
Generate learning-oriented tutorial documentation for Python packages following Diátaxis principles. Use when asked to write a tutorial, getting started guide, first steps page, quickstart, onboarding guide, or any documentation that teaches a beginner by walking them through hands-on steps. Triggers on "write a tutorial", "getting started page", "quickstart guide", "first steps", "beginner guide", "onboarding docs", "teach how to use".