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.
- package/CHANGELOG.md +71 -0
- package/CONTRIBUTING.md +124 -0
- package/README.md +49 -14
- package/dist/cli.js +113 -32
- package/dist/commands/checkpoint.js +19 -2
- package/dist/commands/event.js +12 -0
- package/dist/commands/init.js +4 -0
- package/dist/commands/init_manifest.js +131 -0
- package/dist/commands/new.js +57 -21
- package/dist/commands/pack.js +14 -0
- package/dist/commands/query_output.js +2 -0
- package/dist/commands/search.js +8 -0
- package/dist/commands/show.js +7 -0
- package/dist/commands/skill.js +80 -12
- package/dist/commands/task.js +42 -12
- package/dist/commands/upgrade.js +286 -0
- package/dist/commands/validate.js +31 -3
- package/dist/commands/workspace.js +105 -13
- package/dist/core/config.js +217 -22
- package/dist/core/migrate.js +39 -5
- package/dist/core/version.js +31 -0
- package/dist/core/workspace_path.js +41 -0
- package/dist/graph/agent_file_types.js +392 -0
- package/dist/graph/edges.js +13 -10
- package/dist/graph/frontmatter.js +33 -0
- package/dist/graph/indexer.js +1 -0
- package/dist/graph/node.js +43 -16
- package/dist/graph/skills_indexer.js +14 -1
- package/dist/graph/template_schema.js +13 -126
- package/dist/graph/validate_graph.js +302 -2
- package/dist/init/AGENT_START.md +14 -2
- package/dist/init/CLI_COMMAND_MATRIX.md +49 -1
- package/dist/init/README.md +14 -0
- package/dist/init/core/rule-6-templates-and-schemas.md +1 -3
- package/dist/init/init-manifest.json +197 -0
- package/dist/init/legacy/v0.0.9-init-manifest.json +197 -0
- package/dist/init/skills/default/verify-close-and-checkpoint/SKILL.md +12 -11
- package/dist/init/templates/default/dispute.md +31 -0
- package/dist/init/templates/default/feedback.md +27 -0
- package/dist/init/templates/default/proposal.md +35 -0
- package/dist/init/templates/default/receipt.md +31 -0
- package/dist/init/templates/default/spec.md +43 -0
- package/dist/init/templates/default/work.md +44 -0
- package/dist/init/templates/default/work_order.md +32 -0
- package/dist/pack/export_json.js +3 -0
- package/dist/pack/export_md.js +9 -0
- package/dist/pack/export_xml.js +9 -0
- package/dist/pack/order.js +7 -0
- package/dist/pack/pack.js +1 -0
- package/dist/templates/loader.js +2 -2
- package/dist/util/argparse.js +2 -0
- package/dist/util/id.js +19 -0
- package/package.json +10 -2
- 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,
|
|
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.
|
|
32
|
-
4. Use `mdkg task
|
|
33
|
-
5.
|
|
34
|
-
6.
|
|
35
|
-
7.
|
|
36
|
-
8.
|
|
37
|
-
9.
|
|
38
|
-
10.
|
|
39
|
-
11.
|
|
40
|
-
12. If
|
|
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.
|