mdkg 0.0.8 → 0.1.0

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.
Files changed (54) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/CONTRIBUTING.md +124 -0
  3. package/README.md +49 -14
  4. package/dist/cli.js +113 -32
  5. package/dist/commands/checkpoint.js +19 -2
  6. package/dist/commands/event.js +12 -0
  7. package/dist/commands/init.js +4 -0
  8. package/dist/commands/init_manifest.js +131 -0
  9. package/dist/commands/new.js +57 -21
  10. package/dist/commands/pack.js +14 -0
  11. package/dist/commands/query_output.js +2 -0
  12. package/dist/commands/search.js +8 -0
  13. package/dist/commands/show.js +7 -0
  14. package/dist/commands/skill.js +80 -12
  15. package/dist/commands/task.js +42 -12
  16. package/dist/commands/upgrade.js +286 -0
  17. package/dist/commands/validate.js +31 -3
  18. package/dist/commands/workspace.js +105 -13
  19. package/dist/core/config.js +217 -22
  20. package/dist/core/migrate.js +39 -5
  21. package/dist/core/version.js +31 -0
  22. package/dist/core/workspace_path.js +41 -0
  23. package/dist/graph/agent_file_types.js +392 -0
  24. package/dist/graph/edges.js +13 -10
  25. package/dist/graph/frontmatter.js +33 -0
  26. package/dist/graph/indexer.js +1 -0
  27. package/dist/graph/node.js +43 -16
  28. package/dist/graph/skills_indexer.js +14 -1
  29. package/dist/graph/template_schema.js +13 -126
  30. package/dist/graph/validate_graph.js +302 -2
  31. package/dist/init/AGENT_START.md +14 -2
  32. package/dist/init/CLI_COMMAND_MATRIX.md +49 -1
  33. package/dist/init/README.md +14 -0
  34. package/dist/init/core/rule-6-templates-and-schemas.md +1 -3
  35. package/dist/init/init-manifest.json +197 -0
  36. package/dist/init/legacy/v0.0.9-init-manifest.json +197 -0
  37. package/dist/init/skills/default/verify-close-and-checkpoint/SKILL.md +12 -11
  38. package/dist/init/templates/default/dispute.md +31 -0
  39. package/dist/init/templates/default/feedback.md +27 -0
  40. package/dist/init/templates/default/proposal.md +35 -0
  41. package/dist/init/templates/default/receipt.md +31 -0
  42. package/dist/init/templates/default/spec.md +43 -0
  43. package/dist/init/templates/default/work.md +44 -0
  44. package/dist/init/templates/default/work_order.md +32 -0
  45. package/dist/pack/export_json.js +3 -0
  46. package/dist/pack/export_md.js +9 -0
  47. package/dist/pack/export_xml.js +9 -0
  48. package/dist/pack/order.js +7 -0
  49. package/dist/pack/pack.js +1 -0
  50. package/dist/templates/loader.js +2 -2
  51. package/dist/util/argparse.js +2 -0
  52. package/dist/util/id.js +19 -0
  53. package/package.json +10 -2
  54. package/scripts/postinstall.js +89 -0
@@ -0,0 +1,197 @@
1
+ {
2
+ "schema_version": 1,
3
+ "tool": "mdkg",
4
+ "mdkg_version": "0.1.0",
5
+ "files": [
6
+ {
7
+ "path": ".mdkg/config.json",
8
+ "category": "config",
9
+ "sha256": "eb76bf22ae9d04601c2fedac5fd22838797dd2cc829324638a6b69222d40aaa9"
10
+ },
11
+ {
12
+ "path": ".mdkg/core/core.md",
13
+ "category": "core",
14
+ "sha256": "d87beecf4229535c0d0feea7deae28b97d0681105a1c282d9961e97918f0bbe8"
15
+ },
16
+ {
17
+ "path": ".mdkg/core/guide.md",
18
+ "category": "core",
19
+ "sha256": "0b0ba51fbc393b3d5e0a0df4dece6aa822b77ab0f4ee3814b2cdba77ef8b65d9"
20
+ },
21
+ {
22
+ "path": ".mdkg/core/HUMAN.md",
23
+ "category": "core",
24
+ "sha256": "75d2e015cd5ba61062cb84246017ee4f4221610d4a56e4a0b332271b90694965"
25
+ },
26
+ {
27
+ "path": ".mdkg/core/rule-1-mdkg-conventions.md",
28
+ "category": "core",
29
+ "sha256": "20073cd21c148f1b93a382550f835ccb2e896cc676903328557004319235c112"
30
+ },
31
+ {
32
+ "path": ".mdkg/core/rule-2-context-pack-rules.md",
33
+ "category": "core",
34
+ "sha256": "9dfd46b5ae791220c68304abc0784399509cf606821c937671cf63d6e9a8ce8f"
35
+ },
36
+ {
37
+ "path": ".mdkg/core/rule-3-cli-contract.md",
38
+ "category": "core",
39
+ "sha256": "b547a6edc20112013c607a033af4ac0c6bb3f9d66d445b0c545b2890a721b671"
40
+ },
41
+ {
42
+ "path": ".mdkg/core/rule-4-repo-safety-and-ignores.md",
43
+ "category": "core",
44
+ "sha256": "d7fc4bfa3727ed7d5353eeb0089ad818b96a755578e217251106422559750291"
45
+ },
46
+ {
47
+ "path": ".mdkg/core/rule-5-release-and-versioning.md",
48
+ "category": "core",
49
+ "sha256": "4fc6648052f80b90b2efc173e3bcab16cb0bc6680bb8b04f76c66fff06ad19cd"
50
+ },
51
+ {
52
+ "path": ".mdkg/core/rule-6-templates-and-schemas.md",
53
+ "category": "core",
54
+ "sha256": "0d6da477c12e3492f43c571a6e4daa373bf05005ef703ad5166b7c8786e553b0"
55
+ },
56
+ {
57
+ "path": ".mdkg/core/SOUL.md",
58
+ "category": "core",
59
+ "sha256": "2bfdd4d1a65dd18c14d3e8469d0d5c74c6cc7c067f0b56d227532b7ab620795a"
60
+ },
61
+ {
62
+ "path": ".mdkg/README.md",
63
+ "category": "mdkg_doc",
64
+ "sha256": "26e99be382b48682b7841f14404576f79bf6876b64a90aefa6c99c2440701d2a"
65
+ },
66
+ {
67
+ "path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
68
+ "category": "default_skill",
69
+ "sha256": "7f6104980e6b2ec0749881c6be2bd3d7982702259c4979763266d1c800aeb410"
70
+ },
71
+ {
72
+ "path": ".mdkg/skills/select-work-and-ground-context/SKILL.md",
73
+ "category": "default_skill",
74
+ "sha256": "c8c04134532deda079f9ee290a66b2423892f9789fa946e44db4c89c05b8e1bf"
75
+ },
76
+ {
77
+ "path": ".mdkg/skills/verify-close-and-checkpoint/SKILL.md",
78
+ "category": "default_skill",
79
+ "sha256": "98a1b02927854201eeea73e3d7c9f5a104fab7a5c72e033ea261995341a8a7ce"
80
+ },
81
+ {
82
+ "path": ".mdkg/templates/default/bug.md",
83
+ "category": "template",
84
+ "sha256": "88e3f8d67aa3b2156be2006bd1c8139b7b16b46f2c05a4f4d840b3746a40f9c5"
85
+ },
86
+ {
87
+ "path": ".mdkg/templates/default/chk.md",
88
+ "category": "template",
89
+ "sha256": "15f793e422009c76f8bda72c3609157acd7f03762d9c9bdb096c4aa2e2c3fb89"
90
+ },
91
+ {
92
+ "path": ".mdkg/templates/default/dec.md",
93
+ "category": "template",
94
+ "sha256": "a2f7098fea538c153ac290f2e2edb2e755ca9dd07d17c2a127fb23959517ece9"
95
+ },
96
+ {
97
+ "path": ".mdkg/templates/default/dispute.md",
98
+ "category": "template",
99
+ "sha256": "b1c5330fd4a1e3f03dbb4ac8907bd728e55537e053dcf43ebcbdc835ff1d0579"
100
+ },
101
+ {
102
+ "path": ".mdkg/templates/default/edd.md",
103
+ "category": "template",
104
+ "sha256": "44828719927cfd31389b9d55b57fc4fa9bc640f3e2475baefe585e4043740f5e"
105
+ },
106
+ {
107
+ "path": ".mdkg/templates/default/epic.md",
108
+ "category": "template",
109
+ "sha256": "56697b69af027fe08c00866c0c0670f7d7e2a0857803bd4aabb99f4761311879"
110
+ },
111
+ {
112
+ "path": ".mdkg/templates/default/feat.md",
113
+ "category": "template",
114
+ "sha256": "99cfdd97b40b119cf899fd766d816c07b7daaafd8ec8e70e6c6de5c0d37f581c"
115
+ },
116
+ {
117
+ "path": ".mdkg/templates/default/feedback.md",
118
+ "category": "template",
119
+ "sha256": "61ad7b8b717d17736ba505f814fa6e4f9ec61f7fe4ae6622359304620a99d649"
120
+ },
121
+ {
122
+ "path": ".mdkg/templates/default/prd.md",
123
+ "category": "template",
124
+ "sha256": "afee167576a4f881ab191867e118864b7b5629e14b9c4a61359c8fbd7ececeee"
125
+ },
126
+ {
127
+ "path": ".mdkg/templates/default/prop.md",
128
+ "category": "template",
129
+ "sha256": "839b976a8ddc0d6abddfbe6114dfb87f64471958ae807c011538777b758aa1f0"
130
+ },
131
+ {
132
+ "path": ".mdkg/templates/default/proposal.md",
133
+ "category": "template",
134
+ "sha256": "16bfa81b6e665064e93e0d1b625dccc518b9885f87a32a15e5ba5441c2c27ea8"
135
+ },
136
+ {
137
+ "path": ".mdkg/templates/default/receipt.md",
138
+ "category": "template",
139
+ "sha256": "aac6e6e27153a1ca85a515b03f0ac55db3eb0df3f9243c42f0b936f5e5a750b2"
140
+ },
141
+ {
142
+ "path": ".mdkg/templates/default/rule.md",
143
+ "category": "template",
144
+ "sha256": "6321abf72af61a6513d7bfaa2d3122b2aa3bd2b95b662a52d569fb2bf819fda1"
145
+ },
146
+ {
147
+ "path": ".mdkg/templates/default/spec.md",
148
+ "category": "template",
149
+ "sha256": "e3e05d8d627c478d2757451f61b5a8fda8a75da9885a9261b2f8f5cb8a3a36dc"
150
+ },
151
+ {
152
+ "path": ".mdkg/templates/default/task.md",
153
+ "category": "template",
154
+ "sha256": "f6385dd4f56f1c8df164ac3e79d82c5a3fde3f952dc9cdc78c0b8077caa62277"
155
+ },
156
+ {
157
+ "path": ".mdkg/templates/default/test.md",
158
+ "category": "template",
159
+ "sha256": "bdae53e5cb4bd77712da155bbcfc24409ced8162c977e6bc478a9d1e695ddef7"
160
+ },
161
+ {
162
+ "path": ".mdkg/templates/default/work_order.md",
163
+ "category": "template",
164
+ "sha256": "bdbdf6e34d59976a675dd1d25002dfc0ef49e725647c97a9e0b3552c93fb8600"
165
+ },
166
+ {
167
+ "path": ".mdkg/templates/default/work.md",
168
+ "category": "template",
169
+ "sha256": "651b7339f6e23c8745264f3f6641a0c82fcd765247f0a70a9f407a118a49ec00"
170
+ },
171
+ {
172
+ "path": "AGENT_START.md",
173
+ "category": "startup_doc",
174
+ "sha256": "be0990bb81e194a2a396f9520cda66c34d0bbbd36daa5b48773246549aacab2e"
175
+ },
176
+ {
177
+ "path": "AGENTS.md",
178
+ "category": "agent_doc",
179
+ "sha256": "9e33a1c20320e317e1e37dbb09fd0303e355b9e7d49cf2128fe791aaa2ce2fb1"
180
+ },
181
+ {
182
+ "path": "CLAUDE.md",
183
+ "category": "agent_doc",
184
+ "sha256": "3ff3ec5560968f7f1bf6f7d34a3c4b6e636edc9f0d45f717cdebc4df3b76403a"
185
+ },
186
+ {
187
+ "path": "CLI_COMMAND_MATRIX.md",
188
+ "category": "startup_doc",
189
+ "sha256": "eb441dd11b31270ddb31f0a77c75fc744671754cffac3aa8ac6f60e30a1f324f"
190
+ },
191
+ {
192
+ "path": "llms.txt",
193
+ "category": "startup_doc",
194
+ "sha256": "8316bb8f634c6fb290ef1591e9c5b9786a2ddc06d25ab7d448fce8f4aebf65b8"
195
+ }
196
+ ]
197
+ }
@@ -0,0 +1,197 @@
1
+ {
2
+ "schema_version": 1,
3
+ "tool": "mdkg",
4
+ "mdkg_version": "0.0.9",
5
+ "files": [
6
+ {
7
+ "path": ".mdkg/config.json",
8
+ "category": "config",
9
+ "sha256": "eb76bf22ae9d04601c2fedac5fd22838797dd2cc829324638a6b69222d40aaa9"
10
+ },
11
+ {
12
+ "path": ".mdkg/core/HUMAN.md",
13
+ "category": "core",
14
+ "sha256": "75d2e015cd5ba61062cb84246017ee4f4221610d4a56e4a0b332271b90694965"
15
+ },
16
+ {
17
+ "path": ".mdkg/core/SOUL.md",
18
+ "category": "core",
19
+ "sha256": "2bfdd4d1a65dd18c14d3e8469d0d5c74c6cc7c067f0b56d227532b7ab620795a"
20
+ },
21
+ {
22
+ "path": ".mdkg/core/core.md",
23
+ "category": "core",
24
+ "sha256": "d87beecf4229535c0d0feea7deae28b97d0681105a1c282d9961e97918f0bbe8"
25
+ },
26
+ {
27
+ "path": ".mdkg/core/guide.md",
28
+ "category": "core",
29
+ "sha256": "0b0ba51fbc393b3d5e0a0df4dece6aa822b77ab0f4ee3814b2cdba77ef8b65d9"
30
+ },
31
+ {
32
+ "path": ".mdkg/core/rule-1-mdkg-conventions.md",
33
+ "category": "core",
34
+ "sha256": "20073cd21c148f1b93a382550f835ccb2e896cc676903328557004319235c112"
35
+ },
36
+ {
37
+ "path": ".mdkg/core/rule-2-context-pack-rules.md",
38
+ "category": "core",
39
+ "sha256": "9dfd46b5ae791220c68304abc0784399509cf63d6e9a8ce8f"
40
+ },
41
+ {
42
+ "path": ".mdkg/core/rule-3-cli-contract.md",
43
+ "category": "core",
44
+ "sha256": "b547a6edc20112013c607a033af4ac0c6bb3f9d66d445b0c545b2890a721b671"
45
+ },
46
+ {
47
+ "path": ".mdkg/core/rule-4-repo-safety-and-ignores.md",
48
+ "category": "core",
49
+ "sha256": "d7fc4bfa3727ed7d5353eeb0089ad818b96a755578e217251106422559750291"
50
+ },
51
+ {
52
+ "path": ".mdkg/core/rule-5-release-and-versioning.md",
53
+ "category": "core",
54
+ "sha256": "4fc6648052f80b90b2efc173e3bcab16cb0bc6680bb8b04f76c66fff06ad19cd"
55
+ },
56
+ {
57
+ "path": ".mdkg/core/rule-6-templates-and-schemas.md",
58
+ "category": "core",
59
+ "sha256": "0d6da477c12e3492f43c571a6e4daa373bf05005ef703ad5166b7c8786e553b0"
60
+ },
61
+ {
62
+ "path": ".mdkg/README.md",
63
+ "category": "mdkg_doc",
64
+ "sha256": "580ed58d4406783f79dd839902de3238647c99605e0849a87ca19a6bd9c738a2"
65
+ },
66
+ {
67
+ "path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
68
+ "category": "default_skill",
69
+ "sha256": "7f6104980e6b2ec0749881c6be2bd3d7982702259c4979763266d1c800aeb410"
70
+ },
71
+ {
72
+ "path": ".mdkg/skills/select-work-and-ground-context/SKILL.md",
73
+ "category": "default_skill",
74
+ "sha256": "c8c04134532deda079f9ee290a66b2423892f9789fa946e44db4c89c05b8e1bf"
75
+ },
76
+ {
77
+ "path": ".mdkg/skills/verify-close-and-checkpoint/SKILL.md",
78
+ "category": "default_skill",
79
+ "sha256": "1d1bbb2cb09d13bc469706e60c38f883457d507144a33fd2675a7c1c48118132"
80
+ },
81
+ {
82
+ "path": ".mdkg/templates/default/bug.md",
83
+ "category": "template",
84
+ "sha256": "88e3f8d67aa3b2156be2006bd1c8139b7b16b46f2c05a4f4d840b3746a40f9c5"
85
+ },
86
+ {
87
+ "path": ".mdkg/templates/default/chk.md",
88
+ "category": "template",
89
+ "sha256": "15f793e422009c76f8bda72c3609157acd7f03762d9c9bdb096c4aa2e2c3fb89"
90
+ },
91
+ {
92
+ "path": ".mdkg/templates/default/dec.md",
93
+ "category": "template",
94
+ "sha256": "a2f7098fea538c153ac290f2e2edb2e755ca9dd07d17c2a127fb23959517ece9"
95
+ },
96
+ {
97
+ "path": ".mdkg/templates/default/dispute.md",
98
+ "category": "template",
99
+ "sha256": "b1c5330fd4a1e3f03dbb4ac8907bd728e55537e053dcf43ebcbdc835ff1d0579"
100
+ },
101
+ {
102
+ "path": ".mdkg/templates/default/edd.md",
103
+ "category": "template",
104
+ "sha256": "44828719927cfd31389b9d55b57fc4fa9bc640f3e2475baefe585e4043740f5e"
105
+ },
106
+ {
107
+ "path": ".mdkg/templates/default/epic.md",
108
+ "category": "template",
109
+ "sha256": "56697b69af027fe08c00866c0c0670f7d7e2a0857803bd4aabb99f4761311879"
110
+ },
111
+ {
112
+ "path": ".mdkg/templates/default/feat.md",
113
+ "category": "template",
114
+ "sha256": "99cfdd97b40b119cf899fd766d816c07b7daaafd8ec8e70e6c6de5c0d37f581c"
115
+ },
116
+ {
117
+ "path": ".mdkg/templates/default/feedback.md",
118
+ "category": "template",
119
+ "sha256": "61ad7b8b717d17736ba505f814fa6e4f9ec61f7fe4ae6622359304620a99d649"
120
+ },
121
+ {
122
+ "path": ".mdkg/templates/default/prd.md",
123
+ "category": "template",
124
+ "sha256": "afee167576a4f881ab191867e118864b7b5629e14b9c4a61359c8fbd7ececeee"
125
+ },
126
+ {
127
+ "path": ".mdkg/templates/default/prop.md",
128
+ "category": "template",
129
+ "sha256": "839b976a8ddc0d6abddfbe6114dfb87f64471958ae807c011538777b758aa1f0"
130
+ },
131
+ {
132
+ "path": ".mdkg/templates/default/proposal.md",
133
+ "category": "template",
134
+ "sha256": "16bfa81b6e665064e93e0d1b625dccc518b9885f87a32a15e5ba5441c2c27ea8"
135
+ },
136
+ {
137
+ "path": ".mdkg/templates/default/receipt.md",
138
+ "category": "template",
139
+ "sha256": "aac6e6e27153a1ca85a515b03f0ac55db3eb0df3f9243c42f0b936f5e5a750b2"
140
+ },
141
+ {
142
+ "path": ".mdkg/templates/default/rule.md",
143
+ "category": "template",
144
+ "sha256": "6321abf72af61a6513d7bfaa2d3122b2aa3bd2b95b662a52d569fb2bf819fda1"
145
+ },
146
+ {
147
+ "path": ".mdkg/templates/default/spec.md",
148
+ "category": "template",
149
+ "sha256": "e3e05d8d627c478d2757451f61b5a8fda8a75da9885a9261b2f8f5cb8a3a36dc"
150
+ },
151
+ {
152
+ "path": ".mdkg/templates/default/task.md",
153
+ "category": "template",
154
+ "sha256": "f6385dd4f56f1c8df164ac3e79d82c5a3fde3f952dc9cdc78c0b8077caa62277"
155
+ },
156
+ {
157
+ "path": ".mdkg/templates/default/test.md",
158
+ "category": "template",
159
+ "sha256": "bdae53e5cb4bd77712da155bbcfc24409ced8162c977e6bc478a9d1e695ddef7"
160
+ },
161
+ {
162
+ "path": ".mdkg/templates/default/work.md",
163
+ "category": "template",
164
+ "sha256": "651b7339f6e23c8745264f3f6641a0c82fcd765247f0a70a9f407a118a49ec00"
165
+ },
166
+ {
167
+ "path": ".mdkg/templates/default/work_order.md",
168
+ "category": "template",
169
+ "sha256": "bdbdf6e34d59976a675dd1d25002dfc0ef49e725647c97a9e0b3552c93fb8600"
170
+ },
171
+ {
172
+ "path": "AGENTS.md",
173
+ "category": "agent_doc",
174
+ "sha256": "9e33a1c20320e317e1e37dbb09fd0303e355b9e7d49cf2128fe791aaa2ce2fb1"
175
+ },
176
+ {
177
+ "path": "AGENT_START.md",
178
+ "category": "startup_doc",
179
+ "sha256": "ef8ec5feedbac948a1c63d14c5fff5bb41e3903d9de2c2b3e4db779278ff1b19"
180
+ },
181
+ {
182
+ "path": "CLAUDE.md",
183
+ "category": "agent_doc",
184
+ "sha256": "3ff3ec5560968f7f1bf6f7d34a3c4b6e636edc9f0d45f717cdebc4df3b76403a"
185
+ },
186
+ {
187
+ "path": "CLI_COMMAND_MATRIX.md",
188
+ "category": "startup_doc",
189
+ "sha256": "e39f45786eaf0cef07cc6fecd0c230474cfd7ee016a3736128566325cef73519"
190
+ },
191
+ {
192
+ "path": "llms.txt",
193
+ "category": "startup_doc",
194
+ "sha256": "8316bb8f634c6fb290ef1591e9c5b9786a2ddc06d25ab7d448fce8f4aebf65b8"
195
+ }
196
+ ]
197
+ }
@@ -4,7 +4,7 @@ description: Verify code and mdkg state, attach evidence, and close work cleanly
4
4
  tags: [stage:review, writer:orchestrator, mdkg, validation, release]
5
5
  version: 0.1.0
6
6
  authors: [mdkg]
7
- links: [README.md, AGENT_PROMPT_SNIPPET.md]
7
+ links: [README.md, AGENT_START.md]
8
8
  ---
9
9
 
10
10
  # Goal
@@ -28,16 +28,17 @@ Finish work with evidence, validation, and minimal memory drift.
28
28
 
29
29
  1. Run the relevant technical gates for the changed surface.
30
30
  2. Run `mdkg validate` before closing the task.
31
- 3. Use `mdkg task update <id> ...` for additive evidence and structured metadata changes; keep narrative/body edits in markdown.
32
- 4. Use `mdkg task done <id> --checkpoint "<title>"` when the task should close with milestone compression.
33
- 5. Batch durable mdkg writes at one boundary: task status, artifact refs, optional checkpoint, and commit.
34
- 6. Mark tasks done only after evidence exists.
35
- 7. Create a checkpoint only for milestone-level transitions, not every small step.
36
- 8. For feat or epic closeout, prefer a checkpoint body as the durable narrative summary of what changed and what is next.
37
- 9. Use feat closeout scope as direct children with `parent: <feat-id>` and epic closeout scope as descendant work with `epic: <epic-id>`.
38
- 10. Parent status edits remain manual; do not invent a hidden parent-closeout workflow.
39
- 11. If the latest checkpoint is relevant, use it as durable recall; treat raw events as provenance/debugging, not primary execution context.
40
- 12. If `events.jsonl` is missing, recreate it with `mdkg event enable` before expecting automatic JSONL provenance.
31
+ 3. For mdkg scaffold or release work, include `mdkg upgrade` dry-run/apply evidence and any package smoke that exercises upgrade behavior.
32
+ 4. Use `mdkg task update <id> ...` for additive evidence and structured metadata changes; keep narrative/body edits in markdown.
33
+ 5. Use `mdkg task done <id> --checkpoint "<title>"` when the task should close with milestone compression.
34
+ 6. Batch durable mdkg writes at one boundary: task status, artifact refs, optional checkpoint, and commit.
35
+ 7. Mark tasks done only after evidence exists.
36
+ 8. Create a checkpoint only for milestone-level transitions, not every small step.
37
+ 9. For feat or epic closeout, prefer a checkpoint body as the durable narrative summary of what changed and what is next.
38
+ 10. Use feat closeout scope as direct children with `parent: <feat-id>` and epic closeout scope as descendant work with `epic: <epic-id>`.
39
+ 11. Parent status edits remain manual; do not invent a hidden parent-closeout workflow.
40
+ 12. If the latest checkpoint is relevant, use it as durable recall; treat raw events as provenance/debugging, not primary execution context.
41
+ 13. If `events.jsonl` is missing, recreate it with `mdkg event enable` before expecting automatic JSONL provenance.
41
42
 
42
43
  ## Outputs
43
44
 
@@ -0,0 +1,31 @@
1
+ ---
2
+ id: {{id}}
3
+ type: dispute
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ work_order_id: order.example
7
+ receipt_id: receipt.example
8
+ dispute_status: open
9
+ severity: medium
10
+ tags: []
11
+ owners: []
12
+ links: []
13
+ artifacts: []
14
+ relates: []
15
+ refs: []
16
+ aliases: []
17
+ created: {{created}}
18
+ updated: {{updated}}
19
+ ---
20
+
21
+ # Dispute
22
+
23
+ Capture the dispute or report summary.
24
+
25
+ # Evidence
26
+
27
+ List evidence references without secrets.
28
+
29
+ # Resolution
30
+
31
+ Record review outcome when available.
@@ -0,0 +1,27 @@
1
+ ---
2
+ id: {{id}}
3
+ type: feedback
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ target_id: work.example
7
+ sentiment: neutral
8
+ feedback_status: new
9
+ source_ref: user.example
10
+ tags: []
11
+ owners: []
12
+ links: []
13
+ artifacts: []
14
+ relates: []
15
+ refs: []
16
+ aliases: []
17
+ created: {{created}}
18
+ updated: {{updated}}
19
+ ---
20
+
21
+ # Feedback
22
+
23
+ Capture high-signal feedback without raw secrets.
24
+
25
+ # Evidence
26
+
27
+ List supporting references and artifacts.
@@ -0,0 +1,35 @@
1
+ ---
2
+ id: {{id}}
3
+ type: proposal
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ target_id: work.example
7
+ proposal_status: proposed
8
+ proposal_kind: work_update
9
+ evidence_refs: []
10
+ tags: []
11
+ owners: []
12
+ links: []
13
+ artifacts: []
14
+ relates: []
15
+ refs: []
16
+ aliases: []
17
+ created: {{created}}
18
+ updated: {{updated}}
19
+ ---
20
+
21
+ # Summary
22
+
23
+ Summarize the improvement proposal.
24
+
25
+ # Evidence
26
+
27
+ List feedback, receipts, disputes, or other evidence.
28
+
29
+ # Proposed Change
30
+
31
+ Describe the proposed update to a SPEC.md, WORK.md, or SKILL.md.
32
+
33
+ # Review
34
+
35
+ Capture review status and next decision points.
@@ -0,0 +1,31 @@
1
+ ---
2
+ id: {{id}}
3
+ type: receipt
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ work_order_id: order.example
7
+ receipt_status: recorded
8
+ outcome: success
9
+ cost_ref: cost.redacted
10
+ tags: []
11
+ owners: []
12
+ links: []
13
+ artifacts: []
14
+ relates: []
15
+ refs: []
16
+ aliases: []
17
+ created: {{created}}
18
+ updated: {{updated}}
19
+ ---
20
+
21
+ # Outcome
22
+
23
+ Record the result and proof summary.
24
+
25
+ # Artifacts
26
+
27
+ List committed artifact references.
28
+
29
+ # Notes
30
+
31
+ Capture non-secret execution notes.
@@ -0,0 +1,43 @@
1
+ ---
2
+ id: {{id}}
3
+ type: spec
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ role: subagent
7
+ runtime_mode: room_orchestrated
8
+ work_contracts: []
9
+ requested_capabilities: []
10
+ skill_refs: []
11
+ tool_refs: []
12
+ model_refs: []
13
+ wasm_component_refs: []
14
+ runtime_image_refs: []
15
+ subagent_refs: []
16
+ resource_profile: builder
17
+ update_policy: manual
18
+ tags: []
19
+ owners: []
20
+ links: []
21
+ artifacts: []
22
+ relates: []
23
+ refs: []
24
+ aliases: []
25
+ created: {{created}}
26
+ updated: {{updated}}
27
+ ---
28
+
29
+ # Purpose
30
+
31
+ Define the agent, package, or runtime specification.
32
+
33
+ # Runtime
34
+
35
+ Describe role, runtime mode, resource profile, and update policy.
36
+
37
+ # Work Contracts
38
+
39
+ List related WORK.md contracts.
40
+
41
+ # Capabilities
42
+
43
+ List requested capabilities and relevant constraints.
@@ -0,0 +1,44 @@
1
+ ---
2
+ id: {{id}}
3
+ type: work
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ agent_id: agent.example
7
+ kind: generic
8
+ pricing_model: quoted
9
+ required_capabilities: []
10
+ skill_refs: []
11
+ tool_refs: []
12
+ model_refs: []
13
+ wasm_component_refs: []
14
+ runtime_image_refs: []
15
+ subagent_refs: []
16
+ inputs: [request:text:required]
17
+ outputs: [result:text:required]
18
+ receipt_required: true
19
+ tags: []
20
+ owners: []
21
+ links: []
22
+ artifacts: []
23
+ relates: []
24
+ refs: []
25
+ aliases: []
26
+ created: {{created}}
27
+ updated: {{updated}}
28
+ ---
29
+
30
+ # Capability
31
+
32
+ Describe the reusable capability contract.
33
+
34
+ # Inputs
35
+
36
+ Document input descriptors and validation expectations.
37
+
38
+ # Outputs
39
+
40
+ Document output descriptors and artifact expectations.
41
+
42
+ # Receipt
43
+
44
+ Describe required receipt evidence.
@@ -0,0 +1,32 @@
1
+ ---
2
+ id: {{id}}
3
+ type: work_order
4
+ title: {{title}}
5
+ version: 0.1.0
6
+ work_id: work.example
7
+ work_version: 0.1.0
8
+ requester: user.example
9
+ order_status: submitted
10
+ request_ref: request.example
11
+ tags: []
12
+ owners: []
13
+ links: []
14
+ artifacts: []
15
+ relates: []
16
+ refs: []
17
+ aliases: []
18
+ created: {{created}}
19
+ updated: {{updated}}
20
+ ---
21
+
22
+ # Request
23
+
24
+ Capture the concrete request against a WORK.md version.
25
+
26
+ # Inputs
27
+
28
+ Record committed input references without secrets.
29
+
30
+ # Constraints
31
+
32
+ Capture relevant policy, budget, and artifact constraints.