mcpField
V
vibeguard

vibeguard

github.com/majiayu000Agent workflows28862 installsUpdated today
Repository

About vibeguard

vibeguard is a lightweight workflow skill for everyday use in Spellbook, aimed at developers who need clearer task scope, review priorities, and regression retrospectives. It organizes work with checklists, a scoring matrix, and templates rather than automatically running guard scripts or changing global configuration.

Key features

  1. 01Pre-coding task contract checklist
  2. 02Evidence-based review finding scores
  3. 03Delivery plans based on file count
  4. 04Regression and guardrail review template

Use cases

  1. 01Clarify goals and acceptance criteria before coding
  2. 02Prioritize review findings by impact and risk
  3. 03Identify failed defenses after a regression

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/majiayu000/spellbook --skill vibeguard

After installing, type/vibeguardin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
review-template.md
scoring-matrix.md
task-contract.yaml

Details

From the project README

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 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 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.

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

Comments

Markdown supported