swain-design

This skill defines the canonical artifact types, phases, and hierarchy. Detailed definitions and templates live in references/. If the host repo has an AGENTS.md, keep its artifact sections in sync with the skill's reference data.

Each artifact type has a definition file (lifecycle phases, conventions, folder structure) and a template (frontmatter fields, document skeleton). Read the definition for the artifact type you are creating or transitioning.

| Type | What it is | Definition | Template |

إنشاء عناصر التوثيق والتحقق من صحتها ونقلها (Vision وEpic وStory وSpec وSpike وADR وPersona وRunbook وBug وDesign وJourney) عبر مراحل دورة الحياة. يتعامل مع كتابة المواصفات، وتخطيط الميزات، وإنشاء الملحمة، وقصص المستخدم، وصياغة ADR، والارتفاعات البحثية، وتعريف الشخصية، وإنشاء دليل التشغيل، وحفظ الأخطاء، والتقاط التصميم، ومستندات الهندسة المعمارية، وانتقالات المرحلة، وتخطيط التنفيذ، والتحقق من صحة المرجع الترافقي، وعمليات التدقيق. سلاسل في swain-do لتتبع التنفيذ على SPEC/STORY/BUG؛ يتحلل EPIC/VISION/JOURNEY إلى الأطفال أولاً. المصدر: cristoslc/swain.