sherpa-skill 2.0.6 → 2.0.7

package/skills/sherpa/templates/research-plan.md

@@ -0,0 +1,93 @@
+# Research Plan — <research-query-id>
+
+**Evaluation date:** <UTC date/time>  
+**Hackathon:** <name or UNKNOWN>  
+**Deadline:** <date/time or UNKNOWN>  
+**Time remaining:** <hours or UNKNOWN>
+
+---
+
+## 1. Research Question
+
+**Question:** <the research question>  
+**Submitted by:** <team member or "team">  
+**Decision to support:** <what decision this research will inform>
+
+---
+
+## 2. Research Plan
+
+| # | What to find | Where to look | Evidence type expected | Confidence needed |
+|---|-------------|---------------|----------------------|-------------------|
+| 1 | | | | |
+| 2 | | | | |
+| 3 | | | | |
+
+**Time budget:** <time available for research>
+
+---
+
+## 3. Retrieved Evidence
+
+| # | Claim | Type | Source | Confidence | Verified? |
+|---|-------|------|--------|------------|-----------|
+| 1 | | | | | |
+| 2 | | | | | |
+| 3 | | | | | |
+
+---
+
+## 4. Research Findings
+
+### What is Known (FACT)
+
+| # | Claim | Source | Confidence |
+|---|-------|--------|-----------|
+| 1 | | | |
+| 2 | | | |
+
+### What is Reasonable (INFERENCE)
+
+| # | Claim | Reasoning | Evidence | Confidence |
+|---|-------|-----------|----------|-----------|
+| 1 | | | | |
+| 2 | | | | |
+
+### What is Assumed (ASSUMPTION)
+
+| # | Claim | Why assumed | Must be verified? |
+|---|-------|-------------|-------------------|
+| 1 | | | |
+| 2 | | | |
+
+### What is Unknown (UNKNOWN)
+
+| # | What is unknown | Why it matters |
+|---|-----------------|----------------|
+| 1 | | |
+| 2 | | |
+
+### Contradictions Found
+
+| # | Claim A | Evidence A | Claim B | Evidence B | Resolution |
+|---|---------|------------|---------|------------|------------|
+| 1 | | | | | |
+
+---
+
+## 5. Decision-Relevant Fields
+
+**Recommended outcome:** <what the research recommends>  
+**Why this outcome:** <explanation tied to evidence>  
+**What must be true for this to succeed:** <assumptions that must hold>  
+**Recommended next action:** <exactly ONE action>
+
+---
+
+## 6. Human Confirmation
+
+**Human confirmation status:** <pending | confirmed | rejected>  
+**Confirmed by:** <name or "pending">  
+**Confirmed at:** <UTC date/time or "pending">
+
+**Rule:** Only explicit human confirmation can act on research findings. The engine recommends; the human decides.

package/skills/sherpa/templates/research-report.md

@@ -0,0 +1,92 @@
+# Research Report — <research-query-id>
+
+**Evaluation date:** <UTC date/time>  
+**Hackathon:** <name or UNKNOWN>  
+**Deadline:** <date/time or UNKNOWN>  
+**Time remaining:** <hours or UNKNOWN>
+
+---
+
+## 1. Research Question
+
+**Question:** <the research question>  
+**Submitted by:** <team member or "team">  
+**Decision to support:** <what decision this research will inform>  
+**Research depth:** <calibration / standard / deep>  
+**Time budget:** <time available for research>
+
+---
+
+## 2. Research Evidence
+
+### Research Evidence Retrieval
+
+| # | Claim | Type | Source | Confidence | Verified? |
+|---|-------|------|--------|-----------|-----------|
+| 1 | | | | | |
+| 2 | | | | | |
+| 3 | | | | | |
+
+### Source List
+
+| # | Source | Type | Path/URL | Accessed at | Confidence |
+|---|--------|------|----------|-------------|------------|
+| 1 | | | | | |
+| 2 | | | | | |
+
+---
+
+## 3. Research Findings
+
+### What is Known (FACT)
+
+| # | Claim | Source | Confidence |
+|---|-------|--------|-----------|
+| 1 | | | |
+| 2 | | | |
+
+### What is Reasonable (INFERENCE)
+
+| # | Claim | Reasoning | Evidence | Confidence |
+|---|-------|-----------|----------|-----------|
+| 1 | | | | |
+| 2 | | | | |
+
+### What is Assumed (ASSUMPTION)
+
+| # | Claim | Why assumed | Must be verified? |
+|---|-------|-------------|-------------------|
+| 1 | | | |
+| 2 | | | |
+
+### What is Unknown (UNKNOWN)
+
+| # | What is unknown | Why it matters |
+|---|-----------------|----------------|
+| 1 | | |
+| 2 | | |
+
+### Contradictions Found
+
+| # | Claim A | Evidence A | Claim B | Evidence B | Resolution |
+|---|---------|------------|---------|------------|------------|
+| 1 | | | | | |
+
+---
+
+## 4. Decision-Relevant Fields
+
+**Recommended outcome:** <what the research recommends>  
+**Why this outcome:** <explanation tied to evidence>  
+**What must be true for this to succeed:** <assumptions that must hold>  
+**Recommended next action:** <exactly ONE action>
+
+---
+
+## 5. Human Confirmation
+
+**Human confirmation status:** <pending | confirmed | rejected>  
+**Confirmed by:** <name or "pending">  
+**Confirmed at:** <UTC date/time or "pending">
+
+**Rule:** Only explicit human confirmation can act on research findings. The engine recommends; the human decides. No automatic overwrite.

package/skills/sherpa/templates/research-source.md

@@ -0,0 +1,77 @@
+# Research Evidence Record — <evidence-id>
+
+**One-line description:** <one-sentence description of this evidence>
+
+**Submitted by:** <team member or "team">  
+**Evaluation date:** <UTC date/time>
+
+---
+
+## 1. Source Identification
+
+| Field | Value |
+|-------|-------|
+| Source type | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Source type category | Repository / Web / Team input / Documentation |
+| Source path/URL | <file path or URL> |
+| Accessed at | <UTC date/time> |
+| Source confidence | low / medium / high |
+
+---
+
+## 2. Claim
+
+**Claim text:** <the claim being evidenced>  
+**Claim type:** FACT / INFERENCE / ASSUMPTION / UNKNOWN  
+**Claim confidence:** low / medium / high  
+
+---
+
+## 3. Verification
+
+| Check | Result | Evidence |
+|-------|--------|----------|
+| Source exists and is accessible | YES / NO / UNKNOWN | |
+| Claim appears in source | YES / NO / UNKNOWN | |
+| Numbers match | YES / NO / UNKNOWN | |
+| Dates match | YES / NO / UNKNOWN | |
+| Entity names match | YES / NO / UNKNOWN | |
+| Polarity matches | YES / NO / UNKNOWN | |
+| Temporal consistency | YES / NO / UNKNOWN | |
+
+---
+
+## 4. Evidence Text
+
+```
+<verbatim excerpt from source>
+```
+
+---
+
+## 5. Relationship to Claim
+
+| Aspect | Match? | Detail |
+|--------|--------|--------|
+| Direct support | YES / NO / PARTIAL | |
+| Contradiction | YES / NO | |
+| Neutral context | YES / NO | |
+| Out of scope | YES / NO | |
+
+---
+
+## 6. Decision-Relevant Fields
+
+**What this evidence supports:** <what the evidence proves or disproves>  
+**What this evidence does NOT support:** <what the evidence does not prove>  
+**What must still be verified:** <remaining uncertainties>
+
+---
+
+## 7. Human Confirmation
+
+**Human confirmation status:** <pending | confirmed | rejected>  
+**Confirmed by:** <name or "pending">  
+**Confirmed at:** <UTC date/time or "pending">
+
+**Rule:** Only explicit human confirmation can act on research findings. The engine recommends; the human decides.

package/skills/sherpa/templates/score-optimization-plan.md

@@ -0,0 +1,197 @@
+# Score Optimization Plan — Phase 15
+
+**Project:** <project name or UNKNOWN>  
+**Repository:** <repository root or UNKNOWN>  
+**Plan date:** <UTC date/time>  
+**Plan status:** DRAFT | IN_PROGRESS | COMPLETE  
+**Hackathon:** <name or UNKNOWN>  
+**Time remaining:** <hours or UNKNOWN>  
+**Time-aware strategy:** <category or UNKNOWN>  
+**Selected idea:** <idea name or UNKNOWN>  
+**Phase 9 judge simulation:** <path to judge-simulation.md or UNKNOWN>
+
+---
+
+## 1. Evidence Base Consumed
+
+| Phase | Evidence Source | Status | Evidence Type |
+|-------|----------------|--------|---------------|
+| Phase 2 | `.sherpa/decisions.md`, idea evaluation | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 3 | `.sherpa/evidence/project-plan-*.md` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 4 | `.sherpa/evidence/` implementation artifacts | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 11 | `.sherpa/evidence/` testing/security artifacts | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 12 | `.sherpa/ux-review.md`, `.sherpa/ux/` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 13 | `.sherpa/red-team.md`, `.sherpa/red-team/` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 14 | `.sherpa/judge-simulation.md` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Repository | Direct repository inspection | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+
+**Rule:** Do not claim evidence was consumed unless the artifact was actually read.
+
+---
+
+## 2. Judging Criteria and Weights
+
+**Criteria status:** KNOWN | UNKNOWN
+
+| # | Criterion | Weight | Weight Source | Label |
+|---|-----------|--------|---------------|-------|
+| | | | | OFFICIAL / UNKNOWN / PROVISIONAL |
+
+If UNKNOWN: "Judging criteria unknown; score based on equal-weight provisional assessment. Do not treat provisional weights as official."
+
+---
+
+## 3. Current Evidence-Backed Score Position
+
+| # | Criterion | Weight | Current Performance (1–10) | Confidence | Score Label | Weighted Contribution | Evidence Basis |
+|---|-----------|--------|---------------------------|------------|-------------|----------------------|----------------|
+| | | | | | OFFICIAL / ESTIMATED / PROVISIONAL / UNKNOWN | | |
+
+**Total Estimated Score:** <score / 100 or UNKNOWN>  
+**Score Label:** OFFICIAL / ESTIMATED / PROVISIONAL / UNKNOWN  
+**Overall Confidence:** HIGH / MEDIUM / LOW / UNKNOWN
+
+**Rule:** Do not fabricate numerical precision. Report whole numbers or clearly labeled ranges unless evidence supports finer precision.
+
+---
+
+## 4. Strongest Scoring Dimensions
+
+| # | Criterion | Performance | Confidence | Why Strong | Evidence |
+|---|-----------|-------------|------------|------------|----------|
+| | | | | | |
+
+---
+
+## 5. Weakest Scoring Dimensions
+
+| # | Criterion | Performance | Confidence | Why Weak | Evidence |
+|---|-----------|-------------|------------|----------|----------|
+| | | | | | |
+
+---
+
+## 6. Largest Score Gaps
+
+| # | Criterion | Gap Classification | Current Performance | Improvement Potential | Risk | Weak Performance vs Weak Evidence |
+|---|-----------|-------------------|---------------------|----------------------|------|-----------------------------------|
+| | | NONE/LOW/MEDIUM/HIGH/CRITICAL/UNKNOWN | | | | Weak performance / Weak evidence / Both |
+
+**Rule:** Weak project performance and weak evidence of performance must be separate findings.
+
+---
+
+## 7. Prioritized Improvement Plan
+
+### P0 — CRITICAL (Must Address)
+
+| ID | Improvement | Category(ies) | Criterion | Score Impact | Confidence | Judge Visibility | Cost | Risk | Time Required | Worth Doing | Blockers/Dependencies |
+|----|-------------|---------------|-----------|--------------|------------|------------------|------|------|---------------|-------------|----------------------|
+| | | | | | | | | | | | |
+
+### P1 — HIGH IMPACT
+
+| ID | Improvement | Category(ies) | Criterion | Score Impact | Confidence | Judge Visibility | Cost | Risk | Time Required | Worth Doing | Blockers/Dependencies |
+|----|-------------|---------------|-----------|--------------|------------|------------------|------|------|---------------|-------------|----------------------|
+| | | | | | | | | | | | |
+
+### P2 — MEDIUM IMPACT
+
+| ID | Improvement | Category(ies) | Criterion | Score Impact | Confidence | Judge Visibility | Cost | Risk | Time Required | Worth Doing | Blockers/Dependencies |
+|----|-------------|---------------|-----------|--------------|------------|------------------|------|------|---------------|-------------|----------------------|
+| | | | | | | | | | | | |
+
+### P3 — LOW IMPACT
+
+| ID | Improvement | Category(ies) | Criterion | Score Impact | Confidence | Judge Visibility | Cost | Risk | Time Required | Worth Doing | Blockers/Dependencies |
+|----|-------------|---------------|-----------|--------------|------------|------------------|------|------|---------------|-------------|----------------------|
+| | | | | | | | | | | | |
+
+### DROP — Do Not Implement
+
+| ID | Improvement | Reason for Drop | Evidence |
+|----|-------------|-----------------|----------|
+| | | | |
+
+---
+
+## 8. Smallest Set of Actions for Largest Improvement
+
+| # | Action | Priority | Expected Score Impact | Time Required | Why This Is in the Smallest Set |
+|---|--------|----------|----------------------|---------------|----------------------------------|
+| 1 | | | | | |
+| 2 | | | | | |
+| 3 | | | | | |
+
+**Rule:** Identify the minimum set of actions that, if completed, would produce the largest judging score improvement within remaining time.
+
+---
+
+## 9. What Should Explicitly NOT Be Changed
+
+| # | Item | Reason | Risk of Changing |
+|---|------|--------|------------------|
+| | | | |
+
+**Rule:** Protect stable, high-scoring areas from unnecessary modification.
+
+---
+
+## 10. Optimization Heuristic Results
+
+**OPTIMIZATION HEURISTIC — Not judging mathematics.**
+
+```
+Expected Value = Score Impact × Confidence × Judge Visibility ÷ Implementation Cost
+```
+
+| ID | Improvement | Score Impact | Confidence | Judge Visibility | Cost | Heuristic Rank | Priority |
+|----|-------------|--------------|------------|------------------|------|----------------|----------|
+| | | | | | | | |
+
+---
+
+## 11. Unknowns
+
+| Unknown | Why Unknown | Impact | Source |
+|---------|-------------|--------|--------|
+| | | | |
+
+---
+
+## 12. Recommended Next Action
+
+**PRIMARY NEXT ACTION:** <exactly one action>
+
+**WHY:** <explanation based on impact, time, risk, and judging criteria>
+
+**DONE WHEN:** <clear definition of done>
+
+**Time remaining:** <hours or UNKNOWN>
+
+**Blocked by:** <blocker or "None">
+
+**Rule:** Exactly one primary next action. Do not produce competing alternatives.
+
+---
+
+## 13. Validation Checklist
+
+- [ ] Score model uses official weights or explicitly provisional equal weights
+- [ ] Every score labeled OFFICIAL / ESTIMATED / PROVISIONAL / UNKNOWN
+- [ ] No false numerical precision claimed
+- [ ] Gap analysis completed for every criterion
+- [ ] Weak project performance separated from weak evidence of performance
+- [ ] Every improvement assigned to one or more categories (A–I)
+- [ ] Every improvement evaluated with Score Impact, Confidence, Judge Visibility, Cost, Risk
+- [ ] OPTIMIZATION HEURISTIC labeled as heuristic, not judging mathematics
+- [ ] Every improvement assigned exactly one priority (P0–P3 or DROP)
+- [ ] Smallest set of high-impact actions identified
+- [ ] What NOT to change identified
+- [ ] Time-aware filtering applied
+- [ ] No Phase 1–4, 11–14 artifacts modified
+- [ ] No application source code modified
+- [ ] No PPT created
+- [ ] No final submission performed
+- [ ] No postmortem performed
+- [ ] Exactly ONE primary next action returned

package/skills/sherpa/templates/security-finding.md

@@ -0,0 +1,45 @@
+# Security Finding
+
+## Finding ID
+UNKNOWN
+
+## Title
+UNKNOWN
+
+## Severity
+CRITICAL | HIGH | MEDIUM | LOW | INFO | UNKNOWN
+
+## Category
+UNKNOWN
+
+## Affected Component
+UNKNOWN
+
+## Description
+UNKNOWN
+
+## Evidence
+- Observation: UNKNOWN
+- Type: FACT | INFERENCE | ASSUMPTION | UNKNOWN
+- Source/scope: UNKNOWN
+
+## Exploitability
+UNKNOWN
+
+## Impact
+UNKNOWN
+
+## Confidence
+HIGH | MEDIUM | LOW | UNKNOWN
+
+## Recommended Remediation
+UNKNOWN
+
+## Verification Method
+UNKNOWN
+
+## Status
+OPEN | IN_PROGRESS | FIXED | ACCEPTED_RISK | BLOCKED | UNKNOWN
+
+## Verification Evidence
+UNKNOWN

package/skills/sherpa/templates/security-review.md

@@ -0,0 +1,64 @@
+# Security Review
+
+## Project
+UNKNOWN
+
+## Scope
+- Repository/files/components inspected: UNKNOWN
+- Method and date: UNKNOWN
+- Limitations: UNKNOWN
+- Review status: PLANNED | IN_PROGRESS | COMPLETE | BLOCKED | UNKNOWN
+
+## Security Baseline
+- Runtime/framework: UNKNOWN
+- Authentication/access model: UNKNOWN
+- Dependency audit tool/result: UNKNOWN
+- Configuration/environment names inspected: UNKNOWN
+
+## Authentication
+UNKNOWN
+
+## Authorization
+UNKNOWN
+
+## Input Handling
+UNKNOWN
+
+## Output Handling
+UNKNOWN
+
+## Secrets
+UNKNOWN
+
+## Sensitive Data
+UNKNOWN
+
+## API Security
+UNKNOWN
+
+## File Handling
+UNKNOWN
+
+## Dependencies
+UNKNOWN
+
+## Configuration
+UNKNOWN
+
+## Logging / Error Handling
+UNKNOWN
+
+## Findings
+
+| ID | Finding | Severity | Evidence | Status |
+|---|---|---|---|---|
+| UNKNOWN | UNKNOWN | CRITICAL / HIGH / MEDIUM / LOW / INFO / UNKNOWN | UNKNOWN | OPEN / IN_PROGRESS / FIXED / ACCEPTED_RISK / BLOCKED / UNKNOWN |
+
+## Unknowns
+- UNKNOWN
+
+## Security Priorities
+- UNKNOWN
+
+## Recommended Next Action
+- PRIMARY NEXT ACTION: UNKNOWN

package/skills/sherpa/templates/slide-claim.md

@@ -0,0 +1,47 @@
+# Slide Claim
+
+**Claim ID:** <unique ID>  
+**Claim:** <what is being claimed>  
+**Slide ID:** <reference to slide or UNKNOWN>  
+
+---
+
+## Evidence
+
+| Evidence Item | Evidence Type | Source | Evidence Status | Confidence |
+|---------------|---------------|--------|-----------------|------------|
+| | UI / output / test / log / artifact / live behavior / screenshot / recording / documentation / benchmark / source/code inspection | | FACT / INFERENCE / ASSUMPTION / UNKNOWN | HIGH / MEDIUM / LOW / UNKNOWN |
+
+---
+
+## Verification
+
+| Verification Method | Result | Status |
+|---------------------|--------|--------|
+| | | PLANNED / EXECUTED / PASSED / FAILED / BLOCKED / UNKNOWN / NOT_APPLICABLE |
+
+---
+
+## Credibility Status
+
+**Status:** VERIFIED / SUPPORTED / PARTIALLY_SUPPORTED / UNSUPPORTED / CONTRADICTED / UNKNOWN
+
+**Reasoning:** <why this credibility status was assigned>
+
+**Action:** REMOVE / WEAKEN / QUALIFY / KEEP
+
+---
+
+## Target Criterion
+
+**Criterion:** <judging criterion name or UNKNOWN>
+
+**Mapping State:** SUPPORTED / PARTIALLY_SUPPORTED / UNKNOWN / CONTRADICTED / NOT_APPLICABLE
+
+---
+
+## Unknowns
+
+| Unknown | Why Unknown | Impact | Source |
+|---------|-------------|--------|--------|
+| | | | |