@brucewaynedecoy/make-docs 1.0.0-rc.1 → 2.0.2

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 (187) hide show
  1. package/LICENSE +21 -201
  2. package/README.md +36 -27
  3. package/dist/backup-73HQNKMC.js +20 -0
  4. package/dist/backup-73HQNKMC.js.map +1 -0
  5. package/dist/chunk-3BAJQXGH.js +1575 -0
  6. package/dist/chunk-3BAJQXGH.js.map +1 -0
  7. package/dist/chunk-64CTKJO7.js +4136 -0
  8. package/dist/chunk-64CTKJO7.js.map +1 -0
  9. package/dist/chunk-BENO4IH5.js +875 -0
  10. package/dist/chunk-BENO4IH5.js.map +1 -0
  11. package/dist/chunk-D4HDZEJT.js +37 -0
  12. package/dist/chunk-D4HDZEJT.js.map +1 -0
  13. package/dist/chunk-G5EF63GG.js +1291 -0
  14. package/dist/chunk-G5EF63GG.js.map +1 -0
  15. package/dist/chunk-GNP6HRVP.js +523 -0
  16. package/dist/chunk-GNP6HRVP.js.map +1 -0
  17. package/dist/chunk-HJYIQTMD.js +204 -0
  18. package/dist/chunk-HJYIQTMD.js.map +1 -0
  19. package/dist/chunk-LQ5NSWCJ.js +39 -0
  20. package/dist/chunk-LQ5NSWCJ.js.map +1 -0
  21. package/dist/chunk-LRVV7UDD.js +2340 -0
  22. package/dist/chunk-LRVV7UDD.js.map +1 -0
  23. package/dist/chunk-LVQSJF63.js +24674 -0
  24. package/dist/chunk-LVQSJF63.js.map +1 -0
  25. package/dist/chunk-MXBHCHSM.js +13995 -0
  26. package/dist/chunk-MXBHCHSM.js.map +1 -0
  27. package/dist/chunk-Z5K4FHYP.js +922 -0
  28. package/dist/chunk-Z5K4FHYP.js.map +1 -0
  29. package/dist/index.js +3798 -250
  30. package/dist/index.js.map +1 -1
  31. package/dist/self-YYXOLDKU.js +653 -0
  32. package/dist/self-YYXOLDKU.js.map +1 -0
  33. package/dist/server-O2ZELIMX.js +512 -0
  34. package/dist/server-O2ZELIMX.js.map +1 -0
  35. package/dist/setup-system-HZROFNMP.js +544 -0
  36. package/dist/setup-system-HZROFNMP.js.map +1 -0
  37. package/dist/{skills-command-3ESCZ75U.js → skills-command-MGGHY7HU.js} +190 -32
  38. package/dist/skills-command-MGGHY7HU.js.map +1 -0
  39. package/dist/uninstall-3UXXXNFO.js +223 -0
  40. package/dist/uninstall-3UXXXNFO.js.map +1 -0
  41. package/dist/virtual_make-docs-first-party-skills-ZII74YOB.js +11 -0
  42. package/dist/virtual_make-docs-first-party-skills-ZII74YOB.js.map +1 -0
  43. package/package.json +9 -6
  44. package/skill-registry.json +328 -125
  45. package/skill-registry.schema.json +221 -45
  46. package/template/.make-docs/AGENTS.md +18 -0
  47. package/template/.make-docs/CLAUDE.md +18 -0
  48. package/template/.make-docs/archive/AGENTS.md +11 -0
  49. package/template/.make-docs/archive/CLAUDE.md +11 -0
  50. package/template/.make-docs/system/AGENTS.md +12 -0
  51. package/template/.make-docs/system/CLAUDE.md +12 -0
  52. package/template/.make-docs/system/contracts/AGENTS.md +13 -0
  53. package/template/.make-docs/system/contracts/CLAUDE.md +13 -0
  54. package/template/{docs/assets/references → .make-docs/system/contracts}/commit-message-convention.md +4 -4
  55. package/template/.make-docs/system/contracts/coverage-pass-contract.md +198 -0
  56. package/template/.make-docs/system/contracts/deferred-obligation-contract.md +128 -0
  57. package/template/{docs/assets/references → .make-docs/system/contracts}/design-contract.md +7 -2
  58. package/template/{docs/assets/references → .make-docs/system/contracts}/guide-contract.md +21 -19
  59. package/template/{docs/assets/references → .make-docs/system/contracts}/history-record-contract.md +17 -11
  60. package/template/.make-docs/system/contracts/human-experience-contract.md +134 -0
  61. package/template/.make-docs/system/contracts/naive-uat-contract.md +231 -0
  62. package/template/.make-docs/system/contracts/output-contract.md +277 -0
  63. package/template/.make-docs/system/contracts/performance-evidence-governance.md +257 -0
  64. package/template/.make-docs/system/contracts/system-resource-contract.md +93 -0
  65. package/template/.make-docs/system/prompts/AGENTS.md +12 -0
  66. package/template/.make-docs/system/prompts/CLAUDE.md +12 -0
  67. package/template/.make-docs/system/prompts/coverage-pass-maintainer-guide.prompt.md +20 -0
  68. package/template/.make-docs/system/prompts/coverage-pass-prd-reconciliation.prompt.md +18 -0
  69. package/template/.make-docs/system/prompts/coverage-pass-testing-uat.prompt.md +46 -0
  70. package/template/.make-docs/system/prompts/coverage-pass-user-guide.prompt.md +20 -0
  71. package/template/.make-docs/system/prompts/designs-to-plan-change.prompt.md +18 -0
  72. package/template/.make-docs/system/prompts/designs-to-plan.prompt.md +14 -0
  73. package/template/.make-docs/system/prompts/docs-path-hygiene-cleanup.prompt.md +29 -0
  74. package/template/.make-docs/system/prompts/naive-uat-facilitator.prompt.md +28 -0
  75. package/template/.make-docs/system/prompts/naive-uat-tester.prompt.md +20 -0
  76. package/template/.make-docs/system/prompts/performance-coverage.prompt.md +63 -0
  77. package/template/.make-docs/system/prompts/plan-to-prd-change.prompt.md +12 -0
  78. package/template/.make-docs/system/prompts/plan-to-prd-green-field.prompt.md +10 -0
  79. package/template/.make-docs/system/prompts/prd-change-to-work.prompt.md +14 -0
  80. package/template/.make-docs/system/prompts/prd-to-work-full-prd.prompt.md +10 -0
  81. package/template/.make-docs/system/prompts/prd-to-work-prd-feature.prompt.md +10 -0
  82. package/template/.make-docs/system/prompts/request-to-design.prompt.md +20 -0
  83. package/template/.make-docs/system/prompts/session-to-history-record.prompt.md +23 -0
  84. package/template/{docs/assets → .make-docs/system}/prompts/work-to-commit-message.prompt.md +2 -2
  85. package/template/.make-docs/system/prompts/work-to-guides.prompt.md +22 -0
  86. package/template/.make-docs/system/references/AGENTS.md +14 -0
  87. package/template/.make-docs/system/references/CLAUDE.md +14 -0
  88. package/template/{docs/assets → .make-docs/system}/references/design-workflow.md +15 -2
  89. package/template/.make-docs/system/references/execution-workflow.md +189 -0
  90. package/template/.make-docs/system/references/human-experience.md +138 -0
  91. package/template/.make-docs/system/references/lifecycle.md +153 -0
  92. package/template/.make-docs/system/references/naive-uat-validation.md +65 -0
  93. package/template/.make-docs/system/references/naive-uat-workflow.md +64 -0
  94. package/template/.make-docs/system/references/path-and-link-hygiene.md +101 -0
  95. package/template/.make-docs/system/references/performance-evidence.md +114 -0
  96. package/template/.make-docs/system/references/planning-workflow.md +209 -0
  97. package/template/.make-docs/system/references/prd-change-management.md +165 -0
  98. package/template/{docs/assets → .make-docs/system}/references/wave-model.md +10 -8
  99. package/template/.make-docs/system/templates/AGENTS.md +12 -0
  100. package/template/.make-docs/system/templates/CLAUDE.md +12 -0
  101. package/template/.make-docs/system/templates/design.md +79 -0
  102. package/template/{docs/assets/templates/guide-developer.md → .make-docs/system/templates/guide-maintainer.md} +7 -3
  103. package/template/{docs/assets → .make-docs/system}/templates/guide-user.md +6 -2
  104. package/template/{docs/assets → .make-docs/system}/templates/history-record.md +6 -3
  105. package/template/.make-docs/system/templates/naive-uat-scenario.md +91 -0
  106. package/template/.make-docs/system/templates/performance-evidence-profile.md +252 -0
  107. package/template/.make-docs/system/templates/plan-overview.md +76 -0
  108. package/template/.make-docs/system/templates/plan-prd-change.md +155 -0
  109. package/template/{docs/assets → .make-docs/system}/templates/plan-prd-decompose.md +10 -0
  110. package/template/{docs/assets → .make-docs/system}/templates/plan-prd.md +28 -2
  111. package/template/{docs/assets → .make-docs/system}/templates/prd-architecture.md +13 -0
  112. package/template/.make-docs/system/templates/prd-glossary.md +28 -0
  113. package/template/.make-docs/system/templates/prd-index.md +70 -0
  114. package/template/{docs/assets → .make-docs/system}/templates/prd-overview.md +13 -0
  115. package/template/.make-docs/system/templates/prd-reference.md +30 -0
  116. package/template/{docs/assets → .make-docs/system}/templates/prd-risk-register.md +16 -1
  117. package/template/{docs/assets → .make-docs/system}/templates/prd-subsystem.md +15 -0
  118. package/template/.make-docs/system/templates/work-index.md +58 -0
  119. package/template/.make-docs/system/templates/work-phase.md +107 -0
  120. package/template/.make-docs/system-resources.catalog.json +91 -0
  121. package/template/.make-docs/system-resources.schema.json +204 -0
  122. package/template/AGENTS.md +8 -1
  123. package/template/CLAUDE.md +8 -1
  124. package/template/docs/AGENTS.codex-only.md +22 -0
  125. package/template/docs/AGENTS.md +21 -13
  126. package/template/docs/CLAUDE.claude-only.md +22 -0
  127. package/template/docs/CLAUDE.md +21 -13
  128. package/template/docs/assets/AGENTS.md +11 -7
  129. package/template/docs/assets/CLAUDE.md +11 -7
  130. package/template/docs/designs/AGENTS.md +8 -3
  131. package/template/docs/designs/CLAUDE.md +8 -3
  132. package/template/docs/plans/AGENTS.md +10 -3
  133. package/template/docs/plans/CLAUDE.md +10 -3
  134. package/template/docs/prd/AGENTS.md +14 -4
  135. package/template/docs/prd/CLAUDE.md +14 -4
  136. package/template/docs/work/AGENTS.md +10 -3
  137. package/template/docs/work/CLAUDE.md +10 -3
  138. package/dist/chunk-HP3HBG7F.js +0 -626
  139. package/dist/chunk-HP3HBG7F.js.map +0 -1
  140. package/dist/chunk-QRFH4J6H.js +0 -1194
  141. package/dist/chunk-QRFH4J6H.js.map +0 -1
  142. package/dist/chunk-WM3OXYTW.js +0 -2630
  143. package/dist/chunk-WM3OXYTW.js.map +0 -1
  144. package/dist/skills-command-3ESCZ75U.js.map +0 -1
  145. package/dist/uninstall-GQE4SJF2.js +0 -150
  146. package/dist/uninstall-GQE4SJF2.js.map +0 -1
  147. package/template/.make-docs/scripts/check_path_hygiene.py +0 -435
  148. package/template/docs/assets/archive/AGENTS.md +0 -20
  149. package/template/docs/assets/archive/CLAUDE.md +0 -20
  150. package/template/docs/assets/history/AGENTS.md +0 -12
  151. package/template/docs/assets/history/CLAUDE.md +0 -12
  152. package/template/docs/assets/prompts/AGENTS.md +0 -8
  153. package/template/docs/assets/prompts/CLAUDE.md +0 -8
  154. package/template/docs/assets/prompts/designs-to-plan-change.prompt.md +0 -14
  155. package/template/docs/assets/prompts/designs-to-plan.prompt.md +0 -10
  156. package/template/docs/assets/prompts/docs-path-hygiene-cleanup.prompt.md +0 -27
  157. package/template/docs/assets/prompts/plan-to-prd-change.prompt.md +0 -8
  158. package/template/docs/assets/prompts/plan-to-prd-green-field.prompt.md +0 -6
  159. package/template/docs/assets/prompts/prd-change-to-work.prompt.md +0 -10
  160. package/template/docs/assets/prompts/prd-to-work-full-prd.prompt.md +0 -6
  161. package/template/docs/assets/prompts/prd-to-work-prd-feature.prompt.md +0 -6
  162. package/template/docs/assets/prompts/request-to-design.prompt.md +0 -16
  163. package/template/docs/assets/prompts/session-to-history-record.prompt.md +0 -19
  164. package/template/docs/assets/prompts/work-to-guides.prompt.md +0 -18
  165. package/template/docs/assets/references/AGENTS.md +0 -9
  166. package/template/docs/assets/references/CLAUDE.md +0 -9
  167. package/template/docs/assets/references/execution-workflow.md +0 -157
  168. package/template/docs/assets/references/output-contract.md +0 -221
  169. package/template/docs/assets/references/path-and-link-hygiene.md +0 -49
  170. package/template/docs/assets/references/planning-workflow.md +0 -160
  171. package/template/docs/assets/references/prd-change-management.md +0 -129
  172. package/template/docs/assets/templates/AGENTS.md +0 -8
  173. package/template/docs/assets/templates/CLAUDE.md +0 -8
  174. package/template/docs/assets/templates/design.md +0 -30
  175. package/template/docs/assets/templates/plan-overview.md +0 -32
  176. package/template/docs/assets/templates/plan-prd-change.md +0 -99
  177. package/template/docs/assets/templates/prd-change-addition.md +0 -45
  178. package/template/docs/assets/templates/prd-change-revision.md +0 -45
  179. package/template/docs/assets/templates/prd-glossary.md +0 -15
  180. package/template/docs/assets/templates/prd-index.md +0 -45
  181. package/template/docs/assets/templates/prd-reference.md +0 -17
  182. package/template/docs/assets/templates/work-index.md +0 -21
  183. package/template/docs/assets/templates/work-phase.md +0 -34
  184. package/template/docs/guides/AGENTS.md +0 -15
  185. package/template/docs/guides/CLAUDE.md +0 -15
  186. /package/template/{docs/assets → .make-docs/system}/prompts/update-readme-green-field.prompt.md +0 -0
  187. /package/template/{docs/assets → .make-docs/system}/references/harness-capability-matrix.md +0 -0
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@brucewaynedecoy/make-docs",
3
- "version": "1.0.0-rc.1",
4
- "description": "Drop-in documentation structure, templates, and AI agent instructions with an NPX installer.",
5
- "license": "Apache-2.0",
3
+ "version": "2.0.2",
4
+ "description": "Plan and maintain project docs with a CLI, MCP server, templates, and optional agent Skills.",
5
+ "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
8
8
  "url": "git+https://github.com/brucewaynedecoy/make-docs.git"
@@ -30,9 +30,9 @@
30
30
  },
31
31
  "scripts": {
32
32
  "build": "tsup",
33
- "dev": "tsx src/index.ts",
33
+ "dev": "npm run build && node dist/index.js",
34
34
  "test": "vitest run",
35
- "validate:defaults": "vitest run tests/consistency.test.ts",
35
+ "validate:defaults": "vitest run tests/consistency.test.ts tests/template-links.test.ts tests/package-safety.test.ts",
36
36
  "prepack": "node ../../scripts/copy-template-to-cli.mjs && npm run build"
37
37
  },
38
38
  "devDependencies": {
@@ -44,6 +44,9 @@
44
44
  },
45
45
  "dependencies": {
46
46
  "@clack/core": "^1.1.0",
47
- "@clack/prompts": "^1.1.0"
47
+ "@clack/prompts": "^1.1.0",
48
+ "@modelcontextprotocol/sdk": "^1.29.0",
49
+ "yaml": "^2.9.0",
50
+ "zod": "^4.4.3"
48
51
  }
49
52
  }
@@ -1,12 +1,136 @@
1
1
  {
2
2
  "$schema": "./skill-registry.schema.json",
3
+ "schemaVersion": 1,
4
+ "manifestId": "make-docs.first-party",
5
+ "displayName": "make-docs first-party skills",
6
+ "description": "First-party make-docs skills grouped by stable purpose ids.",
7
+ "sourcePolicy": {
8
+ "kind": "first-party",
9
+ "label": "First-party make-docs registry",
10
+ "allowRemoteSkillSources": false
11
+ },
12
+ "purposes": [
13
+ {
14
+ "id": "archive-management",
15
+ "label": "Archive management",
16
+ "description": "Archive, relationship tracing, staleness, and deprecation workflows.",
17
+ "order": 10,
18
+ "provenance": {
19
+ "kind": "first-party",
20
+ "label": "make-docs canonical purpose",
21
+ "manifestId": "make-docs.first-party"
22
+ }
23
+ },
24
+ {
25
+ "id": "backlog-review",
26
+ "label": "Backlog review",
27
+ "description": "Portfolio review, attention, status, and recommended-order reporting.",
28
+ "order": 15,
29
+ "provenance": {
30
+ "kind": "first-party",
31
+ "label": "make-docs canonical purpose",
32
+ "manifestId": "make-docs.first-party"
33
+ }
34
+ },
35
+ {
36
+ "id": "codebase-decomposition",
37
+ "label": "Codebase decomposition",
38
+ "description": "Repository analysis and implementation-planning inputs.",
39
+ "order": 20,
40
+ "provenance": {
41
+ "kind": "first-party",
42
+ "label": "make-docs canonical purpose",
43
+ "manifestId": "make-docs.first-party"
44
+ }
45
+ },
46
+ {
47
+ "id": "documentation-maintenance",
48
+ "label": "Documentation maintenance",
49
+ "description": "Cleanup, style, path, link, and documentation hygiene workflows.",
50
+ "order": 30,
51
+ "provenance": {
52
+ "kind": "first-party",
53
+ "label": "make-docs canonical purpose",
54
+ "manifestId": "make-docs.first-party"
55
+ }
56
+ },
57
+ {
58
+ "id": "lifecycle-closeout",
59
+ "label": "Lifecycle closeout",
60
+ "description": "Validation, history, PRD/risk reconciliation, and commit-message preparation.",
61
+ "order": 40,
62
+ "provenance": {
63
+ "kind": "first-party",
64
+ "label": "make-docs canonical purpose",
65
+ "manifestId": "make-docs.first-party"
66
+ }
67
+ },
68
+ {
69
+ "id": "workflow-execution",
70
+ "label": "Workflow execution",
71
+ "description": "Wave and phase execution support.",
72
+ "order": 50,
73
+ "provenance": {
74
+ "kind": "first-party",
75
+ "label": "make-docs canonical purpose",
76
+ "manifestId": "make-docs.first-party"
77
+ }
78
+ },
79
+ {
80
+ "id": "plan-creation",
81
+ "label": "Plan creation",
82
+ "description": "Design-to-plan and planning-prep workflows.",
83
+ "order": 60,
84
+ "provenance": {
85
+ "kind": "first-party",
86
+ "label": "make-docs canonical purpose",
87
+ "manifestId": "make-docs.first-party"
88
+ }
89
+ },
90
+ {
91
+ "id": "migration-support",
92
+ "label": "Migration support",
93
+ "description": "Compatibility, audit, migration, and package-transition support.",
94
+ "order": 70,
95
+ "provenance": {
96
+ "kind": "first-party",
97
+ "label": "make-docs canonical purpose",
98
+ "manifestId": "make-docs.first-party"
99
+ }
100
+ },
101
+ {
102
+ "id": "naive-uat",
103
+ "label": "Unassisted Goal Testing",
104
+ "description": "Access the shared Unassisted Goal Testing workflow.",
105
+ "order": 55,
106
+ "provenance": {
107
+ "kind": "first-party",
108
+ "label": "make-docs canonical purpose",
109
+ "manifestId": "make-docs.first-party"
110
+ }
111
+ }
112
+ ],
3
113
  "skills": [
4
114
  {
5
115
  "name": "archive-docs",
6
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/archive-docs",
116
+ "displayName": "Archive docs",
117
+ "source": "embedded:archive-docs",
7
118
  "entryPoint": "SKILL.md",
8
119
  "installName": "archive-docs",
9
120
  "description": "Relationship-aware archival, staleness detection, deprecation, and impact analysis for docs/ artifacts.",
121
+ "purposes": [
122
+ "archive-management"
123
+ ],
124
+ "supportedHarnesses": [
125
+ "claude-code",
126
+ "codex"
127
+ ],
128
+ "provenance": {
129
+ "kind": "first-party",
130
+ "label": "make-docs embedded first-party Skill",
131
+ "manifestId": "make-docs.first-party",
132
+ "repository": "brucewaynedecoy/make-docs"
133
+ },
10
134
  "assets": [
11
135
  {
12
136
  "source": "agents/openai.yaml",
@@ -23,77 +147,100 @@
23
147
  ]
24
148
  },
25
149
  {
26
- "name": "closeout-commit",
27
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/closeout-commit",
150
+ "name": "backlog-review",
151
+ "displayName": "Backlog Review",
152
+ "source": "embedded:backlog-review",
28
153
  "entryPoint": "SKILL.md",
29
- "installName": "closeout-commit",
30
- "description": "Capture gaps, write history, and draft commit messages for uncommitted changes.",
154
+ "installName": "backlog-review",
155
+ "description": "Review the full Make Docs work portfolio and explain focus, attention, and recommended order.",
156
+ "purposes": [
157
+ "backlog-review"
158
+ ],
159
+ "supportedHarnesses": [
160
+ "claude-code",
161
+ "codex"
162
+ ],
163
+ "provenance": {
164
+ "kind": "first-party",
165
+ "label": "make-docs embedded first-party Skill",
166
+ "manifestId": "make-docs.first-party",
167
+ "repository": "brucewaynedecoy/make-docs"
168
+ },
31
169
  "assets": [
170
+ {
171
+ "source": "README.md",
172
+ "installPath": "README.md"
173
+ },
32
174
  {
33
175
  "source": "agents/openai.yaml",
34
176
  "installPath": "agents/openai.yaml"
35
177
  },
36
178
  {
37
- "source": "references/closeout-commit-workflow.md",
38
- "installPath": "references/closeout-commit-workflow.md"
179
+ "source": "references/review-method.md",
180
+ "installPath": "references/review-method.md"
39
181
  },
40
182
  {
41
- "source": "scripts/closeout_probe.py",
42
- "installPath": "scripts/closeout_probe.py"
183
+ "source": "references/report-model.md",
184
+ "installPath": "references/report-model.md"
43
185
  },
44
186
  {
45
- "source": "scripts/closeout_validate.py",
46
- "installPath": "scripts/closeout_validate.py"
187
+ "source": "references/fallback.md",
188
+ "installPath": "references/fallback.md"
47
189
  },
48
190
  {
49
- "source": "scripts/closeout_history.py",
50
- "installPath": "scripts/closeout_history.py"
51
- }
52
- ]
53
- },
54
- {
55
- "name": "closeout-phase",
56
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/closeout-phase",
57
- "entryPoint": "SKILL.md",
58
- "installName": "closeout-phase",
59
- "description": "Close out completed work backlog phases with checked tasks, acceptance evidence, guides, gap capture, history, and commit-message drafts.",
60
- "assets": [
191
+ "source": "references/cache.md",
192
+ "installPath": "references/cache.md"
193
+ },
61
194
  {
62
- "source": "agents/openai.yaml",
63
- "installPath": "agents/openai.yaml"
195
+ "source": "references/rule-map.md",
196
+ "installPath": "references/rule-map.md"
64
197
  },
65
198
  {
66
- "source": "references/closeout-workflow.md",
67
- "installPath": "references/closeout-workflow.md"
199
+ "source": "examples/chat-reports.md",
200
+ "installPath": "examples/chat-reports.md"
68
201
  },
69
202
  {
70
- "source": "scripts/closeout_probe.py",
71
- "installPath": "scripts/closeout_probe.py"
203
+ "source": "examples/human-errors.json",
204
+ "installPath": "examples/human-errors.json"
72
205
  },
73
206
  {
74
- "source": "scripts/closeout_validate.py",
75
- "installPath": "scripts/closeout_validate.py"
207
+ "source": "references/html-report.md",
208
+ "installPath": "references/html-report.md"
76
209
  },
77
210
  {
78
- "source": "scripts/closeout_history.py",
79
- "installPath": "scripts/closeout_history.py"
211
+ "source": "scripts/render-report.mjs",
212
+ "installPath": "scripts/render-report.mjs"
80
213
  },
81
214
  {
82
- "source": "scripts/work_phase_state.py",
83
- "installPath": "scripts/work_phase_state.py"
215
+ "source": "scripts/collect-project-lead-context.mjs",
216
+ "installPath": "scripts/collect-project-lead-context.mjs"
84
217
  },
85
218
  {
86
- "source": "scripts/guide_coverage_probe.py",
87
- "installPath": "scripts/guide_coverage_probe.py"
219
+ "source": "assets/backlog-review-report.html",
220
+ "installPath": "assets/backlog-review-report.html"
88
221
  }
89
222
  ]
90
223
  },
91
224
  {
92
225
  "name": "cleanup-docs",
93
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/cleanup-docs",
226
+ "displayName": "Clean up docs",
227
+ "source": "embedded:cleanup-docs",
94
228
  "entryPoint": "SKILL.md",
95
229
  "installName": "cleanup-docs",
96
230
  "description": "Audit and clean Markdown docs formatting drift, hard-wrapped prose, list spacing, and document-contract issues.",
231
+ "purposes": [
232
+ "documentation-maintenance"
233
+ ],
234
+ "supportedHarnesses": [
235
+ "claude-code",
236
+ "codex"
237
+ ],
238
+ "provenance": {
239
+ "kind": "first-party",
240
+ "label": "make-docs embedded first-party Skill",
241
+ "manifestId": "make-docs.first-party",
242
+ "repository": "brucewaynedecoy/make-docs"
243
+ },
97
244
  "assets": [
98
245
  {
99
246
  "source": "agents/openai.yaml",
@@ -105,98 +252,27 @@
105
252
  }
106
253
  ]
107
254
  },
108
- {
109
- "name": "work-on-wave",
110
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/work-on-wave",
111
- "entryPoint": "SKILL.md",
112
- "installName": "work-on-wave",
113
- "description": "Work on docs/work waves through implementation, validation, closeout, and phase commits.",
114
- "assets": [
115
- {
116
- "source": "agents/openai.yaml",
117
- "installPath": "agents/openai.yaml"
118
- },
119
- {
120
- "source": "references/wave-implementation-workflow.md",
121
- "installPath": "references/wave-implementation-workflow.md"
122
- },
123
- {
124
- "source": "scripts/work_on_wave_common.py",
125
- "installPath": "scripts/work_on_wave_common.py"
126
- },
127
- {
128
- "source": "scripts/resolve_wave.py",
129
- "installPath": "scripts/resolve_wave.py"
130
- },
131
- {
132
- "source": "scripts/wave_status.py",
133
- "installPath": "scripts/wave_status.py"
134
- },
135
- {
136
- "source": "scripts/phase_plan.py",
137
- "installPath": "scripts/phase_plan.py"
138
- },
139
- {
140
- "source": "scripts/checkpoint.py",
141
- "installPath": "scripts/checkpoint.py"
142
- },
143
- {
144
- "source": "scripts/scope_guard.py",
145
- "installPath": "scripts/scope_guard.py"
146
- },
147
- {
148
- "source": "scripts/phase_gate.py",
149
- "installPath": "scripts/phase_gate.py"
150
- }
151
- ]
152
- },
153
- {
154
- "name": "work-on-phase",
155
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/work-on-phase",
156
- "entryPoint": "SKILL.md",
157
- "installName": "work-on-phase",
158
- "description": "Implement one explicit docs/work phase through planning, validation, closeout, and optional commit.",
159
- "assets": [
160
- {
161
- "source": "agents/openai.yaml",
162
- "installPath": "agents/openai.yaml"
163
- },
164
- {
165
- "source": "references/phase-implementation-workflow.md",
166
- "installPath": "references/phase-implementation-workflow.md"
167
- },
168
- {
169
- "source": "scripts/work_on_wave_common.py",
170
- "installPath": "scripts/work_on_wave_common.py"
171
- },
172
- {
173
- "source": "scripts/resolve_wave.py",
174
- "installPath": "scripts/resolve_wave.py"
175
- },
176
- {
177
- "source": "scripts/phase_plan.py",
178
- "installPath": "scripts/phase_plan.py"
179
- },
180
- {
181
- "source": "scripts/checkpoint.py",
182
- "installPath": "scripts/checkpoint.py"
183
- },
184
- {
185
- "source": "scripts/scope_guard.py",
186
- "installPath": "scripts/scope_guard.py"
187
- },
188
- {
189
- "source": "scripts/phase_gate.py",
190
- "installPath": "scripts/phase_gate.py"
191
- }
192
- ]
193
- },
194
255
  {
195
256
  "name": "decompose-codebase",
196
- "source": "https://github.com/brucewaynedecoy/make-docs/tree/main/packages/skills/decompose-codebase",
257
+ "displayName": "Decompose codebase",
258
+ "source": "embedded:decompose-codebase",
197
259
  "entryPoint": "SKILL.md",
198
260
  "installName": "decompose-codebase",
199
261
  "description": "Plan and reverse-engineer repos into structured PRDs.",
262
+ "purposes": [
263
+ "codebase-decomposition",
264
+ "plan-creation"
265
+ ],
266
+ "supportedHarnesses": [
267
+ "claude-code",
268
+ "codex"
269
+ ],
270
+ "provenance": {
271
+ "kind": "first-party",
272
+ "label": "make-docs embedded first-party Skill",
273
+ "manifestId": "make-docs.first-party",
274
+ "repository": "brucewaynedecoy/make-docs"
275
+ },
200
276
  "assets": [
201
277
  {
202
278
  "source": "agents/openai.yaml",
@@ -271,6 +347,133 @@
271
347
  "installPath": "assets/templates/rebuild-backlog-phase.md"
272
348
  }
273
349
  ]
350
+ },
351
+ {
352
+ "name": "naive-uat",
353
+ "displayName": "Unassisted Goal Testing",
354
+ "source": "embedded:naive-uat",
355
+ "entryPoint": "SKILL.md",
356
+ "installName": "naive-uat",
357
+ "description": "Thin CLI access to the shared Unassisted Goal Testing workflow.",
358
+ "purposes": [
359
+ "naive-uat"
360
+ ],
361
+ "supportedHarnesses": [
362
+ "claude-code",
363
+ "codex"
364
+ ],
365
+ "provenance": {
366
+ "kind": "first-party",
367
+ "label": "make-docs embedded first-party Skill",
368
+ "manifestId": "make-docs.first-party",
369
+ "repository": "brucewaynedecoy/make-docs"
370
+ },
371
+ "assets": []
372
+ },
373
+ {
374
+ "name": "preflight",
375
+ "displayName": "Preflight",
376
+ "source": "embedded:preflight",
377
+ "entryPoint": "SKILL.md",
378
+ "installName": "preflight",
379
+ "description": "Review a named phase and settle needed owner choices. Explicit use only.",
380
+ "purposes": [
381
+ "plan-creation"
382
+ ],
383
+ "supportedHarnesses": [
384
+ "claude-code",
385
+ "codex"
386
+ ],
387
+ "provenance": {
388
+ "kind": "first-party",
389
+ "label": "make-docs embedded first-party Skill",
390
+ "manifestId": "make-docs.first-party",
391
+ "repository": "brucewaynedecoy/make-docs"
392
+ },
393
+ "assets": [
394
+ {
395
+ "source": "agents/openai.yaml",
396
+ "installPath": "agents/openai.yaml"
397
+ },
398
+ {
399
+ "source": "references/decisions.md",
400
+ "installPath": "references/decisions.md"
401
+ },
402
+ {
403
+ "source": "references/store.md",
404
+ "installPath": "references/store.md"
405
+ }
406
+ ]
407
+ },
408
+ {
409
+ "name": "factory",
410
+ "displayName": "Factory",
411
+ "source": "embedded:factory",
412
+ "entryPoint": "SKILL.md",
413
+ "installName": "factory",
414
+ "description": "Coordinate approved backlog work, review, and correction. Explicit use only.",
415
+ "purposes": [
416
+ "workflow-execution"
417
+ ],
418
+ "supportedHarnesses": [
419
+ "claude-code",
420
+ "codex"
421
+ ],
422
+ "provenance": {
423
+ "kind": "first-party",
424
+ "label": "make-docs embedded first-party Skill",
425
+ "manifestId": "make-docs.first-party",
426
+ "repository": "brucewaynedecoy/make-docs"
427
+ },
428
+ "assets": [
429
+ {
430
+ "source": "agents/openai.yaml",
431
+ "installPath": "agents/openai.yaml"
432
+ },
433
+ {
434
+ "source": "references/profiles.md",
435
+ "installPath": "references/profiles.md"
436
+ },
437
+ {
438
+ "source": "references/store.md",
439
+ "installPath": "references/store.md"
440
+ },
441
+ {
442
+ "source": "references/work-methods.md",
443
+ "installPath": "references/work-methods.md"
444
+ }
445
+ ]
446
+ },
447
+ {
448
+ "name": "human-experience",
449
+ "displayName": "Human Experience",
450
+ "source": "embedded:human-experience",
451
+ "entryPoint": "SKILL.md",
452
+ "installName": "human-experience",
453
+ "description": "Shape or review a clear, usable human interaction. Explicit use only.",
454
+ "purposes": [
455
+ "documentation-maintenance"
456
+ ],
457
+ "supportedHarnesses": [
458
+ "claude-code",
459
+ "codex"
460
+ ],
461
+ "provenance": {
462
+ "kind": "first-party",
463
+ "label": "make-docs embedded first-party Skill",
464
+ "manifestId": "make-docs.first-party",
465
+ "repository": "brucewaynedecoy/make-docs"
466
+ },
467
+ "assets": [
468
+ {
469
+ "source": "agents/openai.yaml",
470
+ "installPath": "agents/openai.yaml"
471
+ },
472
+ {
473
+ "source": "references/surfaces.md",
474
+ "installPath": "references/surfaces.md"
475
+ }
476
+ ]
274
477
  }
275
478
  ]
276
479
  }