documenting-decisions

Make noteworthy code decisions easy to review.

code review

What it does

Surfaces noteworthy decisions in agent-generated code for human review.

When to use it

Use during planning, implementation, fixes, and requested diff or pull-request reviews.

It changes how the agent records and reports noteworthy decisions while working on a project.

What you provide

This skill

pull request description

Write

Updates the pull request description (irreversible)

driving ticket

Write

Updates the driving ticket (irreversible)

Uses writing-adrs for qualifying architectural or irreversible decisions.

Applies the to-tickets reproducibility invariant when reconciling ticket-driven work.