Summary

• document Issue Implement shell state provider/context #17 directive ("use gh to check it out, we should also look into other design documents which reference the shell state provider/context") in a dedicated design doc
• capture architecture, work breakdown, and agent guardrails for the planned ShellStateProvider in docs/shell-state-provider-design.md

Acceptance Criteria

• design document merged into main
• Presentation Shell Lead review recorded