SKILL.md
VibeGuard
Lightweight VibeGuard for everyday use inside Spellbook.
This skill helps with three moments where AI-assisted work usually drifts:
- before implementation starts
- while review findings are being prioritized
- after regressions or avoidable mistakes happen
What This Skill Includes
- A task contract checklist for scoping work before coding
- A scoring matrix for prioritizing findings with evidence
- A weekly review template for regression and guardrail retrospectives
Hard Boundaries
This skill is intentionally lightweight.
It does:
- guide task kickoff
- structure review output
- make risk tradeoffs explicit
It does not:
- install hooks
- run guard scripts automatically
- patch global Claude or Codex configuration
- claim that full VibeGuard enforcement is active
If the user asks for automated interception, repo-level rules, or environment setup, escalate to the full VibeGuard repository and tooling.
When To Use It
Trigger this skill when the user asks for:
- anti-hallucination guardrails
- task startup checks
- review scoring or triage
- regression prevention
- retrospective templates
- "vibeguard" by name
Workflow
1. Start With The Task Contract
Open [references/task-contract.yaml](./references/task-contract.yaml) and confirm:
- goal
- source of truth
- acceptance criteria
- scope
Do not move into implementation until these are concrete.
2. Score Findings Before Acting
Open [references/scoring-matrix.md](./references/scoring-matrix.md) and score each finding on:
- impact
- effort
- risk
- confidence
Use the score to separate urgent fixes from weak guesses.
3. Pick The Right Delivery Mode
- 1-2 files: implement directly once the contract is clear
- 3-5 files: write a short spec or step plan first
- 6+ files: produce a full design/spec and staged execution plan
4. Review The Failure, Not Just The Symptom
If something regressed, identify which defense failed:
- scope control
- source-of-truth validation
- verification depth
- review prioritization
- missing guardrail
Then capture the follow-up in [references/review-template.md](./references/review-template.md).
Expected Outputs
Depending on the request, produce one of these:
- a filled task contract
- a scored findings table with priorities
- a short regression review or weekly retrospective
Reference Files
- [
references/task-contract.yaml](./references/task-contract.yaml) - kickoff checklist - [
references/scoring-matrix.md](./references/scoring-matrix.md) - prioritization model - [
references/review-template.md](./references/review-template.md) - retrospective template