Skip to content

Agents

The plugin provides custom subagents that can be invoked during Claude Code sessions.

Bootstrap Agent

Model: haiku Tools: Read, Glob, Grep, Bash

The bootstrap agent runs at the start of every work session to validate the development environment and emit a preflight status report. It runs before any code changes are made.

Checks Performed

  1. Repository Profile — reads vergil.toml and extracts repository_type, branching_model, primary_language, and canonical_local_validation_command

  2. Branch State — reports the current branch and warns if on a protected branch (main or develop)

  3. Standards and Conventions — checks if the standards repo is available locally at ../standards-and-conventions

  4. Hook Guard — verifies vrg-hook-guard is available

Status Report

The agent emits a structured report:

=== Session Bootstrap ===
Repository:    <repo name>
Profile:       <repository_type> | <branching_model> | <primary_language>
Branch:        <current branch> [WARNING if protected]
Validation:    <validation command or "not configured">
Standards:     <local or web fallback>
Git hooks:     <hooks path or "NOT CONFIGURED">
=========================

Any warnings are collected and listed in a separate section after the status block.