sherpa-skill 2.0.6 → 2.0.7

package/.agents/skills/sherpa/templates/final-audit.md

@@ -0,0 +1,387 @@
+# Final Audit Plan
+
+**Project:** <project name or UNKNOWN>  
+**Repository:** <repository root or UNKNOWN>  
+**Audit date:** <UTC date/time>  
+**Audit status:** NOT_STARTED | IN_PROGRESS | COMPLETE  
+**Hackathon:** <name or UNKNOWN>  
+**Time remaining:** <hours or UNKNOWN>  
+**Selected idea:** <idea name or UNKNOWN>  
+**Final Readiness:** NOT_READY | CONDITIONAL | BLOCKED | READY
+
+---
+
+## 1. Evidence Base Consumed
+
+| Phase | Evidence Source | Status | Evidence Type |
+|-------|----------------|--------|---------------|
+| 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 |
+| Phase 15 | `.sherpa/score-optimization.md` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 16 | `.sherpa/demo-preparation.md` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Phase 17 | `.sherpa/presentation.md` | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+| Repository | Direct repository inspection | | FACT / INFERENCE / ASSUMPTION / UNKNOWN |
+
+**Rule:** Do not claim evidence was consumed unless artifact was actually read.
+
+---
+
+## 2. Lifecycle Integrity
+
+| Phase | Exists | Consistent | Evidence |
+|-------|--------|------------|----------|
+| Phase 1 | YES / NO / UNKNOWN | | |
+| Phase 2 | YES / NO / UNKNOWN | | |
+| Phase 3 | YES / NO / UNKNOWN | | |
+| Phase 4 | YES / NO / UNKNOWN | | |
+| Phase 5 | YES / NO / UNKNOWN | | |
+| Phase 6 | YES / NO / UNKNOWN | | |
+| Phase 7 | YES / NO / UNKNOWN | | |
+| Phase 8 | YES / NO / UNKNOWN | | |
+| Phase 9 | YES / NO / UNKNOWN | | |
+| Phase 10 | YES / NO / UNKNOWN | | |
+| Phase 11 | YES / NO / UNKNOWN | | |
+| Phase 12 | YES / NO / UNKNOWN | | |
+| Phase 13 | YES / NO / UNKNOWN | | |
+| Phase 14 | YES / NO / UNKNOWN | | |
+| Phase 15 | YES / NO / UNKNOWN | | |
+| Phase 16 | YES / NO / UNKNOWN | | |
+| Phase 17 | YES / NO / UNKNOWN | | |
+
+---
+
+## 3. Selected Idea Stability
+
+| Field | Value |
+|-------|-------|
+| Selected Idea | <idea name or UNKNOWN> |
+| Implementation Addresses Selected Idea | YES / NO / UNKNOWN |
+| Demo Addresses Selected Idea | YES / NO / UNKNOWN |
+| Presentation Addresses Selected Idea | YES / NO / UNKNOWN |
+| IDEA_ALIGNMENT | PASS / FAIL / UNKNOWN |
+
+---
+
+## 4. Requirement Coverage Audit
+
+| Requirement ID | Requirement | Source | Importance | Evidence | Evidence Status | Status | Owner | Finding |
+|----------------|-------------|--------|------------|----------|-----------------|--------|-------|---------|
+| | | | | | FACT / INFERENCE / ASSUMPTION / UNKNOWN | PASS / PASS_WITH_LIMITATION / FAIL / BLOCKED / UNKNOWN / NOT_APPLICABLE | | |
+
+If official criteria unavailable:
+
+> RULES = UNKNOWN
+
+---
+
+## 5. Judging Criteria Coverage Audit
+
+| Criterion | Weight | Evidence | Implementation Support | Demo Support | Presentation Support | Coverage | Confidence |
+|-----------|--------|----------|------------------------|--------------|----------------------|----------|------------|
+| | | | | | | SUPPORTED / PARTIALLY_SUPPORTED / UNKNOWN / CONTRADICTED / NOT_APPLICABLE | HIGH / MEDIUM / LOW / UNKNOWN |
+
+If weights unavailable:
+
+> WEIGHT = UNKNOWN
+
+---
+
+## 6. Claim Audit
+
+| Claim ID | Claim | Source | Evidence | Credibility | Risk | Action |
+|----------|-------|--------|----------|-------------|------|--------|
+| | | | | VERIFIED / SUPPORTED / PARTIALLY_SUPPORTED / UNSUPPORTED / CONTRADICTED / UNKNOWN | | REMOVE / WEAKEN / QUALIFY / KEEP |
+
+---
+
+## 7. Metric Audit
+
+| Metric | Value | Unit | Source | Measurement Method | Date | Evidence Status | Confidence |
+|--------|-------|------|--------|--------------------|------|-----------------|------------|
+| | | | | | | FACT / INFERENCE / ASSUMPTION / UNKNOWN | HIGH / MEDIUM / LOW / UNKNOWN |
+
+---
+
+## 8. Testing Audit
+
+| Test Area | Executed | PASS Has Evidence | Critical Paths Tested | Failure Cases Addressed | Regression Evidence | Blocked Tests | Status |
+|-----------|----------|-------------------|----------------------|----------------------|-------------------|---------------|----------|
+| | YES / NO / UNKNOWN | YES / NO / UNKNOWN | YES / NO / UNKNOWN | YES / NO / UNKNOWN | YES / NO / UNKNOWN | YES / NO / UNKNOWN | PASS / FAIL / BLOCKED / UNKNOWN |
+
+---
+
+## 9. Security Audit
+
+| Security Area | Claims Supported | Secrets Exposed | Credentials Committed | Critical Findings | Critical Findings Resolved/Accepted | Status |
+|---------------|------------------|-----------------|----------------------|-------------------|-------------------------------------|--------|
+| | YES / NO / UNKNOWN | YES / NO / UNKNOWN | YES / NO / UNKNOWN | | YES / NO / UNKNOWN | PASS / FAIL / BLOCKED / UNKNOWN |
+
+---
+
+## 10. UX / Accessibility Audit
+
+| UX Area | Findings | Accessibility Compliant | Responsive Behavior | Error States | Status |
+|---------|----------|------------------------|---------------------|--------------|--------|
+| | | YES / NO / UNKNOWN | YES / NO / UNKNOWN | | PASS / FAIL / BLOCKED / UNKNOWN |
+
+---
+
+## 11. Red Team Closure Audit
+
+| Finding | Severity | Evidence | Status | Mitigation | Verification | Owner | Final Disposition |
+|---------|----------|----------|--------|------------|--------------|-------|-------------------|
+| | | | | | | | |
+
+Open CRITICAL finding blocks unconditional readiness.
+
+---
+
+## 12. Judge Simulation Closure Audit
+
+| Question Type | Question | Evidence | Answer Readiness | Confidence |
+|---------------|----------|----------|------------------|------------|
+| | | | READY / PARTIALLY_READY / WEAK / UNKNOWN / NOT_APPLICABLE | HIGH / MEDIUM / LOW / UNKNOWN |
+
+---
+
+## 13. Score Optimization Closure Audit
+
+| Improvement | Status | Reason | Impact | Verification | Final Disposition |
+|-------------|--------|--------|--------|--------------|-----------------|
+| | | | | | |
+
+Unresolved P0 items documented.
+
+---
+
+## 14. Demo Closure Audit
+
+| Demo Element | Status | Evidence |
+|--------------|--------|----------|
+| Primary Flow | PASS / FAIL / BLOCKED / UNKNOWN | |
+| Critical Demo Steps | | |
+| Demo Evidence | | |
+| Fallback | | |
+| Rehearsal | | |
+| Timing | | |
+| Reliability | | |
+| Judge-Visible Moments | | |
+| Demo Claims | | |
+
+LIVE DEMO READINESS: PASS / FAIL / BLOCKED / UNKNOWN / CONDITIONAL
+
+---
+
+## 15. Presentation Closure Audit
+
+| Presentation Element | Status | Evidence |
+|----------------------|--------|----------|
+| Essential Slides | PASS / FAIL / BLOCKED / UNKNOWN | |
+| Criteria Coverage | | |
+| Claim Evidence | | |
+| Timing | | |
+| Speaker Guidance | | |
+| Visual Evidence | | |
+| Q&A Readiness | | |
+| Presentation Risks | | |
+
+Presentation closure: PASS / FAIL / BLOCKED / UNKNOWN
+
+---
+
+## 16. Repository Audit
+
+| Area | Inspected | Findings | Status |
+|------|-----------|----------|--------|
+| Source Files | | | |
+| Manifests | | | |
+| README | | | |
+| Configuration | | | |
+| Tests | | | |
+| Documentation | | | |
+| Deployment Config | | | |
+| Unused Files | | | |
+| Suspicious Files | | | |
+| Credentials | | | |
+| Temporary Artifacts | | | |
+| Debug Code | | | |
+| Broken References | | | |
+| Inconsistent Names | | | |
+
+---
+
+## 17. Secret / Sensitive Data Audit
+
+| Secret Type | Found | Location | Evidence Status | Confidence |
+|-------------|-------|----------|-----------------|------------|
+| API Keys | YES / NO / UNKNOWN | | | |
+| Tokens | YES / NO / UNKNOWN | | | |
+| Passwords | YES / NO / UNKNOWN | | | |
+| Private Keys | YES / NO / UNKNOWN | | | |
+| Credentials | YES / NO / UNKNOWN | | | |
+| `.env` | YES / NO / UNKNOWN | | | |
+| OAuth Secrets | YES / NO / UNKNOWN | | | |
+
+No secret indicators identified within inspected scope: YES / NO / UNKNOWN
+
+---
+
+## 18. Documentation Consistency Audit
+
+| Document | Consistent | Stale Items | Contradictions | Status |
+|----------|------------|-------------|----------------|--------|
+| README | YES / NO / UNKNOWN | | | |
+| Project Description | | | | |
+| Setup Instructions | | | | |
+| Environment Variables | | | | |
+| Architecture Documentation | | | | |
+| Demo Instructions | | | | |
+| Screenshots | | | | |
+| API Documentation | | | | |
+| Installation Commands | | | | |
+| Deployment URLs | | | | |
+| License | | | | |
+
+---
+
+## 19. Deployment Audit
+
+| Area | Verified | Evidence | Status |
+|------|----------|----------|--------|
+| URL | | | |
+| Availability | | | |
+| Frontend | | | |
+| Backend | | | |
+| API | | | |
+| Environment Configuration | | | |
+| Expected Routes | | | |
+| Critical Flow | | | |
+
+Deployment Status: PASSED / FAIL / BLOCKED / UNKNOWN / NOT_APPLICABLE
+
+---
+
+## 20. Submission Requirements Audit
+
+| Requirement | Known? | Evidence | Status | Missing Item | Owner |
+|-------------|--------|----------|--------|--------------|-------|
+| Repository | YES / NO / UNKNOWN | | | | |
+| Live URL | | | | | |
+| PPT | | | | | |
+| Demo Video | | | | | |
+| Documentation | | | | | |
+| Team Information | | | | | |
+| Forms | | | | | |
+| Screenshots | | | | | |
+| Required Files | | | | | |
+| License | | | | | |
+| README | | | | | |
+| Project Description | | | | | |
+
+---
+
+## 21. Final Risk Register
+
+| Risk ID | Description | Source Phase | Severity | Likelihood | Confidence | Impact | Mitigation | Owner | Status | Final Disposition |
+|---------|-------------|--------------|----------|------------|------------|--------|------------|-------|--------|-------------------|
+| | | | CRITICAL / HIGH / MEDIUM / LOW / UNKNOWN | LOW / MEDIUM / HIGH / UNKNOWN | HIGH / MEDIUM / LOW / UNKNOWN | | | | | |
+
+---
+
+## 22. Final Readiness Gate
+
+**Current Gate:** NOT_READY | CONDITIONAL | BLOCKED | READY
+
+**Reason against every READY criterion:**
+
+- Critical requirements verified:
+- Critical claims supported:
+- Judging criteria covered where known:
+- Testing/security evidence sufficient:
+- Demo evidence sufficient:
+- Presentation evidence sufficient:
+- Critical red-team findings resolved/accepted:
+- Repository/submission prerequisites verified:
+- No known contradictory critical artifacts:
+
+If any critical requirement is UNKNOWN, do not silently mark READY.
+
+---
+
+## 23. Final Audit Score
+
+**INTERNAL READINESS INDICATOR**  
+**NOT OFFICIAL JUDGING SCORE**
+
+| Indicator | Value |
+|-----------|-------|
+| Evidence Completeness | |
+| Requirement Coverage | |
+| Claim Credibility | |
+| Technical Readiness | |
+| Demo Readiness | |
+| Presentation Readiness | |
+| Submission Readiness | |
+
+---
+
+## 24. Unknowns
+
+| Unknown | Why Unknown | Impact | Source |
+|---------|-------------|--------|--------|
+| | | | |
+
+---
+
+## 25. 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.
+
+---
+
+## 26. Validation Checklist
+
+- [ ] Project state read and verified
+- [ ] Phase 11–17 evidence consumed (not duplicated)
+- [ ] Repository inspected for evidence
+- [ ] Lifecycle integrity verified
+- [ ] Selected idea stability verified
+- [ ] Requirement coverage audited
+- [ ] Judging criteria coverage audited
+- [ ] Claim audit performed
+- [ ] Metric audit performed
+- [ ] Testing audit performed
+- [ ] Security audit performed
+- [ ] UX audit performed
+- [ ] Red Team closure audited
+- [ ] Judge Simulation closure audited
+- [ ] Score Optimization closure audited
+- [ ] Demo closure audited
+- [ ] Presentation closure audited
+- [ ] Repository audit performed
+- [ ] Secret audit performed
+- [ ] Documentation audit performed
+- [ ] Deployment audit performed
+- [ ] Submission requirements audited
+- [ ] Last-minute change protection applied
+- [ ] Final risk register built
+- [ ] Final readiness gate evaluated
+- [ ] Project state updated with compact fields only
+- [ ] No Phase 1–17 artifacts modified
+- [ ] No application source code modified
+- [ ] No final submission performed
+- [ ] No postmortem performed
+- [ ] No presentation claim fabricated
+- [ ] Exactly ONE primary next action returned

package/.agents/skills/sherpa/templates/final-risk.md

@@ -0,0 +1,17 @@
+# Final Risk
+
+**Risk ID:** <unique ID>  
+**Description:** <risk description>  
+**Source Phase:** <source phase>  
+**Severity:** CRITICAL / HIGH / MEDIUM / LOW / UNKNOWN  
+**Likelihood:** LOW / MEDIUM / HIGH / UNKNOWN  
+**Confidence:** HIGH / MEDIUM / LOW / UNKNOWN  
+**Impact:** <impact description>  
+**Mitigation:** <mitigation strategy>  
+**Owner:** <owner name or UNKNOWN>  
+**Status:** <status>  
+**Final Disposition:** <final disposition>  
+
+---
+
+**Rule:** Confidence separate from severity.

package/.agents/skills/sherpa/templates/final-verification.md

@@ -0,0 +1,57 @@
+# Final Audit Verification
+
+**Verification ID:** <unique ID>  
+**Claim ID:** <reference to claim or UNKNOWN>  
+**Audit Area:** <audit area>  
+
+---
+
+## Verification Procedure
+
+<revision, viewport/device, starting conditions, steps, and related focused check>
+
+---
+
+## Expected Result
+
+<expected result>
+
+---
+
+## Actual Result
+
+<actual result or UNKNOWN>
+
+---
+
+## Status
+
+PASSED | FAILED | BLOCKED | UNKNOWN | NOT_APPLICABLE
+
+---
+
+## Evidence
+
+<attach or reference direct observations, artifacts, and actual execution output. A planned or proposed fix is not verification.>
+
+---
+
+## Regression Impact
+
+<affected areas/components and the regression check actually run>
+
+---
+
+## Related Tests
+
+<test IDs or UNKNOWN>
+
+---
+
+## Recommended Action
+
+<recommended action>
+
+---
+
+**Rule:** A verification marked PASSED must have actual evidence.

package/.agents/skills/sherpa/templates/gap-analysis.md

@@ -0,0 +1,113 @@
+# Gap Analysis — Criterion: <criterion name>
+
+**Criterion ID:** <ID or UNKNOWN>  
+**Criterion Name:** <name>  
+**Source:** OFFICIAL | USER_PROVIDED | UNKNOWN  
+**Official Weight:** <weight or UNKNOWN>  
+**Weight Source:** <source or UNKNOWN>  
+**Weight Label:** OFFICIAL | UNKNOWN | PROVISIONAL
+
+---
+
+## Current Assessment
+
+| Field | Value |
+|-------|-------|
+| Current Performance | <1–10 or UNKNOWN> |
+| Confidence | HIGH / MEDIUM / LOW / UNKNOWN |
+| Score Label | OFFICIAL / ESTIMATED / PROVISIONAL / UNKNOWN |
+| Weighted Contribution | <score × weight or UNKNOWN> |
+
+## Evidence
+
+| Evidence Item | Evidence Type | Source | Confidence |
+|---------------|---------------|--------|------------|
+| | FACT / INFERENCE / ASSUMPTION / UNKNOWN | | HIGH / MEDIUM / LOW / UNKNOWN |
+
+---
+
+## Strengths
+
+| Strength | Evidence | Evidence Type | Confidence | Judge-Visible? |
+|----------|----------|---------------|------------|----------------|
+| | | | | YES / NO / UNKNOWN |
+
+---
+
+## Weaknesses
+
+| Weakness | Evidence | Evidence Type | Confidence | Judge-Visible? |
+|----------|----------|---------------|------------|----------------|
+| | | | | YES / NO / UNKNOWN |
+
+---
+
+## Gap Classification
+
+**Gap:** NONE | LOW | MEDIUM | HIGH | CRITICAL | UNKNOWN
+
+**Improvement Potential:** NONE | LOW | MEDIUM | HIGH | CRITICAL | UNKNOWN
+
+**Risk of Attempting Improvement:** LOW | MEDIUM | HIGH | CRITICAL | UNKNOWN
+
+**Judge Visibility:** LOW | MEDIUM | HIGH | VERY HIGH | UNKNOWN
+
+**Evidence Mapping Status:** SUPPORTED | PARTIALLY_SUPPORTED | UNKNOWN | CONTRADICTED | NOT_APPLICABLE
+
+---
+
+## Separate Findings
+
+### Weak Project Performance
+
+The capability itself is weak:
+
+| Finding | Description | Evidence | Evidence Type |
+|---------|-------------|----------|---------------|
+| | | | |
+
+### Weak Evidence of Project Performance
+
+The capability may exist but is not demonstrated, documented, or observable by a judge:
+
+| Finding | Description | Evidence | Evidence Type |
+|---------|-------------|----------|---------------|
+| | | | |
+
+**Rule:** These are separate findings. Do not conflate weak implementation with weak evidence of implementation.
+
+---
+
+## Likely Judge Reaction
+
+<description of how a judge would likely perceive this criterion>
+
+---
+
+## Confidence
+
+HIGH | MEDIUM | LOW | UNKNOWN
+
+---
+
+## Unknowns
+
+| Unknown | Why Unknown | Impact | Source |
+|---------|-------------|--------|--------|
+| | | | |
+
+---
+
+## Contributing Categories
+
+| Category | Diagnostic Dimensions |
+|----------|----------------------|
+| | |
+
+---
+
+## Recommended Improvement Candidates
+
+| Candidate ID | Improvement | Category(ies) | Evidence Basis |
+|--------------|-------------|---------------|----------------|
+| | | | |

package/.agents/skills/sherpa/templates/idea-comparison.md

@@ -0,0 +1,129 @@
+# Idea Comparison — <session-id>
+
+**Evaluation date:** <UTC date/time>
+**Hackathon:** <name or UNKNOWN>
+**Deadline:** <date/time or UNKNOWN>
+**Time remaining:** <hours or UNKNOWN>
+**Judging criteria:** <list or UNKNOWN>
+**Criteria weights:** <weights or UNKNOWN>
+
+---
+
+## 1. Candidate Ideas
+
+| # | Idea Name | One-Line Description |
+|---|-----------|---------------------|
+| 1 | | |
+| 2 | | |
+| 3 | | |
+| 4 | | |
+
+---
+
+## 2. Final Score Comparison
+
+| Dimension Category | Idea 1 | Idea 2 | Idea 3 | Idea 4 |
+|-------------------|--------|--------|--------|--------|
+| Problem & Solution | | | | |
+| Innovation & Differentiation | | | | |
+| Technical Feasibility | | | | |
+| Implementation Reality | | | | |
+| Demo & Presentation | | | | |
+| Impact & Market | | | | |
+| Competition & Risk Context | | | | |
+| Risk & Evidence Quality | | | | |
+| **Final Score** | | | | |
+| **Feasibility Gate** | PASS/FAIL | PASS/FAIL | PASS/FAIL | PASS/FAIL |
+| **Red-Team Outcome** | KILL/MAJOR/MINOR | KILL/MAJOR/MINOR | KILL/MAJOR/MINOR | KILL/MAJOR/MINOR |
+
+---
+
+## 3. Decision Outcome
+
+**Outcome:** <SELECT | REVISE | REJECT_ALL>
+
+**Recommended idea:** <name or "None">
+
+**Why this outcome:**
+<explanation tied to category scores, feasibility gate, and red-team outcomes>
+
+---
+
+## 4. Recommended Idea Details (if SELECT)
+
+**Strongest advantages:**
+1. <advantage 1 with category and score>
+2. <advantage 2 with category and score>
+3. <advantage 3 with category and score>
+
+**Biggest risks:**
+<red-team findings that survived but remain concerns>
+
+**What must be true for this idea to succeed:**
+<assumptions that must hold>
+
+**Minimum viable version:**
+<scope that can be built in remaining time>
+
+**Highest-value differentiator:**
+<the one thing that makes this win>
+
+**Estimated implementation difficulty:** <low | medium | high>
+
+**Feasibility gate:** PASS | FAIL (composite: X.X/10)
+
+---
+
+## 5. Why Alternatives Were Rejected
+
+| Idea | Reason | Outcome |
+|------|--------|---------|
+| | | |
+| | | |
+| | | |
+
+---
+
+## 6. REVISE Loop (if outcome is REVISE)
+
+**Weaknesses identified:**
+1. <weakness from red-team>
+2. <weakness from red-team>
+3. <weakness from red-team>
+
+**Proposed changes:**
+1. <change 1>
+2. <change 2>
+
+**Re-evaluation required:** <yes / no>
+
+**Next iteration due:** <date/time or "pending">
+
+---
+
+## 7. Single Primary Next Action
+
+**PRIMARY NEXT ACTION:** <exactly one action>
+
+**Why this is the highest priority:**
+<explanation based on impact, time, risk, and judging criteria>
+
+**What you need to do:**
+<specific, actionable steps>
+
+**What completion looks like:**
+<clear definition of done>
+
+**Time remaining:** <hours or UNKNOWN>
+**Blocked by:** <blocker or "None">
+
+---
+
+## 8. 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 set `selected idea` in `.sherpa/project-state.md`. The engine recommends; the human decides. No automatic overwrite.