dev-process-kit 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 kimuson
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,88 @@
1
+ # dev-process-kit
2
+
3
+ Design-process documents as single HTML files: an agent generates one, a human reviews it in the
4
+ browser, and the review comes back as structured change requests the agent can apply.
5
+
6
+ ## Features
7
+
8
+ - **Rich diagrams with almost no code.** Parts for the traditional diagrams a development process uses, ready to drop into your markup.
9
+ - **No setup.** The components are made for a single-file HTML page and ship as Web Components: one `<script>` tag, and they are there.
10
+ - **Feedback without leaving the page.** Operate the diagram and comment on individual elements in the UI, then copy the operations and the comments out as a hand-off to an agent.
11
+
12
+ ## Why dev-process-kit?
13
+
14
+ Now that AI writes the code, the bottleneck has moved to the human side: the cognitive load of reading, checking and agreeing on what was built. dev-process-kit supports that human context engineering.
15
+
16
+ It does so with one consistent loop:
17
+
18
+ ```mermaid
19
+ flowchart LR
20
+ ask["① Human asks the agent"] --> present["② Agent presents the context and what<br/>it understood, in a form a human<br/>reads at a glance"]
21
+ present --> review["③ Human reviews it and feeds<br/>back the gaps and the details"]
22
+ review -->|"draft actions + brief"| present
23
+ ```
24
+
25
+ ② is why the kit ships the formats that have proven themselves for building shared understanding between human engineers — user story mapping, ER diagrams and the rest.
26
+
27
+ ③ goes further than showing a picture: where a format allows it, the page can be operated directly in the browser, and those operations are collected as a log and handed to the agent, which rewrites the page itself.
28
+
29
+ ## Usage
30
+
31
+ dev-process-kit is built to be used by an agent: the instructions for LLMs are the [`dev-process-kit` skill](skills/dev-process-kit/SKILL.md). It is published to npm as [`dev-process-kit`](https://www.npmjs.com/package/dev-process-kit), a page loads it from jsDelivr with the version pinned, and the documentation of each version is [`docs/`](docs/index.md) at its `v<version>` tag.
32
+
33
+ The shortest way to try it is to hand the skill to an agent and say what you want:
34
+
35
+ ```markdown
36
+ Create a USM for this product.
37
+ Follow https://raw.githubusercontent.com/d-kimuson/dev-process-kit/main/skills/dev-process-kit/SKILL.md.
38
+ ```
39
+
40
+ ### Install the skill
41
+
42
+ The `dev-process-kit` agent skill tells the agent when to reach for a page and how to keep it focused.
43
+
44
+ ```sh
45
+ # Any agent supported by the skills CLI
46
+ npx skills add d-kimuson/dev-process-kit
47
+ ```
48
+
49
+ ```text
50
+ # Claude Code
51
+ /plugin marketplace add d-kimuson/dev-process-kit
52
+ /plugin install dev-process-kit@dev-process-kit
53
+ ```
54
+
55
+ ## Supported components
56
+
57
+ dev-process-kit ships **templates**, which make up a whole page, and **components**, which you combine inside one.
58
+
59
+ ### Templates
60
+
61
+ | Template | Element | What it is |
62
+ | ------------------ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
63
+ | UX Prototype | `dpk-template-prototype` | `Activity › UserStory › Step › Preview[]`: one step is one page or experience state, with previews per viewport |
64
+ | User Story Mapping | `dpk-template-usm` | The backbone (activity › step) as columns, milestones as rows |
65
+ | Event Storming | `dpk-template-event-storming` | Sticky notes on swimlanes in timeline order, with causality links between them |
66
+ | Example Mapping | `dpk-template-example-mapping` | One story per column, rules beneath it, examples beneath each rule, questions pinned to any of them |
67
+ | Grill | `dpk-template-grill` | A review of questions over whatever you put in the main area: the questions are base data, the answers are draft actions, the badges sit on your own markup |
68
+ | Plain | `dpk-template-plain` | For a page no other template fits: only the header and the review (comments) pipeline around your own markup |
69
+
70
+ ### Components
71
+
72
+ | Component | Element | What it is |
73
+ | ---------------- | -------------------------------- | -------------------------------------------------------------------------------------------- |
74
+ | Review rail | `dpk-component-comment-panel` | The draft actions and comments, stale markers, deletion, and the copy hand-off for the agent |
75
+ | Inline editing | `dpk-component-inline-edit` | A text/multiline editor that emits `dpk-commit` |
76
+ | State diagram | `dpk-component-state-diagram` | Which states exist, and what moves between them |
77
+ | Sequence diagram | `dpk-component-sequence-diagram` | In what order participants talk |
78
+ | Dependency graph | `dpk-component-dependency-graph` | What depends on what, and what is circular |
79
+ | ER diagram | `dpk-component-er-diagram` | What changed between two schema snapshots |
80
+ | Architecture map | `dpk-component-architecture-map` | Which services exist, in which boundary |
81
+ | Mind map | `dpk-component-mind-map` | A central topic and its subtopics, fanned out left and right, with folding |
82
+ | Kanban | `dpk-component-kanban` | Columns of cards with WIP limits; reviewers move and add cards as draft actions |
83
+
84
+ Diagrams are components, not templates: no draft actions, no review rail, no navigation. Put them in your own page, or inside a template. Each one has a page — `docs/templates/<name>.md` and `docs/components/<name>.md`.
85
+
86
+ ## License
87
+
88
+ MIT
@@ -0,0 +1,201 @@
1
+ # Licenses
2
+
3
+ The app bundles dependencies which contain the following licenses:
4
+
5
+ ## @floating-ui/core - 1.8.0 (MIT)
6
+
7
+ MIT License
8
+
9
+ Copyright (c) 2021-present Floating UI contributors
10
+
11
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
12
+ this software and associated documentation files (the "Software"), to deal in
13
+ the Software without restriction, including without limitation the rights to
14
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
15
+ the Software, and to permit persons to whom the Software is furnished to do so,
16
+ subject to the following conditions:
17
+
18
+ The above copyright notice and this permission notice shall be included in all
19
+ copies or substantial portions of the Software.
20
+
21
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
23
+ FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
24
+ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
25
+ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
26
+ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27
+
28
+ ## @floating-ui/dom - 1.8.0 (MIT)
29
+
30
+ MIT License
31
+
32
+ Copyright (c) 2021-present Floating UI contributors
33
+
34
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
35
+ this software and associated documentation files (the "Software"), to deal in
36
+ the Software without restriction, including without limitation the rights to
37
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
38
+ the Software, and to permit persons to whom the Software is furnished to do so,
39
+ subject to the following conditions:
40
+
41
+ The above copyright notice and this permission notice shall be included in all
42
+ copies or substantial portions of the Software.
43
+
44
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
45
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
46
+ FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
47
+ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
48
+ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
49
+ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
50
+
51
+ ## @floating-ui/utils - 0.2.12 (MIT)
52
+
53
+ MIT License
54
+
55
+ Copyright (c) 2021-present Floating UI contributors
56
+
57
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
58
+ this software and associated documentation files (the "Software"), to deal in
59
+ the Software without restriction, including without limitation the rights to
60
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
61
+ the Software, and to permit persons to whom the Software is furnished to do so,
62
+ subject to the following conditions:
63
+
64
+ The above copyright notice and this permission notice shall be included in all
65
+ copies or substantial portions of the Software.
66
+
67
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
68
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
69
+ FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
70
+ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
71
+ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
72
+ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
73
+
74
+ ## @lit/reactive-element - 2.1.2 (BSD-3-Clause)
75
+
76
+ BSD 3-Clause License
77
+
78
+ Copyright (c) 2017 Google LLC. All rights reserved.
79
+
80
+ Redistribution and use in source and binary forms, with or without
81
+ modification, are permitted provided that the following conditions are met:
82
+
83
+ 1. Redistributions of source code must retain the above copyright notice, this
84
+ list of conditions and the following disclaimer.
85
+
86
+ 2. Redistributions in binary form must reproduce the above copyright notice,
87
+ this list of conditions and the following disclaimer in the documentation
88
+ and/or other materials provided with the distribution.
89
+
90
+ 3. Neither the name of the copyright holder nor the names of its
91
+ contributors may be used to endorse or promote products derived from
92
+ this software without specific prior written permission.
93
+
94
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
95
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
96
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
97
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
98
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
99
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
100
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
101
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
102
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
103
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
104
+
105
+ ## es-toolkit - 1.52.0 (MIT)
106
+
107
+ MIT License
108
+
109
+ Copyright (c) 2024 Viva Republica, Inc.
110
+
111
+ Permission is hereby granted, free of charge, to any person obtaining a copy
112
+ of this software and associated documentation files (the "Software"), to deal
113
+ in the Software without restriction, including without limitation the rights
114
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
115
+ copies of the Software, and to permit persons to whom the Software is
116
+ furnished to do so, subject to the following conditions:
117
+
118
+ The above copyright notice and this permission notice shall be included in all
119
+ copies or substantial portions of the Software.
120
+
121
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
122
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
123
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
124
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
125
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
126
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
127
+ SOFTWARE.
128
+
129
+ ## lit-element - 4.2.2 (BSD-3-Clause)
130
+
131
+ BSD 3-Clause License
132
+
133
+ Copyright (c) 2017 Google LLC. All rights reserved.
134
+
135
+ Redistribution and use in source and binary forms, with or without
136
+ modification, are permitted provided that the following conditions are met:
137
+
138
+ 1. Redistributions of source code must retain the above copyright notice, this
139
+ list of conditions and the following disclaimer.
140
+
141
+ 2. Redistributions in binary form must reproduce the above copyright notice,
142
+ this list of conditions and the following disclaimer in the documentation
143
+ and/or other materials provided with the distribution.
144
+
145
+ 3. Neither the name of the copyright holder nor the names of its
146
+ contributors may be used to endorse or promote products derived from
147
+ this software without specific prior written permission.
148
+
149
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
150
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
151
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
152
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
153
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
154
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
155
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
156
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
157
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
158
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
159
+
160
+ ## lit-html - 3.3.3 (BSD-3-Clause)
161
+
162
+ BSD 3-Clause License
163
+
164
+ Copyright (c) 2017 Google LLC. All rights reserved.
165
+
166
+ Redistribution and use in source and binary forms, with or without
167
+ modification, are permitted provided that the following conditions are met:
168
+
169
+ 1. Redistributions of source code must retain the above copyright notice, this
170
+ list of conditions and the following disclaimer.
171
+
172
+ 2. Redistributions in binary form must reproduce the above copyright notice,
173
+ this list of conditions and the following disclaimer in the documentation
174
+ and/or other materials provided with the distribution.
175
+
176
+ 3. Neither the name of the copyright holder nor the names of its
177
+ contributors may be used to endorse or promote products derived from
178
+ this software without specific prior written permission.
179
+
180
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
181
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
182
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
183
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
184
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
185
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
186
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
187
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
188
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
189
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
190
+
191
+ ## valibot - 1.5.0 (MIT)
192
+
193
+ MIT License
194
+
195
+ Copyright (c) Fabian Hiller
196
+
197
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
198
+
199
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
200
+
201
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.