Skip to content

Comments

feat(design): add assumption surfacing and resolution to design workflow#38

Merged
MacAttak merged 1 commit intomainfrom
claude/improve-design-assumptions-5IpC9
Feb 19, 2026
Merged

feat(design): add assumption surfacing and resolution to design workflow#38
MacAttak merged 1 commit intomainfrom
claude/improve-design-assumptions-5IpC9

Conversation

@MacAttak
Copy link
Contributor

Design assumptions (statements treated as true without verification) are a
leading cause of project failures. This adds a structured mechanism to the
sw-design skill that identifies, classifies, and requires resolution of
assumptions before design approval.

Changes:

  • New protocol (protocols/assumptions.md) defining the assumptions.md
    artifact format, classification taxonomy (5 categories, 3 resolution
    types, 3 statuses), lifecycle, and identification heuristics
  • Enhanced sw-design skill with an "Assumption resolution" phase between
    critic and approval, requiring users to clarify, provide reference docs,
    or resolve with external teams before proceeding
  • Enhanced specwright-architect agent to surface and classify assumptions
    in its output format alongside existing findings
  • Updated DESIGN.md and CLAUDE.md to reflect the new artifact and protocol

https://claude.ai/code/session_01AsWJbSUk3hRR7Myju6bk69

Design assumptions (statements treated as true without verification) are a
leading cause of project failures. This adds a structured mechanism to the
sw-design skill that identifies, classifies, and requires resolution of
assumptions before design approval.

Changes:
- New protocol (protocols/assumptions.md) defining the assumptions.md
  artifact format, classification taxonomy (5 categories, 3 resolution
  types, 3 statuses), lifecycle, and identification heuristics
- Enhanced sw-design skill with an "Assumption resolution" phase between
  critic and approval, requiring users to clarify, provide reference docs,
  or resolve with external teams before proceeding
- Enhanced specwright-architect agent to surface and classify assumptions
  in its output format alongside existing findings
- Updated DESIGN.md and CLAUDE.md to reflect the new artifact and protocol

https://claude.ai/code/session_01AsWJbSUk3hRR7Myju6bk69
@MacAttak MacAttak merged commit 567ce9e into main Feb 19, 2026
2 checks passed
@github-actions github-actions bot mentioned this pull request Feb 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants