sdd-artifact-rollout
Guides SDD artifact implementation for NEW and EXISTING projects. Use for DDD glossary, context map, domain models, ADRs, user stories with acceptance criteria. For existing projects, supports gap analysis, code-to-spec reverse engineering, and phased migration. Triggers on SDD, spec-driven, artifact, glossary, context map, domain vision, ADR, legacy documentation, reverse engineering, existing project documentation, gap analysis.
Security Assessment
About sdd-artifact-rollout
The sdd-artifact-rollout skill facilitates the structured implementation of Specification-Driven Development (SDD) artifacts for both new and existing projects. It addresses the challenges teams face in creating AI-ready specifications and ensuring consistency between design documentation and code. By following a phased methodology, this skill guides teams through the creation and integration of domain models, context maps, glossaries, user stories with formal acceptance criteria, and architecture decision records (ADRs), enabling a more systematic approach to project documentation and development.
Key features of this skill include support for both new and legacy projects, gap analysis for existing documentation, reverse engineering of code into specifications, and phased rollout planning. For new projects, it provides a 12-week standard framework covering foundational domain vision, requirements, conceptual design, data and API specifications, and operational automation. For existing projects, it offers guidance for diagnosing documentation gaps, extracting implicit knowledge from code and team artifacts, and gradually migrating to SDD-compliant practices. It leverages AI for generating glossaries, refining user stories, and assisting with code skeleton generation.
This skill is particularly suited for software development teams implementing SDD, domain-driven design, or formalized specification practices. Target users include product owners, technical leads, developers, QA engineers, and DevOps professionals who need to align their project artifacts with a structured development methodology. It is also useful for teams maintaining legacy systems that require comprehensive documentation, phased migration, and integration of AI-assisted specification generation to improve project clarity and maintainability.
FAQ
How do I start using this skill for a new project?
Begin by gathering context inputs such as domain, team composition, timeline, regulatory requirements, existing artifacts, and project type. Follow the 12-week phased framework starting with foundational domain vision and glossary creation.
Can this skill be used with an existing codebase?
Yes, it supports gap analysis, reverse engineering of code into domain models and glossaries, API extraction into OpenAPI specs, and phased migration to SDD-compliant artifacts.
What are the main AI-assisted features?
AI is used for generating glossaries, refining user stories and acceptance criteria, assisting with code skeleton generation, and supporting context map and domain model development.
Are there any limitations or prerequisites?
Users should have access to existing project artifacts if available, understand the project domain, and follow the phased rollout plan. The skill assumes a standard 12-week timeline for full rollout but can be adapted.
Which deliverables are produced during the rollout?
Deliverables include domain vision statements, glossaries, bounded context maps, user stories with acceptance criteria, domain models, domain events, service specifications, OpenAPI specs, ADRs, and CI/CD validation procedures.
Install sdd-artifact-rollout
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
mosaan/releio