45ck maintenance-knowledge-capture-writer
Purpose
Capture maintenance knowledge into reusable notes, decision records, runbooks, and future guardrails.
Trigger this skill when
- A maintenance, support, defect, release, or evolution decision needs clearer structure.
- Symptoms, causes, impacts, and release choices are being conflated.
- You need artifacts that reduce operational surprise and rework.
Expected inputs
- issue report or change request
- system context
- known symptoms or requested change
- constraints / urgency
- available evidence if any
Deliverables
- summary
- findings
- structured outputs
- risks / blockers
- open questions
- recommended next skill
Operating procedure
- Clarify whether the work is driven by a defect, environmental change, requested improvement, or preventive maintenance need.
- Separate observations, assumptions, hypotheses, and verified facts.
- Produce the skill-specific artifact or decision aid.
- Surface blast radius, rollback needs, regression exposure, and consumer impact explicitly.
- Recommend the next best handoff instead of trying to solve the entire maintenance lifecycle at once.
Quality gates
- The output is specific to the current maintenance context.
- Uncertainty, evidence gaps, and operational constraints are visible.
- The result is usable by an engineer, maintainer, on-call responder, or team lead.
- The output improves safety, speed, or clarity of the next maintenance decision.
Handoff targets
- corrective-adaptive-perfective-preventive-classifier
- maintenance-triage-helper
- deprecation-planner
Output style
- Prefer operationally useful artifacts over generic “maintenance best practices.”
- Be explicit about urgency, blast radius, rollback risk, and residual uncertainty.
- Surface what still needs verification instead of implying the cause is proven.
- Keep outputs concise enough to drop into tickets, incident notes, PRs, or runbooks.
Failure modes to avoid
- Do not confuse a symptom with a verified root cause.
- Do not recommend shipping changes without considering rollback and regression exposure.
- Do not hide environment or data dependencies that could invalidate the result.
- Do not treat all maintenance work as “just bug fixing.”
Minimum output skeleton
## Summary
## Findings
## Structured outputs
## Risks / blockers
## Open questions
## Recommended next skill