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.
- package/.agents/plugins/marketplace.json +11 -0
- package/.agents/skills/sherpa/SKILL.md +161 -0
- package/.agents/skills/sherpa/commands/README.md +43 -0
- package/.agents/skills/sherpa/commands/manifest.json +589 -0
- package/.agents/skills/sherpa/commands/sherpa-research.md +147 -0
- package/.agents/skills/sherpa/core/commands/router.py +171 -0
- package/.agents/skills/sherpa/core/configuration/manager.py +504 -0
- package/.agents/skills/sherpa/core/ideas/engine.py +564 -0
- package/.agents/skills/sherpa/docs/commands/README.md +96 -0
- package/.agents/skills/sherpa/docs/configuration/runtime-verification.md +64 -0
- package/.agents/skills/sherpa/rules/demo-preparation-rules.md +543 -0
- package/.agents/skills/sherpa/rules/engineering-rules.md +221 -0
- package/.agents/skills/sherpa/rules/final-audit-rules.md +824 -0
- package/.agents/skills/sherpa/rules/implementation-rules.md +127 -0
- package/.agents/skills/sherpa/rules/judge-rules.md +443 -0
- package/.agents/skills/sherpa/rules/mentor-rules.md +109 -0
- package/.agents/skills/sherpa/rules/postmortem-rules.md +69 -0
- package/.agents/skills/sherpa/rules/presentation-rules.md +783 -0
- package/.agents/skills/sherpa/rules/red-team-rules.md +185 -0
- package/.agents/skills/sherpa/rules/research-rules.md +184 -0
- package/.agents/skills/sherpa/rules/score-optimization-rules.md +355 -0
- package/.agents/skills/sherpa/rules/scoring-rules.md +216 -0
- package/.agents/skills/sherpa/rules/submission-rules.md +41 -0
- package/.agents/skills/sherpa/rules/testing-security-rules.md +87 -0
- package/.agents/skills/sherpa/rules/ux-rules.md +89 -0
- package/.agents/skills/sherpa/src/config_manager.py +474 -0
- package/.agents/skills/sherpa/src/verification.py +458 -0
- package/.agents/skills/sherpa/templates/audit-finding.md +20 -0
- package/.agents/skills/sherpa/templates/claim-audit.md +15 -0
- package/.agents/skills/sherpa/templates/configuration/hackathon.json +21 -0
- package/.agents/skills/sherpa/templates/configuration/integrations.env.example +3 -0
- package/.agents/skills/sherpa/templates/configuration/project.env.example +12 -0
- package/.agents/skills/sherpa/templates/configuration/providers.env.example +4 -0
- package/.agents/skills/sherpa/templates/configuration/settings.json +22 -0
- package/.agents/skills/sherpa/templates/consistency-audit.md +17 -0
- package/.agents/skills/sherpa/templates/decision-log.md +18 -0
- package/.agents/skills/sherpa/templates/demo-checkpoint.md +42 -0
- package/.agents/skills/sherpa/templates/demo-evidence.md +32 -0
- package/.agents/skills/sherpa/templates/demo-finding.md +112 -0
- package/.agents/skills/sherpa/templates/demo-flow.md +52 -0
- package/.agents/skills/sherpa/templates/demo-plan.md +265 -0
- package/.agents/skills/sherpa/templates/demo-verification.md +57 -0
- package/.agents/skills/sherpa/templates/final-audit.md +387 -0
- package/.agents/skills/sherpa/templates/final-risk.md +17 -0
- package/.agents/skills/sherpa/templates/final-verification.md +57 -0
- package/.agents/skills/sherpa/templates/gap-analysis.md +113 -0
- package/.agents/skills/sherpa/templates/idea-comparison.md +129 -0
- package/.agents/skills/sherpa/templates/idea-evaluation.md +251 -0
- package/.agents/skills/sherpa/templates/implementation-plan.md +96 -0
- package/.agents/skills/sherpa/templates/implementation-task.md +57 -0
- package/.agents/skills/sherpa/templates/improvement-candidate.md +135 -0
- package/.agents/skills/sherpa/templates/improvement.md +18 -0
- package/.agents/skills/sherpa/templates/incident.md +20 -0
- package/.agents/skills/sherpa/templates/judge-criterion.md +41 -0
- package/.agents/skills/sherpa/templates/judge-question.md +41 -0
- package/.agents/skills/sherpa/templates/judge-session.md +125 -0
- package/.agents/skills/sherpa/templates/judge-simulation.md +264 -0
- package/.agents/skills/sherpa/templates/lesson.md +14 -0
- package/.agents/skills/sherpa/templates/postmortem.md +87 -0
- package/.agents/skills/sherpa/templates/presentation-evidence.md +33 -0
- package/.agents/skills/sherpa/templates/presentation-plan.md +349 -0
- package/.agents/skills/sherpa/templates/presentation-qna.md +29 -0
- package/.agents/skills/sherpa/templates/presentation-risk.md +42 -0
- package/.agents/skills/sherpa/templates/presentation-verification.md +57 -0
- package/.agents/skills/sherpa/templates/project-plan.md +242 -0
- package/.agents/skills/sherpa/templates/project-state.md +84 -0
- package/.agents/skills/sherpa/templates/red-team-finding.md +73 -0
- package/.agents/skills/sherpa/templates/red-team-review.md +105 -0
- package/.agents/skills/sherpa/templates/red-team-scenario.md +43 -0
- package/.agents/skills/sherpa/templates/red-team-verification.md +31 -0
- package/.agents/skills/sherpa/templates/repo-analysis.md +204 -0
- package/.agents/skills/sherpa/templates/requirement-audit.md +15 -0
- package/.agents/skills/sherpa/templates/research-comparison.md +124 -0
- package/.agents/skills/sherpa/templates/research-plan.md +93 -0
- package/.agents/skills/sherpa/templates/research-report.md +92 -0
- package/.agents/skills/sherpa/templates/research-source.md +77 -0
- package/.agents/skills/sherpa/templates/score-optimization-plan.md +197 -0
- package/.agents/skills/sherpa/templates/security-finding.md +45 -0
- package/.agents/skills/sherpa/templates/security-review.md +64 -0
- package/.agents/skills/sherpa/templates/slide-claim.md +47 -0
- package/.agents/skills/sherpa/templates/slide-plan.md +127 -0
- package/.agents/skills/sherpa/templates/submission-artifact.md +15 -0
- package/.agents/skills/sherpa/templates/submission-checklist.md +24 -0
- package/.agents/skills/sherpa/templates/submission-field.md +14 -0
- package/.agents/skills/sherpa/templates/submission-link.md +14 -0
- package/.agents/skills/sherpa/templates/submission-plan.md +31 -0
- package/.agents/skills/sherpa/templates/submission-readiness.md +18 -0
- package/.agents/skills/sherpa/templates/submission-requirement.md +12 -0
- package/.agents/skills/sherpa/templates/submission-risk.md +14 -0
- package/.agents/skills/sherpa/templates/submission-snapshot.md +20 -0
- package/.agents/skills/sherpa/templates/submission-verification.md +12 -0
- package/.agents/skills/sherpa/templates/test-plan.md +59 -0
- package/.agents/skills/sherpa/templates/test-result.md +46 -0
- package/.agents/skills/sherpa/templates/timeline.md +11 -0
- package/.agents/skills/sherpa/templates/ux-finding.md +56 -0
- package/.agents/skills/sherpa/templates/ux-flow.md +46 -0
- package/.agents/skills/sherpa/templates/ux-review.md +113 -0
- package/.agents/skills/sherpa/templates/ux-verification.md +32 -0
- package/.agents/skills/sherpa/workflows/configuration.md +23 -0
- package/.agents/skills/sherpa/workflows/demo-preparation.md +399 -0
- package/.agents/skills/sherpa/workflows/final-audit.md +713 -0
- package/.agents/skills/sherpa/workflows/idea-evaluation.md +239 -0
- package/.agents/skills/sherpa/workflows/idea-intelligence.md +69 -0
- package/.agents/skills/sherpa/workflows/implementation.md +42 -0
- package/.agents/skills/sherpa/workflows/init.md +102 -0
- package/.agents/skills/sherpa/workflows/judge-simulation.md +408 -0
- package/.agents/skills/sherpa/workflows/lifecycle.md +51 -0
- package/.agents/skills/sherpa/workflows/next.md +96 -0
- package/.agents/skills/sherpa/workflows/postmortem.md +76 -0
- package/.agents/skills/sherpa/workflows/presentation.md +522 -0
- package/.agents/skills/sherpa/workflows/project-planning.md +327 -0
- package/.agents/skills/sherpa/workflows/red-team.md +373 -0
- package/.agents/skills/sherpa/workflows/research.md +142 -0
- package/.agents/skills/sherpa/workflows/score-optimization.md +276 -0
- package/.agents/skills/sherpa/workflows/status.md +107 -0
- package/.agents/skills/sherpa/workflows/submission.md +46 -0
- package/.agents/skills/sherpa/workflows/testing-security.md +44 -0
- package/.agents/skills/sherpa/workflows/ux-review.md +59 -0
- package/.claude-plugin/marketplace.json +21 -0
- package/.claude-plugin/plugin.json +13 -0
- package/.codex-plugin/plugin.json +13 -0
- package/GEMINI.md +3 -0
- package/README.md +11 -7
- package/SKILL.md +161 -0
- package/distribution/cli/sherpa +1 -1
- package/gemini-extension.json +7 -0
- package/package.json +31 -3
- package/plugin.json +20 -0
- package/qwen-extension.json +6 -0
- package/skills/sherpa/SKILL.md +161 -0
- package/skills/sherpa/commands/README.md +43 -0
- package/skills/sherpa/commands/manifest.json +589 -0
- package/skills/sherpa/commands/sherpa-research.md +147 -0
- package/skills/sherpa/core/commands/router.py +171 -0
- package/skills/sherpa/core/configuration/manager.py +504 -0
- package/skills/sherpa/core/ideas/engine.py +564 -0
- package/skills/sherpa/docs/commands/README.md +96 -0
- package/skills/sherpa/docs/configuration/runtime-verification.md +64 -0
- package/skills/sherpa/rules/demo-preparation-rules.md +543 -0
- package/skills/sherpa/rules/engineering-rules.md +221 -0
- package/skills/sherpa/rules/final-audit-rules.md +824 -0
- package/skills/sherpa/rules/implementation-rules.md +127 -0
- package/skills/sherpa/rules/judge-rules.md +443 -0
- package/skills/sherpa/rules/mentor-rules.md +109 -0
- package/skills/sherpa/rules/postmortem-rules.md +69 -0
- package/skills/sherpa/rules/presentation-rules.md +783 -0
- package/skills/sherpa/rules/red-team-rules.md +185 -0
- package/skills/sherpa/rules/research-rules.md +184 -0
- package/skills/sherpa/rules/score-optimization-rules.md +355 -0
- package/skills/sherpa/rules/scoring-rules.md +216 -0
- package/skills/sherpa/rules/submission-rules.md +41 -0
- package/skills/sherpa/rules/testing-security-rules.md +87 -0
- package/skills/sherpa/rules/ux-rules.md +89 -0
- package/skills/sherpa/src/config_manager.py +474 -0
- package/skills/sherpa/src/verification.py +458 -0
- package/skills/sherpa/templates/audit-finding.md +20 -0
- package/skills/sherpa/templates/claim-audit.md +15 -0
- package/skills/sherpa/templates/configuration/hackathon.json +21 -0
- package/skills/sherpa/templates/configuration/integrations.env.example +3 -0
- package/skills/sherpa/templates/configuration/project.env.example +12 -0
- package/skills/sherpa/templates/configuration/providers.env.example +4 -0
- package/skills/sherpa/templates/configuration/settings.json +22 -0
- package/skills/sherpa/templates/consistency-audit.md +17 -0
- package/skills/sherpa/templates/decision-log.md +18 -0
- package/skills/sherpa/templates/demo-checkpoint.md +42 -0
- package/skills/sherpa/templates/demo-evidence.md +32 -0
- package/skills/sherpa/templates/demo-finding.md +112 -0
- package/skills/sherpa/templates/demo-flow.md +52 -0
- package/skills/sherpa/templates/demo-plan.md +265 -0
- package/skills/sherpa/templates/demo-verification.md +57 -0
- package/skills/sherpa/templates/final-audit.md +387 -0
- package/skills/sherpa/templates/final-risk.md +17 -0
- package/skills/sherpa/templates/final-verification.md +57 -0
- package/skills/sherpa/templates/gap-analysis.md +113 -0
- package/skills/sherpa/templates/idea-comparison.md +129 -0
- package/skills/sherpa/templates/idea-evaluation.md +251 -0
- package/skills/sherpa/templates/implementation-plan.md +96 -0
- package/skills/sherpa/templates/implementation-task.md +57 -0
- package/skills/sherpa/templates/improvement-candidate.md +135 -0
- package/skills/sherpa/templates/improvement.md +18 -0
- package/skills/sherpa/templates/incident.md +20 -0
- package/skills/sherpa/templates/judge-criterion.md +41 -0
- package/skills/sherpa/templates/judge-question.md +41 -0
- package/skills/sherpa/templates/judge-session.md +125 -0
- package/skills/sherpa/templates/judge-simulation.md +264 -0
- package/skills/sherpa/templates/lesson.md +14 -0
- package/skills/sherpa/templates/postmortem.md +87 -0
- package/skills/sherpa/templates/presentation-evidence.md +33 -0
- package/skills/sherpa/templates/presentation-plan.md +349 -0
- package/skills/sherpa/templates/presentation-qna.md +29 -0
- package/skills/sherpa/templates/presentation-risk.md +42 -0
- package/skills/sherpa/templates/presentation-verification.md +57 -0
- package/skills/sherpa/templates/project-plan.md +242 -0
- package/skills/sherpa/templates/project-state.md +84 -0
- package/skills/sherpa/templates/red-team-finding.md +73 -0
- package/skills/sherpa/templates/red-team-review.md +105 -0
- package/skills/sherpa/templates/red-team-scenario.md +43 -0
- package/skills/sherpa/templates/red-team-verification.md +31 -0
- package/skills/sherpa/templates/repo-analysis.md +204 -0
- package/skills/sherpa/templates/requirement-audit.md +15 -0
- package/skills/sherpa/templates/research-comparison.md +124 -0
- package/skills/sherpa/templates/research-plan.md +93 -0
- package/skills/sherpa/templates/research-report.md +92 -0
- package/skills/sherpa/templates/research-source.md +77 -0
- package/skills/sherpa/templates/score-optimization-plan.md +197 -0
- package/skills/sherpa/templates/security-finding.md +45 -0
- package/skills/sherpa/templates/security-review.md +64 -0
- package/skills/sherpa/templates/slide-claim.md +47 -0
- package/skills/sherpa/templates/slide-plan.md +127 -0
- package/skills/sherpa/templates/submission-artifact.md +15 -0
- package/skills/sherpa/templates/submission-checklist.md +24 -0
- package/skills/sherpa/templates/submission-field.md +14 -0
- package/skills/sherpa/templates/submission-link.md +14 -0
- package/skills/sherpa/templates/submission-plan.md +31 -0
- package/skills/sherpa/templates/submission-readiness.md +18 -0
- package/skills/sherpa/templates/submission-requirement.md +12 -0
- package/skills/sherpa/templates/submission-risk.md +14 -0
- package/skills/sherpa/templates/submission-snapshot.md +20 -0
- package/skills/sherpa/templates/submission-verification.md +12 -0
- package/skills/sherpa/templates/test-plan.md +59 -0
- package/skills/sherpa/templates/test-result.md +46 -0
- package/skills/sherpa/templates/timeline.md +11 -0
- package/skills/sherpa/templates/ux-finding.md +56 -0
- package/skills/sherpa/templates/ux-flow.md +46 -0
- package/skills/sherpa/templates/ux-review.md +113 -0
- package/skills/sherpa/templates/ux-verification.md +32 -0
- package/skills/sherpa/workflows/configuration.md +23 -0
- package/skills/sherpa/workflows/demo-preparation.md +399 -0
- package/skills/sherpa/workflows/final-audit.md +713 -0
- package/skills/sherpa/workflows/idea-evaluation.md +239 -0
- package/skills/sherpa/workflows/idea-intelligence.md +69 -0
- package/skills/sherpa/workflows/implementation.md +42 -0
- package/skills/sherpa/workflows/init.md +102 -0
- package/skills/sherpa/workflows/judge-simulation.md +408 -0
- package/skills/sherpa/workflows/lifecycle.md +51 -0
- package/skills/sherpa/workflows/next.md +96 -0
- package/skills/sherpa/workflows/postmortem.md +76 -0
- package/skills/sherpa/workflows/presentation.md +522 -0
- package/skills/sherpa/workflows/project-planning.md +327 -0
- package/skills/sherpa/workflows/red-team.md +373 -0
- package/skills/sherpa/workflows/research.md +142 -0
- package/skills/sherpa/workflows/score-optimization.md +276 -0
- package/skills/sherpa/workflows/status.md +107 -0
- package/skills/sherpa/workflows/submission.md +46 -0
- package/skills/sherpa/workflows/testing-security.md +44 -0
- 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.
|