md-issue-writer
SKILL.md
MD Issue Writer
Overview
This skill enables the creation of concise, one-page technical documents for software issues, features, decisions, and work items. Each document follows a standardized YAML frontmatter and markdown structure, making them discoverable and indexable across the knowledge base.
When to Use Each Document Type
Use this decision tree to select the right template:
| Situation | Document Type | Purpose |
|---|---|---|
| Something broke or isn't working | Bug Report | Root cause analysis, prevention, lessons learned |
| Build/ship a new capability | Feature Plan | Goals, requirements, implementation approach, risks |
| Need consensus on architectural direction | RFC | Proposal, motivation, design, alternatives, Q&A |
| Made a major technical decision | ADR | Document the decision, context, and consequences |
| Have specific work to accomplish | Task | Objectives, acceptance criteria, checklist |
| Learned something from an incident/project | Retrospective | What happened, what went well, lessons, actions |