45ck decision-log-writer
Purpose
Maintain concise decision logs capturing what changed, why, who decided, and follow-on actions.
Trigger this skill when
- A durable documentation or evidence artifact is needed for review, submission, audit, or handover.
- You need clearer linkage between requirements, design, testing, defects, decisions, or findings.
- Existing documentation is fragmented, inconsistent, or weakly evidenced.
Expected inputs
- decision event
- context
- owner
- follow-up actions
Deliverables
- decision log entry
- follow-up list
- affected artifacts
Operating procedure
- Clarify the artifact boundary, audience, and review objective.
- Separate known facts from assumptions, placeholders, and missing evidence.
- Produce the skill-specific artifact in a form that can be reused directly.
- Link the result to upstream and downstream artifacts where helpful.
- Recommend the next best handoff instead of trying to do every document at once.
Quality gates
- The output is specific to the current system, feature, or report context.
- Identifiers, references, and labels are internally consistent.
- Missing evidence or unresolved questions are made visible.
- The result is directly usable in a repo, report, appendix, or review packet.
Handoff targets
- design-rationale-writer
- architecture-record-writer
- appendix-assembler
Output style
- Prefer structured, reusable artifacts over generic prose.
- Make IDs, labels, references, and evidence explicit where possible.
- Preserve traceability between related artifacts.
- Surface missing evidence or unresolved questions instead of inventing closure.
Failure modes to avoid
- Do not fabricate evidence, references, or approval.
- Do not collapse requirements, decisions, tests, and findings into one undifferentiated blob.
- Do not leave identifiers or document links inconsistent.
- Do not confuse “described” with “verified”.