agent-skills

Senior software engineering decision-making, development, debugging, and code-review process based on an 18+ year engineer's habits. Use when Codex should approach a coding task, bug investigation, refactor, architecture choice, or review by first understanding the business goal, user scenario, data flow, system impact, risks, and lowest long-term-cost solution before changing code.

Enforce Architectural Decision Records (ADR) logging for every task. Use when a user asks to create, update, or enforce ADRs, or when a workflow requires logging decisions in an ADR directory with daily files named adr_yyyy_mm_dd.md.

Investigation-only mode for understanding bugs, features, or system behavior without making changes. Use when the user says phrases like "let's investigate", "we need to figure out", or "we're debuggin", or asks to investigate or analyze before changing anything.