Software Design Description

Create or review an SDD using an IEEE 1016-inspired structure while staying pragmatic for project context.

Resources

• Use references/sdd-completeness-checklist.md for completeness gates and required content coverage.
• Use the templates under references/document-set/ as the canonical SDD document-set structure.
• Use references/viewpoint-mapping.md to choose viewpoints and map them to concrete views.
• Use references/copyright-safety.md for copyright/standards guardrails.
• Use references/quality-attribute-scenarios.md for quality-attribute scenario patterns.
• Use scripts/check_sdd_structure.py to validate required files, headings, links, and core formalization sections across the canonical SDD document set.
• Use scripts/check_doc_artifacts.py to validate dated gap and drift artifact history under .agent-doc-skills/.
• Use scripts/count_text_size.py to inspect file size quickly (chars, words, lines) and optional Markdown heading breakdown (--by-heading).

Mandatory preflight sequence:

1. Read available context first (PRD/SDD/repo docs relevant to the request).
2. Optionally run a size check for large doc sets: python3 scripts/count_text_size.py --glob "<sdd-root>/**/*.md" --by-heading.