@t275005746/gse 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 (207) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -0
  2. package/.github/ISSUE_TEMPLATE/change_request.yml +50 -0
  3. package/.github/ISSUE_TEMPLATE/config.yml +5 -0
  4. package/.github/PULL_REQUEST_TEMPLATE.md +38 -0
  5. package/.github/workflows/validate-gse.yml +33 -0
  6. package/.gse/README.md +18 -0
  7. package/.gse/gse-development-protocol.md +50 -0
  8. package/.gse/project-profile.md +29 -0
  9. package/.gse/quality-gates.md +25 -0
  10. package/.gse/releases/public-channel-publication-pending.md +49 -0
  11. package/.gse/releases/public-ci-run-pending.md +53 -0
  12. package/.gse/releases/public-release-owner-required.md +65 -0
  13. package/.gse/releases/public-repository-settings-owner-required.md +59 -0
  14. package/.gse/releases/public-security-contact-owner-required.md +45 -0
  15. package/.gse/state.json +27 -0
  16. package/CHANGELOG.md +24 -0
  17. package/CONTRIBUTING.md +64 -0
  18. package/LICENSE +21 -0
  19. package/README.md +236 -0
  20. package/README.zh-CN.md +236 -0
  21. package/SECURITY.md +41 -0
  22. package/SKILL.md +148 -0
  23. package/SUPPORT.md +38 -0
  24. package/agents/openai.yaml +4 -0
  25. package/assets/marketplace/README.md +7 -0
  26. package/assets/marketplace/gse-listing.json +75 -0
  27. package/assets/templates/acceptance-execution-packet.md +73 -0
  28. package/assets/templates/adr.md +14 -0
  29. package/assets/templates/change-brief.md +16 -0
  30. package/assets/templates/design.md +18 -0
  31. package/assets/templates/dispatch-packet.md +104 -0
  32. package/assets/templates/evidence.md +14 -0
  33. package/assets/templates/execution-quality-pack.md +65 -0
  34. package/assets/templates/goal-map.md +21 -0
  35. package/assets/templates/host-adapter.md +48 -0
  36. package/assets/templates/host-ui-invocation-record.md +42 -0
  37. package/assets/templates/incident-review.md +60 -0
  38. package/assets/templates/public-channel-publication-record.md +49 -0
  39. package/assets/templates/public-ci-run-record.md +53 -0
  40. package/assets/templates/public-release-record.md +65 -0
  41. package/assets/templates/public-repository-settings-record.md +59 -0
  42. package/assets/templates/public-security-contact-record.md +45 -0
  43. package/assets/templates/release-trust-record.md +32 -0
  44. package/assets/templates/review.md +18 -0
  45. package/assets/templates/spec.md +16 -0
  46. package/assets/templates/target-adoption-evidence.md +29 -0
  47. package/assets/templates/tasks.md +17 -0
  48. package/assets/templates/update-release-acceptance-record.md +58 -0
  49. package/examples/README.md +22 -0
  50. package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -0
  51. package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -0
  52. package/examples/agent-runtime-host/.gse/goal-map.md +7 -0
  53. package/examples/agent-runtime-host/.gse/project-profile.md +27 -0
  54. package/examples/agent-runtime-host/.gse/tooling.md +5 -0
  55. package/examples/agent-runtime-host/.mcp.json +9 -0
  56. package/examples/agent-runtime-host/AGENTS.md +5 -0
  57. package/examples/agent-runtime-host/README.md +10 -0
  58. package/examples/agent-runtime-host/docs/model-routing.md +5 -0
  59. package/examples/cli-tool/.gse/project-profile.md +21 -0
  60. package/examples/cli-tool/AGENTS.md +5 -0
  61. package/examples/cli-tool/README.md +12 -0
  62. package/examples/cli-tool/package.json +21 -0
  63. package/examples/small-app/.env.example +2 -0
  64. package/examples/small-app/.github/workflows/ci.yml +8 -0
  65. package/examples/small-app/AGENTS.md +5 -0
  66. package/examples/small-app/README.md +12 -0
  67. package/examples/small-app/package.json +26 -0
  68. package/examples/small-app/playwright.config.ts +4 -0
  69. package/package.json +53 -0
  70. package/references/adoption-recipes.md +171 -0
  71. package/references/agent-roles.md +49 -0
  72. package/references/architecture-health.md +101 -0
  73. package/references/benchmark-audit.md +73 -0
  74. package/references/commands.md +295 -0
  75. package/references/community-channels.md +46 -0
  76. package/references/compatibility.md +70 -0
  77. package/references/design-basis.md +38 -0
  78. package/references/domain-model.md +129 -0
  79. package/references/domain-quality-gates.md +75 -0
  80. package/references/drift-audit.md +81 -0
  81. package/references/evidence-taxonomy.md +123 -0
  82. package/references/file-ownership.md +107 -0
  83. package/references/final-readiness.md +84 -0
  84. package/references/forward-test.md +133 -0
  85. package/references/goal-map.md +36 -0
  86. package/references/host-adapters.md +119 -0
  87. package/references/learning-system.md +35 -0
  88. package/references/marketplace-discovery.md +46 -0
  89. package/references/model-routing.md +103 -0
  90. package/references/open-source-defaults.md +39 -0
  91. package/references/operating-model.md +52 -0
  92. package/references/packaging.md +277 -0
  93. package/references/project-agent-workspace.md +89 -0
  94. package/references/project-bootstrap.md +122 -0
  95. package/references/project-profile.md +57 -0
  96. package/references/public-release.md +174 -0
  97. package/references/quality-gates.md +100 -0
  98. package/references/recovery.md +176 -0
  99. package/references/release-trust.md +43 -0
  100. package/references/release.md +126 -0
  101. package/references/review.md +141 -0
  102. package/references/router.md +90 -0
  103. package/references/spec-workflow.md +66 -0
  104. package/references/task-levels.md +81 -0
  105. package/references/tool-adapters.md +73 -0
  106. package/scripts/audit-acceptance-execution-packet.mjs +133 -0
  107. package/scripts/audit-adoption-recipes.mjs +99 -0
  108. package/scripts/audit-adoption.mjs +154 -0
  109. package/scripts/audit-change-lifecycle.mjs +77 -0
  110. package/scripts/audit-change-system.mjs +134 -0
  111. package/scripts/audit-ci-readiness.mjs +107 -0
  112. package/scripts/audit-close-gate.mjs +323 -0
  113. package/scripts/audit-command-adapters.mjs +91 -0
  114. package/scripts/audit-command-execution.mjs +210 -0
  115. package/scripts/audit-commands.mjs +117 -0
  116. package/scripts/audit-compatibility.mjs +149 -0
  117. package/scripts/audit-completion-readiness.mjs +292 -0
  118. package/scripts/audit-distribution.mjs +251 -0
  119. package/scripts/audit-domain-quality-gates.mjs +108 -0
  120. package/scripts/audit-evidence-placeholders.mjs +126 -0
  121. package/scripts/audit-final-acceptance-packet.mjs +148 -0
  122. package/scripts/audit-final-form-progress-report.mjs +161 -0
  123. package/scripts/audit-final-form-stale-copy.mjs +221 -0
  124. package/scripts/audit-final-readiness-promotion.mjs +255 -0
  125. package/scripts/audit-final-readiness.mjs +226 -0
  126. package/scripts/audit-fixtures.mjs +154 -0
  127. package/scripts/audit-fresh-session-readiness.mjs +177 -0
  128. package/scripts/audit-gse.mjs +275 -0
  129. package/scripts/audit-host-adapters.mjs +119 -0
  130. package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -0
  131. package/scripts/audit-host-runtime-invocation-drill.mjs +240 -0
  132. package/scripts/audit-host-runtime-invocations.mjs +254 -0
  133. package/scripts/audit-host-ui-invocation.mjs +132 -0
  134. package/scripts/audit-learning-system.mjs +103 -0
  135. package/scripts/audit-local-final-form-completion.mjs +131 -0
  136. package/scripts/audit-marketplace-discovery.mjs +122 -0
  137. package/scripts/audit-npm-package-metadata.mjs +155 -0
  138. package/scripts/audit-npm-publish-dry-run.mjs +169 -0
  139. package/scripts/audit-npm-tarball-install.mjs +191 -0
  140. package/scripts/audit-open-source-defaults.mjs +92 -0
  141. package/scripts/audit-open-source-readiness.mjs +97 -0
  142. package/scripts/audit-owner-external-gate-kit.mjs +218 -0
  143. package/scripts/audit-project.mjs +323 -0
  144. package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -0
  145. package/scripts/audit-public-acceptance-handoff.mjs +142 -0
  146. package/scripts/audit-public-acceptance-readiness.mjs +224 -0
  147. package/scripts/audit-public-channel-publication.mjs +248 -0
  148. package/scripts/audit-public-ci-run.mjs +184 -0
  149. package/scripts/audit-public-collaboration-templates.mjs +98 -0
  150. package/scripts/audit-public-external-gate-probe.mjs +206 -0
  151. package/scripts/audit-public-release-checklist.mjs +133 -0
  152. package/scripts/audit-public-release-decision.mjs +201 -0
  153. package/scripts/audit-public-release-metadata.mjs +176 -0
  154. package/scripts/audit-public-repository-settings.mjs +237 -0
  155. package/scripts/audit-public-security-contact.mjs +171 -0
  156. package/scripts/audit-readme-docs.mjs +185 -0
  157. package/scripts/audit-recovery-readiness.mjs +98 -0
  158. package/scripts/audit-release-bundle.mjs +251 -0
  159. package/scripts/audit-release-owner-action-plan-drill.mjs +277 -0
  160. package/scripts/audit-release-owner-action-plan.mjs +164 -0
  161. package/scripts/audit-release-readiness.mjs +106 -0
  162. package/scripts/audit-release-status-manifest.mjs +165 -0
  163. package/scripts/audit-release-trust.mjs +62 -0
  164. package/scripts/audit-remote-distribution.mjs +266 -0
  165. package/scripts/audit-roadmap-consistency.mjs +235 -0
  166. package/scripts/audit-signing.mjs +147 -0
  167. package/scripts/audit-state-freshness.mjs +113 -0
  168. package/scripts/audit-target-adoption-evidence.mjs +117 -0
  169. package/scripts/audit-target-project.mjs +507 -0
  170. package/scripts/audit-update-release-acceptance.mjs +136 -0
  171. package/scripts/audit-v1-target-validation.mjs +269 -0
  172. package/scripts/audit-validation-profiles.mjs +125 -0
  173. package/scripts/close-change.mjs +116 -0
  174. package/scripts/discover-project-profile.mjs +307 -0
  175. package/scripts/forward-test-gse.mjs +146 -0
  176. package/scripts/generate-command-adapter.mjs +231 -0
  177. package/scripts/generate-final-acceptance-packet.mjs +181 -0
  178. package/scripts/generate-final-form-progress-report.mjs +205 -0
  179. package/scripts/generate-host-adapter.mjs +73 -0
  180. package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -0
  181. package/scripts/generate-owner-external-gate-kit.mjs +295 -0
  182. package/scripts/generate-public-acceptance-handoff.mjs +168 -0
  183. package/scripts/generate-public-release-checklist.mjs +207 -0
  184. package/scripts/generate-release-bundle.mjs +505 -0
  185. package/scripts/generate-release-owner-action-plan.mjs +172 -0
  186. package/scripts/generate-release-status-manifest.mjs +200 -0
  187. package/scripts/generate-session-prompt.mjs +188 -0
  188. package/scripts/gse.mjs +67 -0
  189. package/scripts/init-change.mjs +265 -0
  190. package/scripts/init-project.mjs +785 -0
  191. package/scripts/install-gse.mjs +234 -0
  192. package/scripts/lib/evidence-placeholders.mjs +28 -0
  193. package/scripts/package-gse.mjs +174 -0
  194. package/scripts/probe-public-external-gates.mjs +167 -0
  195. package/scripts/record-host-invocation.mjs +151 -0
  196. package/scripts/record-learning.mjs +137 -0
  197. package/scripts/record-public-channel-publication.mjs +178 -0
  198. package/scripts/record-public-ci-run.mjs +180 -0
  199. package/scripts/record-public-release.mjs +175 -0
  200. package/scripts/record-public-repository-settings.mjs +209 -0
  201. package/scripts/record-public-security-contact.mjs +157 -0
  202. package/scripts/run-gse-command.mjs +538 -0
  203. package/scripts/run-validation-profile.mjs +146 -0
  204. package/scripts/sign-gse-package.mjs +83 -0
  205. package/scripts/update-project-state.mjs +223 -0
  206. package/scripts/validate-gse.mjs +1168 -0
  207. package/scripts/verify-gse-package.mjs +85 -0
package/SKILL.md ADDED
@@ -0,0 +1,148 @@
1
+ ---
2
+ name: gse
3
+ description: Use GSE (Goal-Spec-Evidence Engineering) to initialize, operate, audit, or improve a commercial-grade agentic engineering workflow for long-running software projects. Use when starting or standardizing a project, planning complex work, coordinating multiple coding agents, creating goal maps/specs/evidence gates, setting project quality gates, or converting ad hoc development into a durable workflow across Codex, Claude Code, Hermes, WorkBuddy, and similar agents.
4
+ ---
5
+
6
+ # GSE - Goal-Spec-Evidence Engineering
7
+
8
+ GSE is a lightweight, tool-adaptive engineering operating model for AI-agent-assisted software projects.
9
+
10
+ Core loop:
11
+
12
+ ```text
13
+ Goal -> Spec -> Execute -> Evidence -> Learn
14
+ ```
15
+
16
+ Default stance: keep the workflow as light as the task allows and as rigorous as the risk requires.
17
+
18
+ ## Start Here
19
+
20
+ 1. Use `references/router.md` to select the GSE route.
21
+ 2. Classify the task level using `references/task-levels.md`.
22
+ 3. If the user writes `/gse ...` or `gse: ...`, route through `references/commands.md`.
23
+ 4. For human-facing setup or overview, use `README.md` and `README.zh-CN.md`.
24
+ 5. If the project has `.gse/README.md`, read it before making changes.
25
+ 6. If the project has `.gse/state.json`, read it as the machine-readable project phase, current slice, tool status, last evidence, and residual-risk summary.
26
+ 7. If the project lacks `.gse/`, offer or run `node <skill>/scripts/init-project.mjs --target <project-root>`.
27
+ The default is `--mode auto`; use `--mode lite`, `--mode standard`, or `--mode enterprise` when the owner wants a specific scaffold.
28
+ 8. Read or create `.gse/project-profile.md` for project-specific standards, commands, tools, and permissions.
29
+ 9. For project adoption drift, run `node <skill>/scripts/audit-target-project.mjs --target <project-root>` before claiming a target project is GSE-ready.
30
+ 10. Use `references/operating-model.md` for the workflow and `references/tool-adapters.md` for optional tool routing.
31
+ 11. Use `references/host-adapters.md` when host-specific folders, hooks, skills, MCP, subagents, or runtime adapters are involved.
32
+ 12. For GSE improvements, run `references/benchmark-audit.md` to proactively find missing skill coverage.
33
+ 13. Before declaring GSE skill changes complete, run `node <skill>/scripts/validate-gse.mjs --root <skill>`.
34
+ 14. Before declaring completion, check `references/quality-gates.md`.
35
+ 15. Record reusable lessons using `references/learning-system.md`.
36
+
37
+ Portable command helpers:
38
+
39
+ - Short CLI wrapper: `node <skill>/scripts/gse.mjs status --target <project-root> --json`
40
+ - Short continuation prompt: `node <skill>/scripts/generate-session-prompt.mjs --target <project-root>`
41
+ - Portable command runner: `node <skill>/scripts/run-gse-command.mjs --target <project-root> --command "/gse continue"`
42
+ - Validation profile runner: `node <skill>/scripts/run-validation-profile.mjs --target <project-root> --profile lite|standard|enterprise|release`
43
+ - Command execution audit: `node <skill>/scripts/audit-command-execution.mjs --root <skill> --profile lite|full`
44
+ - Close readiness check: `node <skill>/scripts/audit-close-gate.mjs --target <project-root>`
45
+ - GSE owner/external action list: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse owner-actions" --json --compact`
46
+ - Owner/external live evidence probe: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse probe --public-repo-url <url>" --json`
47
+ - Release bundle dry-run/write route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse release" --json`
48
+ - Package dry-run/write route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse package" --json`
49
+ - Install dry-run/write route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse install --source <package-dir> --install-target <install-skill-dir>" --json`
50
+ - Public release checklist route: `node <skill>/scripts/run-gse-command.mjs --target <skill> --command "/gse public-release" --json`
51
+ - Learning capture route: `node <skill>/scripts/run-gse-command.mjs --target <project-root> --command "/gse learn --summary <lesson>" --execute --json`
52
+ - Existing project state/index update: `node <skill>/scripts/update-project-state.mjs --target <project-root>`
53
+ - Change spec pack: `node <skill>/scripts/init-change.mjs --target <project-root> --change-id <id> --level lite|standard|enterprise`
54
+ - Public release record: `node <skill>/scripts/record-public-release.mjs --root <project-root> --license-status owner-required`
55
+ - Release bundle: `node <skill>/scripts/generate-release-bundle.mjs --root <skill> --label <release-label> --out <bundle-dir>`
56
+ - Owner/external gate kit: `node <skill>/scripts/generate-owner-external-gate-kit.mjs --root <skill-or-project>`
57
+
58
+ ## Required Questions Before Adding Process
59
+
60
+ For every new GSE artifact, rule, or gate, answer briefly:
61
+
62
+ - Is this step necessary for this task level?
63
+ - Can it be shorter?
64
+ - Can it be automated?
65
+ - Can it degrade by project scale?
66
+ - Is it friendly to future agents with limited context?
67
+ - Does it prevent a real failure or improve quality measurably?
68
+
69
+ If the answer is weak, defer the artifact or make it optional.
70
+
71
+ ## Evidence Rules
72
+
73
+ - Do not state unverified tool behavior as fact. Label inferred behavior as an assumption.
74
+ - Prefer local tool help, installed skill docs, project files, official docs, and focused experiments as evidence.
75
+ - If a tool is unavailable, use the markdown fallback and say which enhancement was skipped.
76
+ - Do not require OpenSpec, Comet, Superpowers, subagents, LSP, or browser automation. Use them when available and appropriate.
77
+
78
+ ## Minimal Outputs
79
+
80
+ For normal work, always keep these five fields visible:
81
+
82
+ ```text
83
+ Outcome:
84
+ Scope:
85
+ Acceptance:
86
+ Evidence:
87
+ Next action:
88
+ ```
89
+
90
+ For long-running projects, bind the work to `.gse/goal-map.md` or the project's existing goal map.
91
+
92
+ ## Reference Routing
93
+
94
+ - Project bootstrap: `references/project-bootstrap.md`
95
+ - Command semantics: `references/commands.md`
96
+ - Project adoption recipes: `references/adoption-recipes.md`
97
+ - Validation profile runner: `scripts/run-validation-profile.mjs`, `scripts/audit-validation-profiles.mjs`
98
+ - Target project doctor: `scripts/audit-target-project.mjs`
99
+ - Route selection: `references/router.md`
100
+ - Project-specific standards and tools: `references/project-profile.md`
101
+ - Project-local agent workspace: `references/project-agent-workspace.md`
102
+ - Host-specific adapters: `references/host-adapters.md`, `references/compatibility.md`
103
+ - Benchmark and gap audit: `references/benchmark-audit.md`
104
+ - Task level selection: `references/task-levels.md`
105
+ - Goal maps: `references/goal-map.md`
106
+ - Specs and change folders: `references/spec-workflow.md`
107
+ - Agent roles and ownership: `references/agent-roles.md`, `references/file-ownership.md`
108
+ - Tool acceleration and model routing: `references/tool-adapters.md`, `references/model-routing.md`
109
+ - Review protocol: `references/review.md`
110
+ - Architecture health scans: `references/architecture-health.md`
111
+ - Quality gates: `references/quality-gates.md`
112
+ - Domain quality gates: `references/domain-quality-gates.md`
113
+ - Release workflow: `references/release.md`
114
+ - Public release metadata: `references/public-release.md`
115
+ - Open-source defaults: `references/open-source-defaults.md`
116
+ - Community channels: `references/community-channels.md`
117
+ - Public release decision audit: `scripts/audit-public-release-decision.mjs`
118
+ - Public CI run: `scripts/record-public-ci-run.mjs`, `scripts/audit-public-ci-run.mjs`
119
+ - Public security contact: `scripts/record-public-security-contact.mjs`, `scripts/audit-public-security-contact.mjs`
120
+ - Public repository settings: `scripts/record-public-repository-settings.mjs`, `scripts/audit-public-repository-settings.mjs`
121
+ - Public channel publication: `scripts/record-public-channel-publication.mjs`, `scripts/audit-public-channel-publication.mjs`
122
+ - Public acceptance doctor: `scripts/audit-public-acceptance-readiness.mjs`
123
+ - Public external gate probe: `scripts/probe-public-external-gates.mjs`, `scripts/audit-public-external-gate-probe.mjs`
124
+ - Public acceptance handoff: `scripts/generate-public-acceptance-handoff.mjs`, `scripts/audit-public-acceptance-handoff.mjs`
125
+ - Owner/external gate kit: `scripts/generate-owner-external-gate-kit.mjs`, `scripts/audit-owner-external-gate-kit.mjs`
126
+ - Release status manifest: `scripts/generate-release-status-manifest.mjs`, `scripts/audit-release-status-manifest.mjs`
127
+ - Release owner action plan: `scripts/generate-release-owner-action-plan.mjs`, `scripts/audit-release-owner-action-plan.mjs`
128
+ - Release owner action plan drill: `scripts/audit-release-owner-action-plan-drill.mjs`
129
+ - Public release checklist: `scripts/generate-public-release-checklist.mjs`, `scripts/audit-public-release-checklist.mjs`
130
+ - Final-form progress report: `scripts/generate-final-form-progress-report.mjs`, `scripts/audit-final-form-progress-report.mjs`
131
+ - Packaging and maintenance: `references/packaging.md`
132
+ - CI readiness: `.github/workflows/validate-gse.yml`, `scripts/audit-ci-readiness.mjs`
133
+ - Public collaboration templates: `.github/PULL_REQUEST_TEMPLATE.md`, `.github/ISSUE_TEMPLATE/`, `scripts/audit-public-collaboration-templates.mjs`
134
+ - Release trust and key custody: `references/release-trust.md`
135
+ - Marketplace discovery: `references/marketplace-discovery.md`
136
+ - Host UI invocation record: `assets/templates/host-ui-invocation-record.md`
137
+ - Host runtime invocation records: `scripts/record-host-invocation.mjs`, `scripts/audit-host-runtime-invocations.mjs`
138
+ - Host runtime invocation drill: `scripts/audit-host-runtime-invocation-drill.mjs`
139
+ - Host runtime evidence handoff: `scripts/generate-host-runtime-evidence-handoff.mjs`, `scripts/audit-host-runtime-evidence-handoff.mjs`
140
+ - Final readiness matrix: `references/final-readiness.md`, `scripts/audit-final-readiness.mjs`
141
+ - Final readiness promotion: `scripts/audit-final-readiness-promotion.mjs`
142
+ - Final acceptance packet: `scripts/generate-final-acceptance-packet.mjs`, `scripts/audit-final-acceptance-packet.mjs`
143
+ - Recovery and handoff: `references/recovery.md`
144
+ - Forward testing: `references/forward-test.md`
145
+ - Learning loop: `references/learning-system.md`
146
+ - Learning capture: `scripts/record-learning.mjs`, `scripts/audit-learning-system.mjs`
147
+ - Drift audit: `references/drift-audit.md`
148
+ - Design basis and source boundaries: `references/design-basis.md`
package/SUPPORT.md ADDED
@@ -0,0 +1,38 @@
1
+ # Support
2
+
3
+ Use this file to decide where to start when GSE behavior is confusing, incomplete, or blocked.
4
+
5
+ ## First Checks
6
+
7
+ Run:
8
+
9
+ ```text
10
+ node scripts/validate-gse.mjs --root <gse-root> --json
11
+ ```
12
+
13
+ For a target project using GSE, run:
14
+
15
+ ```text
16
+ node scripts/audit-target-project.mjs --target <project-root> --json
17
+ node scripts/generate-session-prompt.mjs --target <project-root>
18
+ node scripts/audit-close-gate.mjs --target <project-root> --json
19
+ ```
20
+
21
+ For package or install issues, run:
22
+
23
+ ```text
24
+ node scripts/audit-distribution.mjs --root <gse-root> --json
25
+ node scripts/audit-remote-distribution.mjs --root <gse-root> --json
26
+ ```
27
+
28
+ ## What To Include In A Support Request
29
+
30
+ - GSE root path or installed package path.
31
+ - Target project path, if any.
32
+ - Command run and the compact JSON summary.
33
+ - Whether the problem is skill usage, project scaffold, package/install, host adapter, release, or evidence gating.
34
+ - Whether optional tools such as OpenSpec, Comet, Superpowers, LSP, browser automation, MCP, or subagents were actually available.
35
+
36
+ ## Community
37
+
38
+ GateHub (`https://gatehub.top/`) supports GSE development and contributor coordination.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "GSE"
3
+ short_description: "Goal-Spec-Evidence workflow system"
4
+ default_prompt: "Use $gse to standardize this project with goal maps, specs, evidence gates, and focused verification."
@@ -0,0 +1,7 @@
1
+ # Marketplace Metadata
2
+
3
+ This folder contains portable discovery metadata for publishing or listing GSE in a skill, plugin, or agent-workflow catalog.
4
+
5
+ The metadata is intentionally host-neutral. It describes what GSE is, how to validate it, which entrypoints matter, and which host capabilities still require separate runtime evidence.
6
+
7
+ Do not add maintainer secrets, local machine paths, private project names, or unverified marketplace approval claims here.
@@ -0,0 +1,75 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "name": "gse",
4
+ "displayName": "GSE",
5
+ "tagline": "Goal-Spec-Evidence Engineering for long-running agentic software projects.",
6
+ "summary": "Goal-Spec-Evidence workflow skill for AI coding agents that turns ad hoc development into goal maps, scoped specs, focused execution, evidence gates, and reusable learning.",
7
+ "categories": [
8
+ "agentic engineering",
9
+ "software development workflow",
10
+ "spec-driven development",
11
+ "AI coding agents",
12
+ "project governance"
13
+ ],
14
+ "keywords": [
15
+ "GSE",
16
+ "Goal-Spec-Evidence",
17
+ "agentic engineering",
18
+ "spec-driven development",
19
+ "SDD",
20
+ "AI coding agent workflow",
21
+ "evidence gates",
22
+ "goal map",
23
+ "project scaffolding",
24
+ "OpenSpec-style changes",
25
+ "Superpowers-style execution"
26
+ ],
27
+ "hostSupport": [
28
+ {
29
+ "host": "Codex-style agents",
30
+ "status": "documented",
31
+ "adapter": ".codex/gse-command.md",
32
+ "notes": "Portable runner and pointer adapter are verified; project-level native slash-command execution is host-specific."
33
+ },
34
+ {
35
+ "host": "Claude Code-style agents",
36
+ "status": "documented",
37
+ "adapter": ".claude/commands/gse.md",
38
+ "notes": "Generated command file shape is verified in fixtures; real host invocation requires host runtime evidence."
39
+ },
40
+ {
41
+ "host": "Custom agent runtimes",
42
+ "status": "documented",
43
+ "adapter": "runtime-specific bridge",
44
+ "notes": "Runtime capabilities should be verified inside the target project before being marked verified."
45
+ }
46
+ ],
47
+ "entrypoints": [
48
+ "SKILL.md",
49
+ "package.json",
50
+ "README.md",
51
+ "README.zh-CN.md",
52
+ "scripts/init-project.mjs",
53
+ "scripts/run-gse-command.mjs",
54
+ "scripts/validate-gse.mjs",
55
+ "scripts/audit-npm-package-metadata.mjs",
56
+ "scripts/audit-npm-tarball-install.mjs"
57
+ ],
58
+ "verification": [
59
+ "node scripts/validate-gse.mjs --root . --json",
60
+ "node scripts/audit-npm-package-metadata.mjs --root . --json",
61
+ "node scripts/audit-marketplace-discovery.mjs --root . --json",
62
+ "node scripts/audit-host-ui-invocation.mjs --root . --json"
63
+ ],
64
+ "distribution": {
65
+ "packageScript": "scripts/package-gse.mjs",
66
+ "installScript": "scripts/install-gse.mjs",
67
+ "signingScript": "scripts/sign-gse-package.mjs",
68
+ "trustPolicy": "references/release-trust.md"
69
+ },
70
+ "boundaries": [
71
+ "GSE is not a hosted service.",
72
+ "GSE does not require OpenSpec, Superpowers, Comet, MCP, LSP, browser automation, or subagents.",
73
+ "Marketplace approval, maintainer identity, and native host UI invocation require separate evidence."
74
+ ]
75
+ }
@@ -0,0 +1,73 @@
1
+ # Acceptance Execution Packet
2
+
3
+ Use this packet when GSE needs external acceptance evidence instead of another structural audit.
4
+
5
+ Choose exactly one path per packet.
6
+
7
+ ```text
8
+ Acceptance path: fresh-session | owner-approved project write
9
+ Target project or session:
10
+ Purpose:
11
+ Required inputs:
12
+ Allowed files:
13
+ Forbidden files:
14
+ Allowed commands:
15
+ Forbidden commands:
16
+ Expected output:
17
+ Evidence record path:
18
+ Acceptance gate:
19
+ Accepted by:
20
+ Stop conditions:
21
+ Residual risk if incomplete:
22
+ Next action after completion:
23
+ ```
24
+
25
+ ## Fresh-Session Path
26
+
27
+ Use when a separate session, thread, host worker, or equivalent can run the GSE continuation path without hidden conversation history.
28
+
29
+ Required inputs:
30
+
31
+ - `SKILL.md`
32
+ - `.gse/gse-design-master-plan.md`
33
+ - `.gse/goal-map.md`
34
+ - `.gse/current-slice.md`
35
+ - `references/forward-test.md`
36
+ - `references/evidence-taxonomy.md`
37
+
38
+ Acceptance gate: the separate session identifies the current slice, states outcome/scope/acceptance/evidence/risk/next action, runs or describes the smallest valid verification, and records `Accepted by: fresh-session` only if it actually executed the packet.
39
+
40
+ ## Owner-Approved Project Write Path
41
+
42
+ Use when a target project owner explicitly allows GSE to write project-local `.gse/` adoption or update artifacts.
43
+
44
+ Required inputs:
45
+
46
+ - Project owner approval text or issue/task link.
47
+ - Target project rule file such as `AGENTS.md`, `CLAUDE.md`, or README.
48
+ - `references/adoption-recipes.md`
49
+ - `assets/templates/target-adoption-evidence.md`
50
+ - `assets/templates/update-release-acceptance-record.md`
51
+
52
+ Default allowed files:
53
+
54
+ - `.gse/README.md`
55
+ - `.gse/project-profile.md`
56
+ - `.gse/goal-map.md`
57
+ - `.gse/quality-gates.md`
58
+ - `.gse/tooling.md`
59
+ - `.gse/evidence/YYYY-MM-DD.md`
60
+
61
+ Default forbidden files:
62
+
63
+ - Source code, lockfiles, secrets, generated outputs, screenshots, build artifacts, and unrelated host config.
64
+
65
+ Acceptance gate: the owner-approved project record exists, project-local verification ran, residual risks are recorded, and the owner or named policy accepts the verified record.
66
+
67
+ ## Anti-Overclaim Rules
68
+
69
+ - Do not write `Accepted by: fresh-session` unless a separate session actually ran the packet.
70
+ - Do not write `Accepted by: owner` unless owner approval is explicit and recorded.
71
+ - Do not treat a generated packet, local validation, fixture audit, or read-only discovery as acceptance.
72
+ - Do not expand allowed files or commands without updating the packet and recording why.
73
+ - If a stop condition occurs, record `Evidence status: not ready` or `verified` with `Accepted by: not accepted`.
@@ -0,0 +1,14 @@
1
+ # ADR-0000: Title
2
+
3
+ ## Status
4
+
5
+ Proposed
6
+
7
+ ## Context
8
+
9
+ ## Decision
10
+
11
+ ## Consequences
12
+
13
+ ## Alternatives Considered
14
+
@@ -0,0 +1,16 @@
1
+ # Change Brief
2
+
3
+ ## Outcome
4
+
5
+ ## Scope
6
+
7
+ ## Non-goals
8
+
9
+ ## Acceptance
10
+
11
+ ## Evidence Plan
12
+
13
+ ## Risks
14
+
15
+ ## Next Action
16
+
@@ -0,0 +1,18 @@
1
+ # Design
2
+
3
+ ## Approach
4
+
5
+ ## State / Data Flow
6
+
7
+ ## Interfaces And Contracts
8
+
9
+ ## Permissions And Privacy
10
+
11
+ ## Error And Recovery
12
+
13
+ ## Alternatives Considered
14
+
15
+ ## Rollback
16
+
17
+ ## Open Questions
18
+
@@ -0,0 +1,104 @@
1
+ # Dispatch Packet
2
+
3
+ Use this when assigning work to a real subagent, another human/agent session, or a sequential role simulation in the main session.
4
+
5
+ Do not require this packet for tiny single-agent edits. Use it when delegation, role separation, file ownership, or review evidence matters.
6
+
7
+ ## Execution Mode
8
+
9
+ - Mode: real-subagent | sequential-role | handoff-session
10
+ - Host/tool used:
11
+ - Tool status: verified | documented | unknown | unavailable
12
+ - If not real-subagent, state fallback reason:
13
+
14
+ ## Role
15
+
16
+ - Role: Coordinator | Product Analyst | Architect | Code Locator | Builder | Reviewer | QA | Docs/Evidence | Other:
17
+ - Skill focus:
18
+ - Model/tool preference, if project-approved:
19
+
20
+ ## Objective
21
+
22
+ - Outcome:
23
+ - Scope:
24
+ - Non-goals:
25
+ - User-visible impact:
26
+
27
+ ## Required Context
28
+
29
+ Read these first:
30
+
31
+ 1.
32
+ 2.
33
+ 3.
34
+
35
+ Do not read:
36
+
37
+ - Generated outputs:
38
+ - Historical logs:
39
+ - Unrelated modules:
40
+
41
+ Known assumptions:
42
+
43
+ - Verified facts:
44
+ - Design judgments:
45
+ - Open questions:
46
+
47
+ ## File Ownership
48
+
49
+ - Allowed files:
50
+ - Forbidden files:
51
+ - Read-only files:
52
+ - Shared files requiring coordinator review:
53
+ - Pre-existing dirty files:
54
+ - Release condition:
55
+
56
+ Follow `references/file-ownership.md`. Do not overwrite user or unrelated agent changes.
57
+
58
+ ## Task Instructions
59
+
60
+ - Steps to perform:
61
+ - Existing patterns to follow:
62
+ - Constraints:
63
+ - Performance/security/accessibility/privacy notes:
64
+
65
+ ## Expected Output
66
+
67
+ Return a concise report with:
68
+
69
+ - Status: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED
70
+ - Files inspected:
71
+ - Files changed:
72
+ - Summary of work:
73
+ - Verification run:
74
+ - Evidence produced:
75
+ - Residual risks:
76
+ - Questions or blockers:
77
+
78
+ ## Verification
79
+
80
+ - Required focused test/smoke/check:
81
+ - Acceptable evidence level: result | verified | accepted
82
+ - What proves success:
83
+ - What would fail the task:
84
+
85
+ ## Stop Conditions
86
+
87
+ Stop and report `NEEDS_CONTEXT` or `BLOCKED` if:
88
+
89
+ - Required context is missing or contradictory.
90
+ - Allowed files are insufficient for the requested change.
91
+ - Target files contain unrelated dirty changes that make merging unsafe.
92
+ - A tool claimed by the packet is unavailable.
93
+ - The task requires broader architecture or product judgment than assigned.
94
+
95
+ ## Review Requirements
96
+
97
+ - Spec compliance review required: yes | no
98
+ - Code quality review required: yes | no
99
+ - QA/evidence review required: yes | no
100
+ - Coordinator integration required: yes | no
101
+
102
+ ## Notes For Sequential Fallback
103
+
104
+ When no real subagent tool exists, use this packet as a role checklist in the main session. Say that no real delegation occurred if reporting delegation status matters. Keep role boundaries honest.
@@ -0,0 +1,14 @@
1
+ # Evidence
2
+
3
+ ## Verification Commands
4
+
5
+ ## Results
6
+
7
+ ## Files Changed
8
+
9
+ ## User-Visible Outcome
10
+
11
+ ## Residual Risk
12
+
13
+ ## Follow-up
14
+
@@ -0,0 +1,65 @@
1
+ # Execution Quality Pack
2
+
3
+ Use this when a change needs explicit execution skills, tool routing, quality gates, and review boundaries.
4
+
5
+ ## Task Profile
6
+
7
+ - Level: lite | standard | enterprise
8
+ - Change type:
9
+ - User-visible impact:
10
+ - Data/security/release impact:
11
+
12
+ ## Required Skills Or Roles
13
+
14
+ | Role / Skill | Purpose | Required | Evidence |
15
+ |---|---|---|---|
16
+ | Coordinator | Scope, final judgment, integration | yes | plan/state/evidence |
17
+ | Code Locator | Files, symbols, existing tests | when code changes | search/LSP notes |
18
+ | Builder | Bounded implementation | when files change | diff + focused check |
19
+ | QA / Verification | Focused proof | yes | command/browser/API smoke |
20
+ | Reviewer | Spec, quality, architecture, security | risk-based | review notes |
21
+
22
+ ## Tool Routing
23
+
24
+ | Tool | Use When | Status | Fallback |
25
+ |---|---|---|---|
26
+ | rg / rg --files | Code and doc location | recommended | shell listing |
27
+ | LSP / index | Large or typed codebase | unknown | rg + existing tests |
28
+ | Browser / Playwright | UI or user-visible flow | unknown | component/API smoke plus notes |
29
+ | OpenSpec | Capability/API/state contract change | optional | .gse/changes/ markdown |
30
+ | Comet | Full lifecycle change | optional | GSE phase/status files |
31
+ | Superpowers | Complex staged execution/review | optional | GSE roles + quality gates |
32
+ | Subagents | Parallel bounded work | unknown | sequential role execution |
33
+
34
+ ## Quality Gates Selected
35
+
36
+ ```text
37
+ Universal:
38
+ Code:
39
+ UI:
40
+ API/state:
41
+ Security/privacy:
42
+ Performance/cost:
43
+ Resilience/recovery:
44
+ Release/operations:
45
+ ```
46
+
47
+ ## Evidence Plan
48
+
49
+ ```text
50
+ Focused command:
51
+ Browser/API smoke:
52
+ Manual inspection:
53
+ Not run and why:
54
+ Evidence status: result | verified | accepted | not ready
55
+ ```
56
+
57
+ ## Review And Closure
58
+
59
+ - Spec compliance:
60
+ - Code quality:
61
+ - Architecture/ownership:
62
+ - Residual risk:
63
+ - Close gate command:
64
+ - Next action:
65
+
@@ -0,0 +1,21 @@
1
+ # Goal Map
2
+
3
+ Updated: YYYY-MM-DD
4
+
5
+ ## North Star
6
+
7
+ ## Current Focus
8
+
9
+ - Priority:
10
+ - Active slice:
11
+ - Next action:
12
+
13
+ ## Goal Nodes
14
+
15
+ | ID | Goal | Status | Priority | Evidence | Next Slice |
16
+ |---|---|---|---|---|---|
17
+
18
+ ## Risks
19
+
20
+ ## Next 3 Slices
21
+
@@ -0,0 +1,48 @@
1
+ # Host Adapter
2
+
3
+ ## Host
4
+
5
+ - Name:
6
+ - Adapter path:
7
+ - Maintainer:
8
+ - Last checked:
9
+
10
+ ## Source Of Truth
11
+
12
+ Portable workflow source: `.gse/`
13
+
14
+ Read first:
15
+
16
+ 1. `.gse/project-profile.md`
17
+ 2. `.gse/goal-map.md`
18
+ 3. `.gse/quality-gates.md`
19
+ 4. Relevant `.gse/changes/` or `.gse/evidence/` files
20
+
21
+ ## Verified Capabilities
22
+
23
+ | Capability | Command/config | Status | Evidence |
24
+ |---|---|---|---|
25
+ | Project rules | - | unknown | - |
26
+ | Skills/commands | - | unknown | - |
27
+ | Subagents | - | unknown | - |
28
+ | MCP/tools | - | unknown | - |
29
+ | LSP/index | - | unknown | - |
30
+ | Browser/UI verification | - | unknown | - |
31
+ | CI/build/test | - | unknown | - |
32
+
33
+ ## Host-Specific Start
34
+
35
+ Describe the shortest host-specific instruction that makes this host read `.gse/` first.
36
+
37
+ ## Safety And Permissions
38
+
39
+ - Secrets:
40
+ - Write-capable tools:
41
+ - Destructive commands:
42
+ - Network/external services:
43
+
44
+ ## Drift Check
45
+
46
+ - Check cadence:
47
+ - What must stay in `.gse/`:
48
+ - What may stay host-specific: