sherpa-skill 2.0.6 → 2.0.7

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

@@ -0,0 +1,127 @@
+# Slide Plan
+
+**Slide ID:** <unique ID>  
+**Title:** <slide title>  
+**Slide Status:** PLANNED | EXECUTED | PASSED | FAILED | BLOCKED | UNKNOWN / NOT_APPLICABLE  
+
+---
+
+## Slide Purpose
+
+**Purpose:** <why this slide exists>
+
+**Primary Message:** <the core message to communicate>
+
+**Judge Takeaway:** <what the judge should remember>
+
+---
+
+## Content
+
+**Content:** <slide content description>
+
+**Visual Requirement:** <what should appear on screen>
+
+---
+
+## Claim
+
+**Claim ID:** <reference to presentation claim>
+
+**Claim Text:** <what is being claimed on this slide>
+
+**Evidence Source:** <source of evidence>
+
+**Evidence Type:** UI / output / test / log / artifact / live behavior / screenshot / recording / documentation / benchmark / source/code inspection
+
+**Evidence Status:** FACT / INFERENCE / ASSUMPTION / UNKNOWN
+
+**Verification Method:** <how the claim is verified>
+
+---
+
+## Target Criterion
+
+**Criterion:** <judging criterion name or UNKNOWN>
+
+**Mapping State:** SUPPORTED / PARTIALLY_SUPPORTED / UNKNOWN / CONTRADICTED / NOT_APPLICABLE
+
+---
+
+## Priority
+
+**Priority:** PPT-P0 | PPT-P1 | PPT-P2 | PPT-P3 | DROP
+
+**Reasoning:** <why this priority was assigned>
+
+---
+
+## Timing
+
+**Target Time:** <minutes or seconds or UNKNOWN>
+
+---
+
+## Speaker Guidance
+
+**ACTION:** <what the presenter does>
+
+**SAY:** <what the presenter communicates>
+
+**SHOW:** <what appears on screen>
+
+**PROVE:** <evidence supporting the claim>
+
+**EMPHASIZE:** <what the judge should remember>
+
+**AVOID:** <potential misleading or unnecessary claims>
+
+**TRANSITION:** <how to move to the next slide>
+
+---
+
+## Risk
+
+**Risk ID:** <unique ID>
+
+**Risk:** <presentation risk description>
+
+**Severity:** CRITICAL / HIGH / MEDIUM / LOW / UNKNOWN
+
+**Likelihood:** LOW / MEDIUM / HIGH / UNKNOWN
+
+**Detectability:** <description>
+
+**Recoverability:** IMMEDIATE / SIMPLE / MANUAL / DIFFICULT / NONE / UNKNOWN
+
+**Mitigation:** <mitigation strategy>
+
+**Owner:** <owner name or UNKNOWN>
+
+**Status:** <status>
+
+---
+
+## Verification
+
+**Verification Method:** <how this slide's claims are verified>
+
+**Verification Status:** PLANNED / EXECUTED / PASSED / FAILED / BLOCKED / UNKNOWN
+
+**Evidence:** <attach or reference direct observations, artifacts, and actual execution output>
+
+---
+
+## Unknowns
+
+| Unknown | Why Unknown | Impact | Source |
+|---------|-------------|--------|--------|
+| | | | |
+
+---
+
+## Related Demo Step
+
+**Demo Step ID:** <reference to Phase 16 demo step or UNKNOWN>
+
+**Demo Flow Reference:** <description or UNKNOWN>

package/skills/sherpa/templates/submission-artifact.md

@@ -0,0 +1,15 @@
+# Submission Artifact Record
+
+- Artifact ID: UNKNOWN
+- Name: UNKNOWN
+- Type: UNKNOWN
+- Location: UNKNOWN
+- Version / commit / identifier: UNKNOWN
+- Required?: UNKNOWN
+- Accessible?: UNKNOWN
+- Verified?: UNKNOWN
+- Last checked (timestamp/timezone): UNKNOWN
+- Hash / identifier if available: UNKNOWN
+- Evidence and method: UNKNOWN
+- Status: UNKNOWN
+- Notes: UNKNOWN

package/skills/sherpa/templates/submission-checklist.md

@@ -0,0 +1,24 @@
+# Final Submission Checklist
+
+- [ ] Rules verified
+- [ ] Deadline verified
+- [ ] Team information verified
+- [ ] Project name verified
+- [ ] Project description verified
+- [ ] Repository verified
+- [ ] Deployment verified
+- [ ] PPT verified
+- [ ] Demo/video verified
+- [ ] README verified
+- [ ] Required files verified
+- [ ] URLs verified
+- [ ] Permissions verified
+- [ ] Secrets checked
+- [ ] Metrics verified
+- [ ] Claims verified
+- [ ] Final snapshot created
+- [ ] Submission freeze active
+- [ ] Human confirmation received
+- [ ] Submission performed
+
+**Phase 19 rule:** “Submission performed” remains unchecked. The actual submission is exclusively a human action.

package/skills/sherpa/templates/submission-field.md

@@ -0,0 +1,14 @@
+# Submission Field Record
+
+- Field ID: UNKNOWN
+- Field name: UNKNOWN
+- Required?: UNKNOWN
+- Value: UNKNOWN
+- Source: UNKNOWN
+- Evidence: UNKNOWN
+- Character limit: UNKNOWN
+- Format: UNKNOWN
+- Status: UNKNOWN
+- Notes: UNKNOWN
+
+Never fabricate identity, team, project, contact, or metrics information.

package/skills/sherpa/templates/submission-link.md

@@ -0,0 +1,14 @@
+# Submission Link Record
+
+- Link ID: UNKNOWN
+- URL: UNKNOWN
+- Intended destination/content: UNKNOWN
+- Syntax checked: UNKNOWN
+- Verification method and timestamp: UNKNOWN
+- Accessibility: UNKNOWN (VERIFIED_ACCESSIBLE / ACCESSIBLE_WITH_AUTH / BROKEN / REDIRECTED / UNKNOWN / NOT_APPLICABLE)
+- Access state: UNKNOWN (PUBLIC / RESTRICTED / AUTH_REQUIRED / EXPIRED / UNKNOWN)
+- Permissions / authentication / expiry: UNKNOWN
+- Evidence: UNKNOWN
+- Notes: UNKNOWN
+
+Do not claim accessibility without actually checking the link.

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

@@ -0,0 +1,31 @@
+# Submission Plan
+
+- Hackathon / project: UNKNOWN
+- Selected idea: UNKNOWN
+- Phase 18 lock evidence: UNKNOWN
+- Submission readiness: NOT_READY / CONDITIONAL / BLOCKED / READY_TO_SUBMIT
+- Submission freeze: INACTIVE / ACTIVE
+- Human confirmation: PENDING / CONFIRMED
+
+## Requirements
+| Requirement ID | Requirement | Source | Mandatory? | Evidence | Artifact / Field | Status | Owner | Deadline | Notes |
+|---|---|---|---|---|---|---|---|---|---|
+
+## Deadline
+Deadline: UNKNOWN · Timezone: UNKNOWN · Source: UNKNOWN · Confidence: UNKNOWN · Status: UNKNOWN · Time remaining: UNKNOWN
+
+## Artifacts, fields, links, access
+See corresponding records; unavailable information stays UNKNOWN.
+
+## Consistency / claims / risks
+| Finding ID | Compared items / claim | Evidence | Status | Owner | Notes |
+|---|---|---|---|---|---|
+
+## Snapshot and freeze
+Snapshot: UNKNOWN · Freeze: INACTIVE
+
+## FINAL HUMAN CONFIRMATION REQUIRED
+The system does not submit. Human performs the final submission action.
+
+## PRIMARY NEXT ACTION
+UNKNOWN

package/skills/sherpa/templates/submission-readiness.md

@@ -0,0 +1,18 @@
+# Submission Readiness
+
+| 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 | | | | | |
+
+**Rule:** Phase 18 does not submit anything.

package/skills/sherpa/templates/submission-requirement.md

@@ -0,0 +1,12 @@
+# Submission Requirement Record
+
+- Requirement ID: UNKNOWN
+- Requirement: UNKNOWN
+- Source (URL/path/message, authority): UNKNOWN
+- Mandatory?: UNKNOWN
+- Evidence / verification method: UNKNOWN
+- Artifact / field: UNKNOWN
+- Status: UNKNOWN (VERIFIED / READY / MISSING / INVALID / BLOCKED / UNKNOWN / NOT_APPLICABLE)
+- Owner: UNKNOWN
+- Deadline: UNKNOWN
+- Notes / source conflicts: UNKNOWN

package/skills/sherpa/templates/submission-risk.md

@@ -0,0 +1,14 @@
+# Submission Risk Record
+
+- Risk ID: UNKNOWN
+- Description: UNKNOWN
+- Severity: UNKNOWN
+- Likelihood: UNKNOWN
+- Confidence: UNKNOWN
+- Impact: UNKNOWN
+- Mitigation: UNKNOWN
+- Owner: UNKNOWN
+- Status: UNKNOWN
+- Human authority / acceptance evidence: UNKNOWN
+
+Severity and confidence are separate. An unresolved critical risk blocks READY_TO_SUBMIT.

package/skills/sherpa/templates/submission-snapshot.md

@@ -0,0 +1,20 @@
+# Submission Snapshot
+
+- Snapshot ID: UNKNOWN
+- Timestamp / timezone: UNKNOWN
+- Repository commit: UNKNOWN
+- Branch: UNKNOWN
+- Frontend version: UNKNOWN
+- Backend version: UNKNOWN
+- PPT version: UNKNOWN
+- Demo video version: UNKNOWN
+- Documentation version: UNKNOWN
+- Deployment URL: UNKNOWN
+- Artifact hashes / identifiers: UNKNOWN
+- Status: UNKNOWN
+
+## Post-snapshot change classification
+- REQUIRED: critical submission, access, factual, link, format, or organizer-required fix
+- SAFE: verified low-risk correction, explicitly recorded
+- RISKY: feature, architecture, UI, dependency, or unrelated refactor; avoid after freeze
+- FORBIDDEN_AFTER_FREEZE: destructive/idea/scope/artifact replacement without explicit human approval

package/skills/sherpa/templates/submission-verification.md

@@ -0,0 +1,12 @@
+# Submission Verification Record
+
+- Verification ID: UNKNOWN
+- Requirement / artifact / field / URL / permission / claim: UNKNOWN
+- Evidence source: UNKNOWN
+- Evidence type: UNKNOWN
+- Verification method: UNKNOWN
+- Timestamp / timezone: UNKNOWN
+- Observed result: UNKNOWN
+- Status: UNKNOWN
+- Scope limitation: UNKNOWN
+- Finding / owner: UNKNOWN

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

@@ -0,0 +1,59 @@
+# Test Plan
+
+## Project
+- Name: UNKNOWN
+- Repository: UNKNOWN
+
+## Selected Idea
+- UNKNOWN
+
+## Implementation Status
+- Phase 4 state: UNKNOWN
+- Testing readiness: UNKNOWN
+
+## Test Baseline
+- Framework: UNKNOWN
+- Test runner: UNKNOWN
+- Existing tests: UNKNOWN
+- Build command: UNKNOWN
+- Lint command: UNKNOWN
+- Typecheck: UNKNOWN
+- API test setup: UNKNOWN
+- E2E setup: UNKNOWN
+- CI configuration: UNKNOWN
+- Runtime: UNKNOWN
+- Frontend/backend structure: UNKNOWN
+- Environment/configuration (names only): UNKNOWN
+- Test data/fixtures/mocks: UNKNOWN
+- Known failures: UNKNOWN
+
+## Critical User Flows
+- UNKNOWN
+
+## Test Matrix
+
+| ID | Category | Area | Priority | Expected Result | Status |
+|---|---|---|---|---|---|
+| UNKNOWN | UNIT / INTEGRATION / E2E / UI / API / SECURITY / PERFORMANCE / ACCESSIBILITY / MANUAL | UNKNOWN | CRITICAL / HIGH / MEDIUM / LOW | UNKNOWN | PLANNED / EXECUTED / PASSED / FAILED / BLOCKED / UNKNOWN |
+
+## Critical Path Tests
+- UNKNOWN
+
+## Regression Tests
+- UNKNOWN
+
+## Security-Sensitive Tests
+- UNKNOWN
+
+## Blocked Tests
+- UNKNOWN
+
+## Unknowns
+- UNKNOWN
+
+## Evidence
+- Record exact commands/procedures, scope, timestamp, exit/result, and direct output/report. Planning records are not execution evidence.
+- UNKNOWN
+
+## Recommended Next Action
+- PRIMARY NEXT ACTION: UNKNOWN

package/skills/sherpa/templates/test-result.md

@@ -0,0 +1,46 @@
+# Test Result
+
+## Test ID
+UNKNOWN
+
+## Test Name
+UNKNOWN
+
+## Category
+UNIT | INTEGRATION | E2E | UI | API | SECURITY | PERFORMANCE | ACCESSIBILITY | MANUAL
+
+## Priority
+CRITICAL | HIGH | MEDIUM | LOW
+
+## Preconditions
+UNKNOWN
+
+## Command / Procedure
+UNKNOWN
+
+## Expected Result
+UNKNOWN
+
+## Actual Result
+UNKNOWN
+
+## Status
+PLANNED | EXECUTED | PASSED | FAILED | BLOCKED | UNKNOWN
+
+## Evidence
+- Command/procedure, scope, date/time, exit/result, and relevant output/source: UNKNOWN
+
+## Failure Details
+UNKNOWN
+
+## Impact
+UNKNOWN
+
+## Related Component
+UNKNOWN
+
+## Regression Risk
+UNKNOWN
+
+## Recommended Action
+UNKNOWN

package/skills/sherpa/templates/timeline.md

@@ -0,0 +1,11 @@
+# Timeline Retrospective
+
+| Milestone / event | Phase | Planned time | Actual time | Start | Completion | Variance | Evidence | Delay / acceleration | Deadline pressure | Scope / emergency work | Impact |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN | UNKNOWN |
+
+Time variance: AHEAD / ON_TIME / DELAYED / COMPRESSED / UNKNOWN
+
+Time allocation by research, ideation, validation, architecture, implementation, testing, security, UX, red team, judge simulation, score optimization, demo, presentation, submission: UNKNOWN unless time records support it.
+
+Where time was spent/lost, effects on decisions, and value per unit time: UNKNOWN absent evidence. Do not invent timestamps.

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

@@ -0,0 +1,56 @@
+# UX Finding
+
+## Finding ID
+
+## Title
+
+## Category
+
+`USABILITY | NAVIGATION | ACCESSIBILITY | RESPONSIVE | VISUAL_HIERARCHY | FORM | FEEDBACK | ERROR_HANDLING | ONBOARDING | CONTENT | CONSISTENCY | DEMO_FLOW | OTHER`
+
+## Severity
+
+`CRITICAL | HIGH | MEDIUM | LOW | INFO | UNKNOWN`
+
+## Confidence
+
+`HIGH | MEDIUM | LOW | UNKNOWN`
+
+## Affected Flow
+
+## Affected Component
+
+## Observation
+
+Include evidence status: `FACT | INFERENCE | ASSUMPTION | UNKNOWN` and observation status: `OBSERVED | REPRODUCED | NOT_REPRODUCED | BLOCKED | UNKNOWN`.
+
+## Evidence
+
+Reference route/screen, file and line, viewport/device, steps, captured output/artifact, revision, and observed result. Never include unsupported claims.
+
+## User Impact
+
+## Reproduction Steps
+
+1.
+
+## Recommended Remediation
+
+## Architecture Impact
+
+`NONE | POSSIBLE | REQUIRED | UNKNOWN`
+
+If REQUIRED, include `ARCHITECTURE CHANGE REQUIRED`, reason, evidence, impact, estimated effort, alternative, risk, and recommendation. Wait for human approval.
+
+## Verification Method
+
+Include focused UX check, expected result, regression consideration, and `TEST REQUIRED` when Phase 5 owns a needed test.
+
+## Status
+
+`OPEN | IN_PROGRESS | FIXED | ACCEPTED_RISK | BLOCKED | UNKNOWN`
+
+FIXED requires recorded verification evidence. ACCEPTED_RISK requires explicit human acceptance evidence.
+
+## Verification Evidence
+

package/skills/sherpa/templates/ux-flow.md

@@ -0,0 +1,46 @@
+# UX Flow
+
+## Flow ID
+
+## Flow Name
+
+## User Goal
+
+## Target User
+
+## Entry Point
+
+## Preconditions
+
+## Steps
+
+1.
+2.
+3.
+
+For each step record expected and observed behavior, with evidence status `FACT | INFERENCE | ASSUMPTION | UNKNOWN`.
+
+## Expected Outcome
+
+## Observed Outcome
+
+## Friction Points
+
+## Error / Recovery Path
+
+## Accessibility Considerations
+
+State what was inspected and what remains unknown.
+
+## Responsive Considerations
+
+List tested viewports. Untested responsive behavior is UNKNOWN.
+
+## Evidence
+
+## Status
+
+`OBSERVED | REPRODUCED | NOT_REPRODUCED | BLOCKED | UNKNOWN`
+
+## Recommended Action
+

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

@@ -0,0 +1,113 @@
+# UX Review
+
+## Project
+
+- Repository root:
+- Revision/commit:
+- Selected idea (read-only):
+- Implementation readiness evidence:
+- Phase 5 test/security evidence:
+- Review date:
+
+## UX Baseline
+
+- Frontend/framework:
+- Backend relationship:
+- Routes/entry points/page structure:
+- Components/styles/design system/UI libraries:
+- Responsive CSS/breakpoints:
+- Forms/validation:
+- Navigation/authentication:
+- Loading/error/empty/success/disabled/retry/progress/confirmation states:
+- Accessibility semantics:
+- Test infrastructure/screenshots/existing UX issues:
+- Known limitations:
+
+For each baseline claim label `FACT | INFERENCE | ASSUMPTION | UNKNOWN` and cite evidence. Missing details are UNKNOWN.
+
+## Review Scope
+
+- Environment/browser/device and revision:
+- Viewports actually inspected:
+- Accessibility scope/tooling:
+- Paths/files/screens reviewed:
+- Excluded or blocked scope:
+- Phase 5 failures/security findings/regression risks considered:
+
+## Critical User Flows
+
+List flow IDs and goals. Store detailed flows in `.sherpa/ux/flow-NNN.md`.
+
+## Usability Review
+
+- Clarity and terminology:
+- Navigation/location/discoverability:
+- Interaction and action feedback:
+- Forms/defaults/validation/input preservation:
+- Loading/success/failure/empty/disabled/retry/progress/confirmation:
+- Evidence status for each claim:
+
+## Information Architecture
+
+- Hierarchy/grouping/labels/cognitive load:
+- Evidence and status:
+- Architecture change required (if any):
+
+## Visual Hierarchy
+
+- Primary action/headings/spacing/grouping/contrast/type/density/alignment:
+- Concrete usability consequences and evidence:
+
+## Accessibility
+
+- Scope:
+- Keyboard/focus/semantics/names/labels/contrast/scaling/alt/ARIA/errors/motion/touch:
+- Status: `UNKNOWN | PASS | FAIL | BLOCKED`
+- Limitations (no blanket compliance claim):
+
+## Responsive Behavior
+
+- Tested viewport sizes:
+- Overflow/navigation/forms/controls/cards/tables/modals/touch/spacing/type:
+- Status: `UNKNOWN | PASS | FAIL | BLOCKED`
+- Untested sizes remain UNKNOWN:
+
+## Feedback States
+
+| State | Evidence / observation | Status |
+|---|---|---|
+| Loading | | |
+| Success | | |
+| Failure | | |
+| Empty | | |
+| Disabled | | |
+| Retry | | |
+| Progress | | |
+| Confirmation | | |
+
+## Findings
+
+| ID | Category | Severity | Flow | Status |
+|---|---|---|---|---|
+
+## Critical UX Issues
+
+## High Priority UX Issues
+
+## Unknowns
+
+## Limitations
+
+## Recommended Remediation
+
+Include evidence, impact, priority, time estimate/confidence, architecture impact, human decision needed, verification, and regression plan. Mark `TEST REQUIRED` for work owned by Phase 5.
+
+## UX Quality Gate
+
+`NOT_READY | REVIEW_IN_PROGRESS | BLOCKED | CONDITIONAL | READY`
+
+Reason against every READY criterion:
+
+## Recommended Next Action
+
+Exactly one **PRIMARY NEXT ACTION**:

package/skills/sherpa/templates/ux-verification.md

@@ -0,0 +1,32 @@
+# UX Verification
+
+## Finding ID
+
+## Original Problem
+
+## Expected Improvement
+
+## Verification Procedure
+
+Include revision, viewport/device, starting conditions, steps, and related focused UX check.
+
+## Expected Result
+
+## Actual Result
+
+## Status
+
+`PASSED | FAILED | BLOCKED | UNKNOWN`
+
+## Evidence
+
+Attach or reference direct observations, artifacts, and actual execution output. A planned or proposed fix is not verification.
+
+## Regression Impact
+
+Record affected flows/components and the regression check actually run. If required test work belongs to Phase 5, mark `TEST REQUIRED` and link its result when available.
+
+## Related Tests
+
+## Recommended Action
+