sherpa-skill 2.0.6 → 2.0.7

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 (246) hide show
  1. package/.agents/plugins/marketplace.json +11 -0
  2. package/.agents/skills/sherpa/SKILL.md +161 -0
  3. package/.agents/skills/sherpa/commands/README.md +43 -0
  4. package/.agents/skills/sherpa/commands/manifest.json +589 -0
  5. package/.agents/skills/sherpa/commands/sherpa-research.md +147 -0
  6. package/.agents/skills/sherpa/core/commands/router.py +171 -0
  7. package/.agents/skills/sherpa/core/configuration/manager.py +504 -0
  8. package/.agents/skills/sherpa/core/ideas/engine.py +564 -0
  9. package/.agents/skills/sherpa/docs/commands/README.md +96 -0
  10. package/.agents/skills/sherpa/docs/configuration/runtime-verification.md +64 -0
  11. package/.agents/skills/sherpa/rules/demo-preparation-rules.md +543 -0
  12. package/.agents/skills/sherpa/rules/engineering-rules.md +221 -0
  13. package/.agents/skills/sherpa/rules/final-audit-rules.md +824 -0
  14. package/.agents/skills/sherpa/rules/implementation-rules.md +127 -0
  15. package/.agents/skills/sherpa/rules/judge-rules.md +443 -0
  16. package/.agents/skills/sherpa/rules/mentor-rules.md +109 -0
  17. package/.agents/skills/sherpa/rules/postmortem-rules.md +69 -0
  18. package/.agents/skills/sherpa/rules/presentation-rules.md +783 -0
  19. package/.agents/skills/sherpa/rules/red-team-rules.md +185 -0
  20. package/.agents/skills/sherpa/rules/research-rules.md +184 -0
  21. package/.agents/skills/sherpa/rules/score-optimization-rules.md +355 -0
  22. package/.agents/skills/sherpa/rules/scoring-rules.md +216 -0
  23. package/.agents/skills/sherpa/rules/submission-rules.md +41 -0
  24. package/.agents/skills/sherpa/rules/testing-security-rules.md +87 -0
  25. package/.agents/skills/sherpa/rules/ux-rules.md +89 -0
  26. package/.agents/skills/sherpa/src/config_manager.py +474 -0
  27. package/.agents/skills/sherpa/src/verification.py +458 -0
  28. package/.agents/skills/sherpa/templates/audit-finding.md +20 -0
  29. package/.agents/skills/sherpa/templates/claim-audit.md +15 -0
  30. package/.agents/skills/sherpa/templates/configuration/hackathon.json +21 -0
  31. package/.agents/skills/sherpa/templates/configuration/integrations.env.example +3 -0
  32. package/.agents/skills/sherpa/templates/configuration/project.env.example +12 -0
  33. package/.agents/skills/sherpa/templates/configuration/providers.env.example +4 -0
  34. package/.agents/skills/sherpa/templates/configuration/settings.json +22 -0
  35. package/.agents/skills/sherpa/templates/consistency-audit.md +17 -0
  36. package/.agents/skills/sherpa/templates/decision-log.md +18 -0
  37. package/.agents/skills/sherpa/templates/demo-checkpoint.md +42 -0
  38. package/.agents/skills/sherpa/templates/demo-evidence.md +32 -0
  39. package/.agents/skills/sherpa/templates/demo-finding.md +112 -0
  40. package/.agents/skills/sherpa/templates/demo-flow.md +52 -0
  41. package/.agents/skills/sherpa/templates/demo-plan.md +265 -0
  42. package/.agents/skills/sherpa/templates/demo-verification.md +57 -0
  43. package/.agents/skills/sherpa/templates/final-audit.md +387 -0
  44. package/.agents/skills/sherpa/templates/final-risk.md +17 -0
  45. package/.agents/skills/sherpa/templates/final-verification.md +57 -0
  46. package/.agents/skills/sherpa/templates/gap-analysis.md +113 -0
  47. package/.agents/skills/sherpa/templates/idea-comparison.md +129 -0
  48. package/.agents/skills/sherpa/templates/idea-evaluation.md +251 -0
  49. package/.agents/skills/sherpa/templates/implementation-plan.md +96 -0
  50. package/.agents/skills/sherpa/templates/implementation-task.md +57 -0
  51. package/.agents/skills/sherpa/templates/improvement-candidate.md +135 -0
  52. package/.agents/skills/sherpa/templates/improvement.md +18 -0
  53. package/.agents/skills/sherpa/templates/incident.md +20 -0
  54. package/.agents/skills/sherpa/templates/judge-criterion.md +41 -0
  55. package/.agents/skills/sherpa/templates/judge-question.md +41 -0
  56. package/.agents/skills/sherpa/templates/judge-session.md +125 -0
  57. package/.agents/skills/sherpa/templates/judge-simulation.md +264 -0
  58. package/.agents/skills/sherpa/templates/lesson.md +14 -0
  59. package/.agents/skills/sherpa/templates/postmortem.md +87 -0
  60. package/.agents/skills/sherpa/templates/presentation-evidence.md +33 -0
  61. package/.agents/skills/sherpa/templates/presentation-plan.md +349 -0
  62. package/.agents/skills/sherpa/templates/presentation-qna.md +29 -0
  63. package/.agents/skills/sherpa/templates/presentation-risk.md +42 -0
  64. package/.agents/skills/sherpa/templates/presentation-verification.md +57 -0
  65. package/.agents/skills/sherpa/templates/project-plan.md +242 -0
  66. package/.agents/skills/sherpa/templates/project-state.md +84 -0
  67. package/.agents/skills/sherpa/templates/red-team-finding.md +73 -0
  68. package/.agents/skills/sherpa/templates/red-team-review.md +105 -0
  69. package/.agents/skills/sherpa/templates/red-team-scenario.md +43 -0
  70. package/.agents/skills/sherpa/templates/red-team-verification.md +31 -0
  71. package/.agents/skills/sherpa/templates/repo-analysis.md +204 -0
  72. package/.agents/skills/sherpa/templates/requirement-audit.md +15 -0
  73. package/.agents/skills/sherpa/templates/research-comparison.md +124 -0
  74. package/.agents/skills/sherpa/templates/research-plan.md +93 -0
  75. package/.agents/skills/sherpa/templates/research-report.md +92 -0
  76. package/.agents/skills/sherpa/templates/research-source.md +77 -0
  77. package/.agents/skills/sherpa/templates/score-optimization-plan.md +197 -0
  78. package/.agents/skills/sherpa/templates/security-finding.md +45 -0
  79. package/.agents/skills/sherpa/templates/security-review.md +64 -0
  80. package/.agents/skills/sherpa/templates/slide-claim.md +47 -0
  81. package/.agents/skills/sherpa/templates/slide-plan.md +127 -0
  82. package/.agents/skills/sherpa/templates/submission-artifact.md +15 -0
  83. package/.agents/skills/sherpa/templates/submission-checklist.md +24 -0
  84. package/.agents/skills/sherpa/templates/submission-field.md +14 -0
  85. package/.agents/skills/sherpa/templates/submission-link.md +14 -0
  86. package/.agents/skills/sherpa/templates/submission-plan.md +31 -0
  87. package/.agents/skills/sherpa/templates/submission-readiness.md +18 -0
  88. package/.agents/skills/sherpa/templates/submission-requirement.md +12 -0
  89. package/.agents/skills/sherpa/templates/submission-risk.md +14 -0
  90. package/.agents/skills/sherpa/templates/submission-snapshot.md +20 -0
  91. package/.agents/skills/sherpa/templates/submission-verification.md +12 -0
  92. package/.agents/skills/sherpa/templates/test-plan.md +59 -0
  93. package/.agents/skills/sherpa/templates/test-result.md +46 -0
  94. package/.agents/skills/sherpa/templates/timeline.md +11 -0
  95. package/.agents/skills/sherpa/templates/ux-finding.md +56 -0
  96. package/.agents/skills/sherpa/templates/ux-flow.md +46 -0
  97. package/.agents/skills/sherpa/templates/ux-review.md +113 -0
  98. package/.agents/skills/sherpa/templates/ux-verification.md +32 -0
  99. package/.agents/skills/sherpa/workflows/configuration.md +23 -0
  100. package/.agents/skills/sherpa/workflows/demo-preparation.md +399 -0
  101. package/.agents/skills/sherpa/workflows/final-audit.md +713 -0
  102. package/.agents/skills/sherpa/workflows/idea-evaluation.md +239 -0
  103. package/.agents/skills/sherpa/workflows/idea-intelligence.md +69 -0
  104. package/.agents/skills/sherpa/workflows/implementation.md +42 -0
  105. package/.agents/skills/sherpa/workflows/init.md +102 -0
  106. package/.agents/skills/sherpa/workflows/judge-simulation.md +408 -0
  107. package/.agents/skills/sherpa/workflows/lifecycle.md +51 -0
  108. package/.agents/skills/sherpa/workflows/next.md +96 -0
  109. package/.agents/skills/sherpa/workflows/postmortem.md +76 -0
  110. package/.agents/skills/sherpa/workflows/presentation.md +522 -0
  111. package/.agents/skills/sherpa/workflows/project-planning.md +327 -0
  112. package/.agents/skills/sherpa/workflows/red-team.md +373 -0
  113. package/.agents/skills/sherpa/workflows/research.md +142 -0
  114. package/.agents/skills/sherpa/workflows/score-optimization.md +276 -0
  115. package/.agents/skills/sherpa/workflows/status.md +107 -0
  116. package/.agents/skills/sherpa/workflows/submission.md +46 -0
  117. package/.agents/skills/sherpa/workflows/testing-security.md +44 -0
  118. package/.agents/skills/sherpa/workflows/ux-review.md +59 -0
  119. package/.claude-plugin/marketplace.json +21 -0
  120. package/.claude-plugin/plugin.json +13 -0
  121. package/.codex-plugin/plugin.json +13 -0
  122. package/GEMINI.md +3 -0
  123. package/README.md +11 -7
  124. package/SKILL.md +161 -0
  125. package/distribution/cli/sherpa +1 -1
  126. package/gemini-extension.json +7 -0
  127. package/package.json +31 -3
  128. package/plugin.json +20 -0
  129. package/qwen-extension.json +6 -0
  130. package/skills/sherpa/SKILL.md +161 -0
  131. package/skills/sherpa/commands/README.md +43 -0
  132. package/skills/sherpa/commands/manifest.json +589 -0
  133. package/skills/sherpa/commands/sherpa-research.md +147 -0
  134. package/skills/sherpa/core/commands/router.py +171 -0
  135. package/skills/sherpa/core/configuration/manager.py +504 -0
  136. package/skills/sherpa/core/ideas/engine.py +564 -0
  137. package/skills/sherpa/docs/commands/README.md +96 -0
  138. package/skills/sherpa/docs/configuration/runtime-verification.md +64 -0
  139. package/skills/sherpa/rules/demo-preparation-rules.md +543 -0
  140. package/skills/sherpa/rules/engineering-rules.md +221 -0
  141. package/skills/sherpa/rules/final-audit-rules.md +824 -0
  142. package/skills/sherpa/rules/implementation-rules.md +127 -0
  143. package/skills/sherpa/rules/judge-rules.md +443 -0
  144. package/skills/sherpa/rules/mentor-rules.md +109 -0
  145. package/skills/sherpa/rules/postmortem-rules.md +69 -0
  146. package/skills/sherpa/rules/presentation-rules.md +783 -0
  147. package/skills/sherpa/rules/red-team-rules.md +185 -0
  148. package/skills/sherpa/rules/research-rules.md +184 -0
  149. package/skills/sherpa/rules/score-optimization-rules.md +355 -0
  150. package/skills/sherpa/rules/scoring-rules.md +216 -0
  151. package/skills/sherpa/rules/submission-rules.md +41 -0
  152. package/skills/sherpa/rules/testing-security-rules.md +87 -0
  153. package/skills/sherpa/rules/ux-rules.md +89 -0
  154. package/skills/sherpa/src/config_manager.py +474 -0
  155. package/skills/sherpa/src/verification.py +458 -0
  156. package/skills/sherpa/templates/audit-finding.md +20 -0
  157. package/skills/sherpa/templates/claim-audit.md +15 -0
  158. package/skills/sherpa/templates/configuration/hackathon.json +21 -0
  159. package/skills/sherpa/templates/configuration/integrations.env.example +3 -0
  160. package/skills/sherpa/templates/configuration/project.env.example +12 -0
  161. package/skills/sherpa/templates/configuration/providers.env.example +4 -0
  162. package/skills/sherpa/templates/configuration/settings.json +22 -0
  163. package/skills/sherpa/templates/consistency-audit.md +17 -0
  164. package/skills/sherpa/templates/decision-log.md +18 -0
  165. package/skills/sherpa/templates/demo-checkpoint.md +42 -0
  166. package/skills/sherpa/templates/demo-evidence.md +32 -0
  167. package/skills/sherpa/templates/demo-finding.md +112 -0
  168. package/skills/sherpa/templates/demo-flow.md +52 -0
  169. package/skills/sherpa/templates/demo-plan.md +265 -0
  170. package/skills/sherpa/templates/demo-verification.md +57 -0
  171. package/skills/sherpa/templates/final-audit.md +387 -0
  172. package/skills/sherpa/templates/final-risk.md +17 -0
  173. package/skills/sherpa/templates/final-verification.md +57 -0
  174. package/skills/sherpa/templates/gap-analysis.md +113 -0
  175. package/skills/sherpa/templates/idea-comparison.md +129 -0
  176. package/skills/sherpa/templates/idea-evaluation.md +251 -0
  177. package/skills/sherpa/templates/implementation-plan.md +96 -0
  178. package/skills/sherpa/templates/implementation-task.md +57 -0
  179. package/skills/sherpa/templates/improvement-candidate.md +135 -0
  180. package/skills/sherpa/templates/improvement.md +18 -0
  181. package/skills/sherpa/templates/incident.md +20 -0
  182. package/skills/sherpa/templates/judge-criterion.md +41 -0
  183. package/skills/sherpa/templates/judge-question.md +41 -0
  184. package/skills/sherpa/templates/judge-session.md +125 -0
  185. package/skills/sherpa/templates/judge-simulation.md +264 -0
  186. package/skills/sherpa/templates/lesson.md +14 -0
  187. package/skills/sherpa/templates/postmortem.md +87 -0
  188. package/skills/sherpa/templates/presentation-evidence.md +33 -0
  189. package/skills/sherpa/templates/presentation-plan.md +349 -0
  190. package/skills/sherpa/templates/presentation-qna.md +29 -0
  191. package/skills/sherpa/templates/presentation-risk.md +42 -0
  192. package/skills/sherpa/templates/presentation-verification.md +57 -0
  193. package/skills/sherpa/templates/project-plan.md +242 -0
  194. package/skills/sherpa/templates/project-state.md +84 -0
  195. package/skills/sherpa/templates/red-team-finding.md +73 -0
  196. package/skills/sherpa/templates/red-team-review.md +105 -0
  197. package/skills/sherpa/templates/red-team-scenario.md +43 -0
  198. package/skills/sherpa/templates/red-team-verification.md +31 -0
  199. package/skills/sherpa/templates/repo-analysis.md +204 -0
  200. package/skills/sherpa/templates/requirement-audit.md +15 -0
  201. package/skills/sherpa/templates/research-comparison.md +124 -0
  202. package/skills/sherpa/templates/research-plan.md +93 -0
  203. package/skills/sherpa/templates/research-report.md +92 -0
  204. package/skills/sherpa/templates/research-source.md +77 -0
  205. package/skills/sherpa/templates/score-optimization-plan.md +197 -0
  206. package/skills/sherpa/templates/security-finding.md +45 -0
  207. package/skills/sherpa/templates/security-review.md +64 -0
  208. package/skills/sherpa/templates/slide-claim.md +47 -0
  209. package/skills/sherpa/templates/slide-plan.md +127 -0
  210. package/skills/sherpa/templates/submission-artifact.md +15 -0
  211. package/skills/sherpa/templates/submission-checklist.md +24 -0
  212. package/skills/sherpa/templates/submission-field.md +14 -0
  213. package/skills/sherpa/templates/submission-link.md +14 -0
  214. package/skills/sherpa/templates/submission-plan.md +31 -0
  215. package/skills/sherpa/templates/submission-readiness.md +18 -0
  216. package/skills/sherpa/templates/submission-requirement.md +12 -0
  217. package/skills/sherpa/templates/submission-risk.md +14 -0
  218. package/skills/sherpa/templates/submission-snapshot.md +20 -0
  219. package/skills/sherpa/templates/submission-verification.md +12 -0
  220. package/skills/sherpa/templates/test-plan.md +59 -0
  221. package/skills/sherpa/templates/test-result.md +46 -0
  222. package/skills/sherpa/templates/timeline.md +11 -0
  223. package/skills/sherpa/templates/ux-finding.md +56 -0
  224. package/skills/sherpa/templates/ux-flow.md +46 -0
  225. package/skills/sherpa/templates/ux-review.md +113 -0
  226. package/skills/sherpa/templates/ux-verification.md +32 -0
  227. package/skills/sherpa/workflows/configuration.md +23 -0
  228. package/skills/sherpa/workflows/demo-preparation.md +399 -0
  229. package/skills/sherpa/workflows/final-audit.md +713 -0
  230. package/skills/sherpa/workflows/idea-evaluation.md +239 -0
  231. package/skills/sherpa/workflows/idea-intelligence.md +69 -0
  232. package/skills/sherpa/workflows/implementation.md +42 -0
  233. package/skills/sherpa/workflows/init.md +102 -0
  234. package/skills/sherpa/workflows/judge-simulation.md +408 -0
  235. package/skills/sherpa/workflows/lifecycle.md +51 -0
  236. package/skills/sherpa/workflows/next.md +96 -0
  237. package/skills/sherpa/workflows/postmortem.md +76 -0
  238. package/skills/sherpa/workflows/presentation.md +522 -0
  239. package/skills/sherpa/workflows/project-planning.md +327 -0
  240. package/skills/sherpa/workflows/red-team.md +373 -0
  241. package/skills/sherpa/workflows/research.md +142 -0
  242. package/skills/sherpa/workflows/score-optimization.md +276 -0
  243. package/skills/sherpa/workflows/status.md +107 -0
  244. package/skills/sherpa/workflows/submission.md +46 -0
  245. package/skills/sherpa/workflows/testing-security.md +44 -0
  246. package/skills/sherpa/workflows/ux-review.md +59 -0
@@ -0,0 +1,408 @@
1
+ # sherpa — Judge Simulation Workflow
2
+
3
+ **Operation:** JUDGE-SIM
4
+ **Purpose:** Simulate how a realistic hackathon judge would perceive the project. Identify what judges would notice, question, misunderstand, praise, distrust, or penalize. Phase 9 is a judge simulation intelligence engine — it reviews and recommends; it does not optimize scores or change the project.
5
+
6
+ **Pipeline:**
7
+ Read Project State → Verify Readiness → Read Hackathon Rules / Criteria → Read Phase 2 Evaluation → Read Phase 3 Project Plan → Read Phase 4 Implementation Evidence → Read Phase 5 Testing/Security Evidence → Read Phase 7 UX Evidence → Read Phase 8 Red Team Evidence → Inspect Actual Repository → Inspect Actual Demo Flow → Build Judge Perspective → Evaluate Each Criterion → Simulate Judge Questions → Challenge Claims → Assess Judge Confidence → Identify Judge Concerns → Prioritize Preparation Needs → Produce Judge Simulation Report → Update Project State → Return Exactly ONE Primary Next Action
8
+
9
+ ---
10
+
11
+ ## When to Use
12
+
13
+ Use JUDGE-SIM when:
14
+ - A hackathon idea has been selected and implementation baseline exists
15
+ - You want to anticipate how judges would perceive the project
16
+ - You need to understand what judges would question, trust, or distrust
17
+
18
+ **Prerequisite:** `.sherpa/project-state.md` must exist with `selected idea` known, Phase 2 idea evaluation, Phase 3 project plan, Phase 4 implementation evidence, Phase 5 testing/security evidence, Phase 7 UX evidence, and Phase 8 Red Team evidence.
19
+
20
+ ---
21
+
22
+ ## Pipeline Stages
23
+
24
+ ### Stage 1: Read Project State
25
+
26
+ Read `.sherpa/project-state.md`:
27
+ - Hackathon name, deadline, time remaining
28
+ - Judging criteria and weights
29
+ - Problem statement, target users
30
+ - Selected idea (must be known)
31
+ - Phase 2 decision outcome
32
+ - Phase 3 architecture status
33
+ - Phase 4 implementation status
34
+ - Phase 5 test/security evidence
35
+ - Phase 7 UX evidence
36
+ - Phase 8 Red Team evidence
37
+
38
+ If `selected idea` is UNKNOWN:
39
+ - STOP normal judge simulation.
40
+ - Do not invent a selected idea.
41
+ - Return: selected idea is unknown, JUDGE-SIM cannot produce a normal simulation yet, exactly one primary next action: confirm the selected idea.
42
+
43
+ If required information is missing:
44
+ - Mark as UNKNOWN
45
+ - Report JUDGE-SIM = BLOCKED or LIMITED
46
+ - Do not invent readiness
47
+
48
+ ### Stage 2: Verify Readiness
49
+
50
+ Check:
51
+ - Hackathon rules / judging criteria exist (or mark UNKNOWN)
52
+ - Phase 2 idea evaluation exists
53
+ - Phase 3 project plan exists
54
+ - Phase 4 implementation status is known
55
+ - Phase 5 testing/security evidence exists
56
+ - Phase 7 UX evidence exists
57
+ - Phase 8 Red Team evidence exists
58
+
59
+ If required information is missing:
60
+ - Mark as UNKNOWN
61
+ - Report JUDGE-SIM = BLOCKED or LIMITED
62
+ - Do not invent readiness
63
+
64
+ ### Stage 3: Read Hackathon Rules / Criteria
65
+
66
+ Read the hackathon's official judging criteria and weights:
67
+ - Capture each criterion name and weight
68
+ - If criteria/weights are UNKNOWN, mark UNKNOWN
69
+ - Do NOT invent criteria or weights
70
+ - Do NOT invent weights
71
+
72
+ ### Stage 4: Read Phase 2 Idea Evaluation
73
+
74
+ Read `.sherpa/decisions.md` and `.sherpa/evaluations/<idea-name>.md`:
75
+ - Selected idea name
76
+ - Evaluation scores
77
+ - Red-team outcomes from Phase 2
78
+ - Rejected ideas and reasons
79
+ - MVP scope
80
+
81
+ ### Stage 5: Read Phase 3 Project Plan
82
+
83
+ Read `.sherpa/evidence/project-plan-*.md`:
84
+ - Current architecture
85
+ - Proposed architecture
86
+ - MVP scope (MUST/SHOULD/OPTIONAL/EXCLUDED)
87
+ - Implementation workstreams
88
+ - Dependencies
89
+ - Critical path
90
+ - Technical risks
91
+ - Time strategy
92
+
93
+ ### Stage 6: Read Phase 4 Implementation Evidence
94
+
95
+ Read `.sherpa/evidence/` implementation artifacts:
96
+ - Repository baseline
97
+ - Components implemented
98
+ - Tests executed
99
+ - Deployment configuration
100
+ - Known issues
101
+
102
+ ### Stage 7: Read Phase 5 Testing/Security Evidence
103
+
104
+ Read `.sherpa/evidence/` testing/security artifacts:
105
+ - Test results
106
+ - Security findings
107
+ - Blocked tests
108
+ - Regression risks
109
+ - Known failures
110
+
111
+ Do not duplicate the Phase 5 testing/security engine. Consume its evidence only.
112
+
113
+ ### Stage 8: Read Phase 7 UX Evidence
114
+
115
+ Read `.sherpa/ux-review.md` and `.sherpa/ux/` artifacts:
116
+ - UX baseline
117
+ - Critical flows
118
+ - Findings
119
+ - Quality gate status
120
+ - Limitations
121
+
122
+ Do not duplicate the Phase 7 UX engine. Consume its evidence only.
123
+
124
+ ### Stage 9: Read Phase 8 Red Team Evidence
125
+
126
+ Read `.sherpa/red-team.md` and `.sherpa/red-team/` artifacts:
127
+ - Red team findings
128
+ - Risks
129
+ - Mitigations
130
+ - Quality gate status
131
+ - Limitations
132
+
133
+ Do not duplicate the Phase 8 Red Team engine. Consume its evidence only.
134
+
135
+ ### Stage 10: Inspect Current Repository
136
+
137
+ Inspect the actual repository:
138
+ - Project metadata
139
+ - Dependency manifests
140
+ - Top-level project structure
141
+ - Application entry points
142
+ - Frontend/backend/database/AI components
143
+ - APIs
144
+ - Tests
145
+ - Deployment configuration
146
+ - Documentation
147
+ - Environment configuration
148
+
149
+ Evidence classification (for every observation):
150
+ - FACT: Directly observed
151
+ - INFERENCE: Logical conclusion from facts
152
+ - ASSUMPTION: Not yet verified
153
+ - UNKNOWN: No information available
154
+
155
+ Rules:
156
+ - Never fabricate repository facts.
157
+ - Execution claims require execution evidence.
158
+ - Seeing a test file does NOT mean tests pass.
159
+ - Generated sherpa artifacts are not independent evidence.
160
+
161
+ ### Stage 11: Inspect Actual Demo Flow
162
+
163
+ Inspect the actual demo path if available:
164
+ - Judge opens project
165
+ - Initial understanding
166
+ - First interaction
167
+ - Core action
168
+ - Result
169
+ - Secondary behavior
170
+ - Error/recovery
171
+ - Completion
172
+
173
+ Record:
174
+ - Steps
175
+ - Time
176
+ - Visible output
177
+ - Confusion points
178
+ - Failure points
179
+ - Recovery
180
+ - Missing context
181
+ - Judge-visible value
182
+
183
+ Do not claim a demo was executed unless it was actually executed. If dynamic execution is unavailable:
184
+
185
+ ```text
186
+ Demo execution = NOT_TESTED
187
+ ```
188
+
189
+ ### Stage 12: Build Judge Perspective
190
+
191
+ Build simulation from multiple judge personas:
192
+ - Technical Judge
193
+ - Product Judge
194
+ - Demo Judge
195
+ - Skeptical Judge
196
+
197
+ Do not assume every hackathon uses these exact judge types. They are simulation personas only.
198
+
199
+ ### Stage 13: Evaluate Each Criterion
200
+
201
+ For each judging criterion:
202
+ - Map to actual evidence
203
+ - Identify strengths and weaknesses
204
+ - Determine likely judge reaction
205
+ - Assign confidence
206
+ - Identify unknowns
207
+
208
+ If official criteria exist, use them exactly. If UNKNOWN, mark UNKNOWN.
209
+
210
+ ### Stage 14: Simulate Judge Questions
211
+
212
+ Construct questions a judge would ask:
213
+ - Each question: ID, persona, question text, why asked, relevant criterion, expected answer points, evidence, potential trap, confidence
214
+ - Map questions to criteria
215
+ - Do not fabricate judge answers
216
+
217
+ ### Stage 15: Challenge Claims
218
+
219
+ Cross-check claims against:
220
+ - Phase 2 evidence
221
+ - Phase 3 project plan
222
+ - Phase 4 implementation
223
+ - Phase 5 testing/security
224
+ - Phase 7 UX
225
+ - Phase 8 Red Team
226
+ - repository
227
+ - demo
228
+
229
+ Flag contradictions:
230
+
231
+ ```text
232
+ Documentation says X
233
+ Repository does Y
234
+ Demo shows Z
235
+ ```
236
+
237
+ Do not silently reconcile contradictions. Record them.
238
+
239
+ ### Stage 16: Assess Judge Confidence
240
+
241
+ Assess whether a skeptical judge could trust the project's claims:
242
+ - claims backed by evidence
243
+ - metrics backed by evidence
244
+ - documentation consistent with implementation
245
+ - demo consistent with repository
246
+ - no exaggerated AI claims
247
+ - no unsupported production claims
248
+ - limitations visible
249
+
250
+ If evidence is missing:
251
+
252
+ ```text
253
+ UNKNOWN
254
+ ```
255
+
256
+ ### Stage 17: Identify Judge Concerns
257
+
258
+ Identify concerns judges would raise:
259
+ - unsupported claims
260
+ - weak differentiation
261
+ - demo failure risk
262
+ - technical credibility issues
263
+ - UX problems
264
+ - missing evidence
265
+ - hidden limitations
266
+
267
+ Assign severity:
268
+ - CRITICAL, HIGH, MEDIUM, LOW, INFO, UNKNOWN
269
+
270
+ Do not inflate severity.
271
+
272
+ ### Stage 18: Prioritize Preparation Needs
273
+
274
+ Priority order:
275
+ 1. CRITICAL demo failure
276
+ 2. CRITICAL credibility issue
277
+ 3. HIGH reliability risk
278
+ 4. HIGH differentiation weakness
279
+ 5. HIGH unsupported claim
280
+ 6. HIGH UX/demo friction
281
+ 7. important technical risk
282
+ 8. evidence gaps
283
+ 9. medium risks
284
+ 10. low-risk polish
285
+
286
+ Do not prioritize cosmetic issues over project-breaking risks.
287
+
288
+ ### Stage 19: Produce Judge Simulation Report
289
+
290
+ Use `templates/judge-simulation.md` as the record format.
291
+
292
+ Save to `.sherpa/judge-simulation.md`.
293
+
294
+ Include:
295
+ - Project
296
+ - Judge personas simulated
297
+ - Judging criteria and weights
298
+ - Current state
299
+ - Target outcome
300
+ - Current architecture
301
+ - Proposed architecture
302
+ - Components
303
+ - Data flow
304
+ - APIs/interfaces
305
+ - Database/storage
306
+ - AI/ML
307
+ - External services
308
+ - Deployment
309
+ - MVP
310
+ - MUST/SHOULD/OPTIONAL/EXCLUDED
311
+ - Implementation workstreams
312
+ - Dependencies
313
+ - Critical path
314
+ - Technical risks
315
+ - Security priorities
316
+ - Testing priorities
317
+ - UX priorities
318
+ - Time strategy
319
+ - Judge questions
320
+ - Expected answer quality
321
+ - Likely objections
322
+ - Technical credibility
323
+ - Product credibility
324
+ - Demo credibility
325
+ - Claim consistency
326
+ - Differentiation perception
327
+ - Judge trust
328
+ - Critical preparation risks
329
+ - Unknowns
330
+ - Time strategy
331
+ - Judge readiness
332
+ - Primary next action
333
+
334
+ ### Stage 20: Update Project State
335
+
336
+ Update ONLY these compact fields in `.sherpa/project-state.md`:
337
+
338
+ | Field | New Value |
339
+ |-------|-----------|
340
+ | Judge Simulation Status | NOT_STARTED | IN_PROGRESS | BLOCKED | COMPLETE |
341
+ | Judge Baseline | UNKNOWN | VERIFIED |
342
+ | Judge Criteria | UNKNOWN | IDENTIFIED | REVIEWED |
343
+ | Critical Judge Concerns | UNKNOWN | NONE | IDENTIFIED |
344
+ | Judge Readiness | NOT_READY | IN_PROGRESS | BLOCKED | CONDITIONAL | READY |
345
+
346
+ Rules:
347
+ - Do NOT put detailed judge simulation inside project-state.md.
348
+ - Detailed material goes to `.sherpa/judge-simulation.md` and `.sherpa/judge/`.
349
+ - Do not change `selected idea`.
350
+ - Do not silently change architecture.
351
+ - Human approval required for architecture changes.
352
+
353
+ ### Stage 21: Return Exactly One Primary Next Action
354
+
355
+ Output format:
356
+
357
+ ```
358
+ PRIMARY NEXT ACTION: <exactly one action>
359
+
360
+ WHY: <explanation based on impact, time, risk, and judging criteria>
361
+
362
+ DONE WHEN: <clear definition of done>
363
+
364
+ Time remaining: <hours or UNKNOWN>
365
+
366
+ Blocked by: <blocker or "None">
367
+ ```
368
+
369
+ Rule: Exactly one primary next action. Do not produce competing alternatives.
370
+
371
+ ---
372
+
373
+ ## Validation Checklist
374
+
375
+ After JUDGE-SIM completes:
376
+
377
+ - [ ] Selected idea verified (or gate triggered)
378
+ - [ ] Readiness verified (or BLOCKED/LIMITED reported)
379
+ - [ ] Phase 2–8 evidence consumed
380
+ - [ ] Repository inspected
381
+ - [ ] Judging criteria identified (or UNKNOWN)
382
+ - [ ] Judge personas identified
383
+ - [ ] First impression evaluated
384
+ - [ ] Judge-visible strengths and weaknesses identified
385
+ - [ ] Criterion-by-criterion observations made
386
+ - [ ] Simulated judge questions created
387
+ - [ ] Expected answer quality assessed
388
+ - [ ] Likely objections documented
389
+ - [ ] Technical credibility assessed
390
+ - [ ] Product credibility assessed
391
+ - [ ] Demo credibility assessed
392
+ - [ ] Claim consistency checked
393
+ - [ ] Differentiation perception evaluated
394
+ - [ ] Judge trust assessed
395
+ - [ ] Critical preparation risks identified
396
+ - [ ] Unknowns documented
397
+ - [ ] Time-aware strategy applied
398
+ - [ ] Unknown deadline not assumed
399
+ - [ ] Judge readiness gate evaluated
400
+ - [ ] No application source code modified
401
+ - [ ] No Phase 1–8 files modified
402
+ - [ ] No Phase 5/7/8 engines duplicated
403
+ - [ ] No score optimization performed
404
+ - [ ] No simulated score presented as official score
405
+ - [ ] No idea silently changed
406
+ - [ ] No architecture silently redesigned
407
+ - [ ] project-state.md remains compact
408
+ - [ ] Exactly ONE primary next action returned
@@ -0,0 +1,51 @@
1
+ # sherpa Lifecycle
2
+
3
+ Defines the hackathon lifecycle phases and how the skill transitions between them. The lifecycle is time-aware: strategy changes based on time remaining until the deadline.
4
+
5
+ ## Lifecycle Phases
6
+
7
+ | Phase | When | Primary Focus |
8
+ |-------|------|---------------|
9
+ | Understand Rules | Start | Read hackathon rules, judging criteria, submission requirements |
10
+ | Analyze Problem | Start | Understand the problem statement, target users, constraints |
11
+ | Generate Ideas | Early | Brainstorm and capture candidate ideas |
12
+ | Validate Ideas | Early | Evaluate ideas against judging criteria, feasibility, differentiation |
13
+ | Research Market | Early | Research existing solutions and competitors |
14
+ | Select Idea | Early-Mid | Choose the strongest idea to build |
15
+ | Design Product/MVP | Mid | Define product scope, MVP, user flows |
16
+ | Architecture | Mid | Decide technical architecture, tech stack |
17
+ | Development Plan | Mid | Create implementation plan with time estimates |
18
+ | Implementation | Mid-Late | Build the MVP |
19
+ | Testing + Security | Late | Test the project, secure the application |
20
+ | UX Review | Late | Review and improve UI/UX |
21
+ | Red Team | Late | Actively find reasons the project could lose |
22
+ | Judge Simulation | Late | Simulate multiple judge types |
23
+ | Score Optimization | Late | Optimize based on judging criteria gaps |
24
+ | Demo Preparation | Final | Prepare the demo |
25
+ | PPT / Presentation | Final | Prepare the presentation |
26
+ | Final Audit | Final | Final consistency and claim verification |
27
+ | Submission | Final | Submit the project |
28
+ | Post-Mortem | After | Analyze what worked and what didn't |
29
+
30
+ ## Time-Aware Strategy
31
+
32
+ The skill adjusts its recommendations based on time remaining:
33
+
34
+ | Time Remaining | Strategy | What to STOP |
35
+ |----------------|----------|--------------|
36
+ | > 24 hours | Core product, differentiation, architecture, important features, validation | Low-judging-value features |
37
+ | 12–24 hours | Completing MVP, high-impact features, integration, testing | New feature exploration |
38
+ | 6–12 hours | Stability, testing, UX, security, demo reliability, presentation | Architectural changes |
39
+ | 2–6 hours | Bug fixing, demo flow, critical polish, PPT, documentation, deployment reliability | Any new feature development |
40
+ | < 2 hours | Build working, deployment working, demo working, PPT accurate, links working, critical bugs fixed, submission requirements satisfied | All feature development |
41
+
42
+ ## How the Router Determines Phase
43
+
44
+ 1. Read `.sherpa/project-state.md`.
45
+ 2. Check the `Phase` field (if `UNKNOWN`, default to "Understand Rules").
46
+ 3. Check `Time remaining` against the deadline.
47
+ 4. The phase + time remaining determine which workflow guidance applies.
48
+
49
+ ## Persistence
50
+
51
+ The lifecycle phase and time remaining are stored in `.sherpa/project-state.md` and updated on every skill invocation.
@@ -0,0 +1,96 @@
1
+ # sherpa — NEXT Workflow
2
+
3
+ **Operation**: NEXT
4
+ **Purpose**: Identify exactly ONE highest-priority action to take right now, based on project state, time remaining, risks, and judging criteria.
5
+
6
+ ## When to Use
7
+
8
+ Use NEXT when:
9
+ - You need to know what to work on right now
10
+ - You want to avoid wasting time on low-impact tasks
11
+ - You want a single clear direction instead of a long task list
12
+
13
+ ## Workflow Steps
14
+
15
+ ### Step 1: Verify State Exists
16
+
17
+ Check if `.sherpa/project-state.md` exists. If not, recommend INIT first and stop.
18
+
19
+ ### Step 2: Read Project State
20
+
21
+ Read `.sherpa/project-state.md` and capture:
22
+ - Phase
23
+ - Time remaining (from deadline)
24
+ - Completed work, current work, blocked work
25
+ - Risks, known weaknesses
26
+ - Current estimated score, potential score
27
+ - Largest gaps
28
+ - Judging criteria and weights
29
+
30
+ ### Step 3: Inspect Repository for Evidence
31
+
32
+ Inspect the repository to verify the current state of implementation. Look for broken features, missing tests, missing deployment config, etc.
33
+
34
+ ### Step 4: Apply Time-Aware Filtering
35
+
36
+ Filter candidate actions based on time remaining:
37
+
38
+ | Time Remaining | Allow | Block |
39
+ |----------------|-------|-------|
40
+ | > 24 hours | Core product, differentiation, architecture, important features, validation | Low-judging-value features |
41
+ | 12–24 hours | Completing MVP, high-impact features, integration, testing | New feature exploration |
42
+ | 6–12 hours | Stability, testing, UX, security, demo reliability, presentation | Architectural changes |
43
+ | 2–6 hours | Bug fixing, demo flow, critical polish, PPT, documentation, deployment reliability | Any new feature development |
44
+ | < 2 hours | Build working, deployment working, demo working, PPT accurate, links working, critical bugs fixed, submission requirements | All feature development |
45
+
46
+ ### Step 5: Apply Red-Team Filtering
47
+
48
+ For each candidate action, ask:
49
+ - Does this address a known weakness or risk?
50
+ - Would a judge likely penalize us if this is not done?
51
+ - Is this fixing a contradiction between PPT/README/code/demo?
52
+ - Is this addressing the biggest current risk?
53
+
54
+ ### Step 6: Score Candidates
55
+
56
+ For each remaining candidate, estimate:
57
+ - Expected judging impact (High/Medium/Low)
58
+ - Implementation effort (Small/Medium/Large)
59
+ - Time required
60
+ - Technical risk
61
+ - Demo risk
62
+ - Alignment with judging criteria weights
63
+
64
+ ### Step 7: Select ONE Primary Next Action
65
+
66
+ Choose the candidate with the highest `judging impact / time / risk` ratio. There must be exactly ONE.
67
+
68
+ Report:
69
+
70
+ ```
71
+ PRIMARY NEXT ACTION: [action name]
72
+
73
+ Why this is the highest priority:
74
+ [explanation based on impact, time, risk, and judging criteria]
75
+
76
+ What you need to do:
77
+ [specific, actionable steps]
78
+
79
+ What completion looks like:
80
+ [clear definition of done]
81
+
82
+ Time remaining: [time or UNKNOWN]
83
+ Blocked by: [any blockers or "None"]
84
+ ```
85
+
86
+ Secondary actions may be listed optionally, but must be clearly marked as secondary.
87
+
88
+ ## Validation
89
+
90
+ After NEXT completes:
91
+ - [ ] Exactly one primary next action is identified
92
+ - [ ] The "why" explains impact, time, risk, and judging criteria alignment
93
+ - [ ] "What you need to do" is specific and actionable
94
+ - [ ] "What completion looks like" is a clear definition of done
95
+ - [ ] Time-aware filtering was applied
96
+ - [ ] Secondary actions (if any) are clearly marked as secondary
@@ -0,0 +1,76 @@
1
+ # sherpa — POSTMORTEM Workflow
2
+
3
+ **Lifecycle Phase:** 20 — Post-Mortem Intelligence (final phase)
4
+ **Purpose:** Preserve evidence-based lessons from the completed hackathon cycle.
5
+
6
+ ## Prerequisites
7
+
8
+ 1. Read `SKILL.md` and `workflows/lifecycle.md`; require exactly 20 phases with Phase 18 Final Audit, Phase 19 Submission, Phase 20 Post-Mortem. Never extend or renumber.
9
+ 2. Read `.sherpa/project-state.md`, `.sherpa/submission-plan.md`, and relevant files under `.sherpa/submission/` when present. If these do not establish a completed submission-readiness review, scope the result as `CONDITIONAL — FRAMEWORK VALIDATION ONLY`; do not treat framework test output as project history.
10
+ 3. Inspect Phase 19 rules, workflow, and templates alongside the available project records. Preserve prior project artifacts and behavior.
11
+ 4. If project state is absent, record that no live project state was inspected. Never write project state into this framework repository.
12
+
13
+ ## Procedure
14
+
15
+ 1. Determine evidence scope: LIVE POST-MORTEM only with sufficient actual project history; otherwise `CONDITIONAL — FRAMEWORK VALIDATION ONLY`.
16
+ 2. Inventory available historical artifacts and their provenance. Distinguish framework tests from live project records.
17
+ 3. Label every significant statement FACT, INFERENCE, ASSUMPTION, or UNKNOWN. Cite evidence. Never fill history gaps with typical or synthetic events.
18
+ 4. Review all 20 phases. For each, record purpose, usage, evidence, value, problems, redundancy, missing capability, contract gap and recommendation; unavailable project effectiveness is UNKNOWN.
19
+ 5. Build timeline and plan-vs-actual tables. Missing planned/actual dates, durations and events remain UNKNOWN. Classify time variance only when evidenced.
20
+ 6. Review planned/added/removed/deferred/accidental scope. Call scope creep only with evidence.
21
+ 7. Review important decisions with contemporaneous context, evidence, options, authority, expected/actual outcome, quality and lesson. Do not infer decision ownership.
22
+ 8. Record incidents only when supported by artifacts. Analyze observed outcome separately from cause; include counterevidence, alternatives, confidence and causality status.
23
+ 9. Review original risks against observed outcomes. Unknown exposure remains UNKNOWN, not AVOIDED.
24
+ 10. Review Phases 11–19 outcomes (testing/security, UX, red team, judge simulation, score optimization, demo, presentation, submission) only against actual records. Keep simulated judging/optimization separate from actual judging results.
25
+ 11. Record official result only from official evidence. Otherwise result = UNKNOWN. Do not infer participation/result from framework status.
26
+ 12. Identify evidence-backed wins and failures without blame. Extract lessons and reusable assets without modifying prior locked assets.
27
+ 13. Evaluate sherpa Phases 1–19, bottlenecks, process debt, contract gaps, and proposed internal improvement backlog. Label its priorities as internal, not judging scores.
28
+ 14. Add `postmortem` state only in the actual project's `.sherpa/project-state.md`, with listed fields and UNKNOWN where evidence is absent. Preserve all existing state. Never create project state in this skill repository.
29
+ 15. Run evidence-integrity and historical-integrity checks; ensure no prior evidence was edited, no unsupported causality/result/score/judge statement appears, and no Phase 21 exists.
30
+ 16. Produce the post-mortem artifact and exactly one `PRIMARY NEXT ACTION`. For framework-only validation this may be archival preservation of this completed cycle.
31
+
32
+ ## Project state extension (actual project repository only)
33
+
34
+ ```yaml
35
+ postmortem:
36
+ status: UNKNOWN
37
+ evidence_scope: UNKNOWN
38
+ outcome: UNKNOWN
39
+ result: UNKNOWN
40
+ timeline_status: UNKNOWN
41
+ decision_review: UNKNOWN
42
+ incident_count: UNKNOWN
43
+ risk_outcome_status: UNKNOWN
44
+ lessons_count: UNKNOWN
45
+ reusable_assets_count: UNKNOWN
46
+ process_bottlenecks: UNKNOWN
47
+ process_debt: UNKNOWN
48
+ sherpa_effectiveness: UNKNOWN
49
+ contract_gaps: UNKNOWN
50
+ improvement_backlog: UNKNOWN
51
+ human_review: UNKNOWN
52
+ final_status: UNKNOWN
53
+ primary_next_action: UNKNOWN
54
+ ```
55
+
56
+ Do not insert these values into the skill repository or overwrite prior state.
57
+
58
+ ## Required report sections
59
+
60
+ Use `templates/postmortem.md` and include all 35 numbered sections listed there. Keep actual project claims UNKNOWN where evidence is missing. The post-mortem artifact for a real project belongs under that project's `.sherpa/` directory. Contract harnesses report to stdout and do not create repository audit reports.
61
+
62
+ ## Boundaries
63
+
64
+ Do not modify application source, dependencies, deployments, submissions, repository visibility, prior phase artifacts, or the lifecycle map. Do not implement a Phase 21. Recommendations are recorded for future human-authorized work only.
65
+
66
+ ## Explicit review matrix
67
+
68
+ For all phase reviews, use this record: Phase; Purpose; Used?; Evidence; Value; Problems; Redundancy; Missing Capability; Contract Gap; Recommendation; Effectiveness. Review Phase 1 Rules, 2 Problem, 3 Ideas, 4 Validation, 5 Research, 6 Idea Selection, 7 MVP, 8 Architecture, 9 Development Plan, 10 Implementation, 11 Testing + Security, 12 UX, 13 Red Team, 14 Judge Simulation, 15 Score Optimization, 16 Demo Preparation, 17 Presentation, 18 Final Audit, and 19 Submission. Framework tests are not evidence of live project effectiveness.
69
+
70
+ The plan-vs-actual matrix has rows for timeline, scope, architecture, implementation, testing, security, UX, demo, presentation, and submission. Each row captures planned, actual, variance, evidence, reason, and impact. Unavailable values are UNKNOWN.
71
+
72
+ Record observed outcome separately from possible causes. For every cause include evidence supporting and against it, alternatives, confidence, and causality status. Record the official result only in a separate outcome section with source evidence; otherwise UNKNOWN.
73
+
74
+ Record explicit human approvals, rejected recommendations, scope and architecture decisions, risk acceptance, and final submission confirmation only when documented. Ownership otherwise UNKNOWN.
75
+
76
+ Bottleneck categories are TOOLING, PROCESS, KNOWLEDGE, TIME, DEPENDENCY, HUMAN_DECISION, COMMUNICATION, UNKNOWN. Reusable assets must include asset, location, purpose, quality, reuse recommendation, and required changes. Internal improvement priority is not official hackathon scoring.