You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: openspec/explorations/explore-workflow-ux.md
+15-2Lines changed: 15 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,8 @@ The explore workflow is part of the core loop (`propose`, `explore`, `apply`, `a
6
6
7
7
Currently, explore references `/opsx:new` and `/opsx:ff` which are being replaced with `/opsx:propose`. But beyond just updating references, there are deeper UX questions about how explore should work.
8
8
9
+
This exploration is also affected by the emerging workspace direction: for larger cross-team or cross-repo work, OpenSpec may need to treat the **initiative** as the first-class planning object and repo-local changes as execution artifacts. That means explore may sometimes be seeding an initiative, not just a single change.
10
+
9
11
## Open Questions
10
12
11
13
### Exploration Artifacts
@@ -17,6 +19,7 @@ Currently, explore references `/opsx:new` and `/opsx:ff` which are being replace
17
19
2.**Where should exploration files live?**
18
20
-`openspec/explorations/<name>.md`?
19
21
-`openspec/changes/<change>/explorations/`?
22
+
-`.openspec-workspace/initiatives/<initiative>/explorations/` for coordinated work?
20
23
- Somewhere else?
21
24
22
25
3.**What should the format be?**
@@ -30,15 +33,17 @@ Currently, explore references `/opsx:new` and `/opsx:ff` which are being replace
30
33
- e.g., exploring auth approaches separately from UI approaches
31
34
- How would these relate to each other?
32
35
33
-
5.**How do explorations relate to changes?**
36
+
5.**How do explorations relate to changes or initiatives?**
34
37
- Before change exists: standalone exploration
35
-
- After change exists: exploration linked to change?
38
+
- After repo-local change exists: exploration linked to change?
39
+
- For coordinated work: exploration linked to initiative first, then optionally referenced by repo-local changes?
36
40
37
41
### Lifecycle & Transitions
38
42
39
43
6.**What happens before a change proposal exists?**
40
44
- Exploration is standalone
41
45
- When ready, user runs `/opsx:propose`
46
+
- For coordinated work, should exploration context seed an initiative first?
42
47
- Should exploration context automatically seed the proposal?
43
48
44
49
7.**What happens after a change proposal exists?**
@@ -90,11 +95,19 @@ Currently, explore references `/opsx:new` and `/opsx:ff` which are being replace
90
95
-**Pro:** Clear relationship to changes
91
96
-**Con:** Where do pre-change explorations go?
92
97
98
+
### Approach E: Initiative-First Explorations for Coordinated Work
99
+
- Local work can stay standalone or change-linked
100
+
- Coordinated work saves exploration notes under an initiative in the coordination workspace
101
+
- Repo-local changes can reference the shared exploration when execution starts
102
+
-**Pro:** Matches the emerging split between shared planning and repo-local execution
103
+
-**Con:** Adds another context where exploration artifacts may live
104
+
93
105
## Next Steps
94
106
95
107
-[ ] User research: How do people actually use explore today?
96
108
-[ ] Prototype: Try saving explorations and see if propose benefits
97
109
-[ ] Decide: Pick an approach based on findings
110
+
-[ ] Reconcile explore UX with initiative-first coordinated planning
0 commit comments