用途：swain-design 定义了一套规范化的文档工件类型、阶段与层级，用于把产品方向、战略分组、交付物、实现规格、调研、决策记录、运维手册、设计文档等统一管理，并支持工件在生命周期阶段间流转。
主要能力：提供各工件类型的定义与模板（含 frontmatter 字段与文档骨架）；按用户意图推断应创建的工件类型；生成下一个可用编号；校验父级引用；检测同类型重叠并处理取代关系；执行 ADR 合规检查、对齐检查与未锚定检查；运行 specwatch 扫描与索引刷新；在工件被取代时维护 specwatch-ignore 与反向引用。
使用方式：状态变更前先检查会话，命令为 REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)" && bash "$REPO_ROOT/.agents/bin/swain-session-check.sh" 2>/dev/null；若输出 status 非 active，提示操作者用 /swain-init 启动会话。创建工件时用 bash "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.agents/bin/next-artifact-id.sh" <PREFIX> 获取编号，并按定义文件与模板在对应阶段目录创建。更新元数据后运行 bash "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.agents/bin/chart.sh" build 刷新图缓存并提交。
适用场景：需要以结构化文档驱动产品与工程协作的仓库，尤其是使用 swain 工件体系进行规格管理、决策记录、调研与设计文档维护的团队。
限制：依赖仓库内 .agents/bin 下的脚本与 references/ 中的定义与模板；若脚本不可用需回退到扫描 docs/<type>/，但存在 worktree 冲突风险。与 superpowers 的集成是可选的，未安装时 swain 仍可独立运行。具体收费、价格与平台信息暂未提供。