mikaeltorni

github-seo

v1.0.0 — Use when a GitHub project needs to be found: search-engine ranking, AI/LLM citability, GitHub-internal discovery, and registry presence. Runs a weighted 100-point audit, records a tracked scorecard, then closes the highest-value gap round after round until the score is a fully evidenced 100/100, and maintains it after.

commit

Use when the user asks to inspect changes, split work into logical commits, stage hunks, or create commits. Plan every requested repository and execute the complete commit run in the same response.

Web & Frontend Listed

linux-configuration

Mandatory rules for any task on this machine that touches Linux desktop configuration: GNOME Shell extensions, gsettings, themes, hotkeys, systemd user services, or a repository install.sh. Requires console-only, silent deployment; activates edited extension code via the sanctioned in-place X11 run-dialog reload (`xdotool` `Alt+F2 r`) and forbids destructive session restarts, logout, `gnome-shell --replace`, and shell-kill commands. Covers clean-install compatibility and the root-optional (sudo-free) installer pattern.

worktree

MUST invoke before the first file Write or Edit in this git repo (including /app and /Projects/app). Create a sibling .worktrees/<project>/ worktree, do all coding and commits there, merge back, never push. Skipping this fails the task even if the code is correct. Apply on every coding task, including new files from scratch. Not a substitute: Claude EnterWorktree / ExitWorktree.

general-programming-guidelines

v1.12.1 — Mandatory engineering workflow and coding standards for every software task: implementation, debugging, review, testing, and refactoring.

AI & Automation Listed

init-project

Use when initializing a new project or adding Python support to existing projects. Implements anti supply-chain attack protection for Python dependencies and configures UV by Astral as the required package manager with rolling 24-hour publication delay.

refactoring

Use when the user asks to refactor, restructure, or modularize an existing codebase. Extracts monolithic files into well-organized modules following single-responsibility principles, audits multi-repository workspaces, creates tests first (TDD), and ensures extracted code is documented, logged, and verified. Always analyze and plan module boundaries before touching code.

setup-repository-guidelines

Invoked only on explicit user request, or when beginning work on a completely new project that has no existing repository guidelines. Detects membership from scripts/repository_manifest.sh and enforces owner routing, selectable installer integration, clean-install compatibility, safe deployment, and prompt-free keyring handling. Do not invoke it for routine tasks in repositories that already have guidelines.

commenting

Use whenever writing or editing Python (or other) functions: every function must have a docstring with a description, Parameters, and Returns in exactly that format. Apply on every coding task, including new files from scratch.

AI & Automation Listed

logging

Use whenever writing or editing Python (or other) functions: print each function's incoming parameters at entry and the return value just before returning. Keep it to plain print() — no logging modules or log files.

AI & Automation Listed

srp

Use whenever writing or editing Python (or other) code: enforce single-responsibility functions and methods. Apply on every coding task, including small scripts and new files from scratch.