Menu
Generate Architecture Decision Records — use when asked to document a decision, create an ADR, record why we chose X, or capture architectural rationale.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Recognizing context pressure before it degrades output quality.
Writing implementation plans — small testable steps, dependency ordering, upfront risk identification.
Evidence before claims, always — run verification commands and confirm output before making any completion or success claims.
Generate a structured changelog from git history — use when asked to create a changelog, release notes, or summarize what changed between versions/tags/branches.
How to write pikit workflow YAML files — steps, loops, branches, interpolation.
Deep research with Analysis of Competing Hypotheses — use when asked to do deep research, deeply investigate, validate claims, or when correctness is critical and the user wants rigorous analysis with disconfirmation testing.
| name | adr |
| description | Generate Architecture Decision Records — use when asked to document a decision, create an ADR, record why we chose X, or capture architectural rationale. |
Capture the why behind architectural decisions so future-you (and future-agents) don't reverse them without context.
Identify:
If the user hasn't specified, ask one question: "What decision are you documenting?"
ls docs/adr/ 2>/dev/null | tail -5
Determine the next sequence number. If no docs/adr/ exists, start at 0001.
Create docs/adr/NNNN-short-title.md:
# NNNN. Short Decision Title
**Date:** YYYY-MM-DD
**Status:** accepted | proposed | deprecated | superseded by [NNNN]
## Context
What is the issue? What forces are at play? 2-4 sentences max.
## Decision
What did we decide? State it directly. 1-3 sentences.
## Alternatives Considered
- **Alternative A** — why rejected (1 line)
- **Alternative B** — why rejected (1 line)
## Consequences
What follows from this decision? Both positive and negative. Bullet list.
accepted. Use proposed only if the user hasn't decided yet.