flux-grill

Verify implemented behavioral branches against epic specs from .flux and git diff.

7|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Nairon-AI/flux --skill flux-grill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flux-grill
Source: https://github.com/Nairon-AI/flux/tree/main/skills/flux-grill
Command: npx skills add https://github.com/Nairon-AI/flux --skill flux-grill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After an epic is implemented, teams need a rigorous way to ensure that all behavioral branches align with the intended design and to surface edge-case gaps before shipping.

Core Features & Use Cases

  • Builds a decision-tree model from epic specs and task specs to map expected behaviors.
  • Iterates branch-by-branch against the codebase to verify actual behavior matches the spec, flagging ambiguities for clarification.
  • Performs an edge-case gauntlet (empty states, concurrency, permissions, failure modes) and generates a Behavioral Summary for risk assessment.
  • Provides guidance to update epic specs or create tasks when gaps are discovered; optionally records decisions in the brain vault.

Quick Start

Invoke Grill after completing an epic review to exhaustively verify behavior alignment and readiness for production.

Frequently Asked Questions about flux-grill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify behavioral branches and edge cases after completing an epic?▼

To verify behavioral branches after an epic, analyze epic intent and implemented git diffs to confirm actual behavior matches the original design specs. This process maps expected behaviors into a decision-tree and iterates branch-by-branch against the codebase to flag ambiguities.

What is behavioral verification for state transitions and user permissions?▼

Behavioral verification for state transitions is the process of exhaustively testing user actions, permissions, and integrations against epic specs. It builds a decision-tree model from task data to ensure actual codebase behavior aligns with the intended design before shipping.

How do I run an edge-case gauntlet for empty states and concurrency before shipping?▼

Run an edge-case gauntlet by iterating branch-by-branch against the codebase to test empty states, concurrency, permissions, and failure modes. This generates a Behavioral Summary for risk assessment, surfacing gaps between implemented changes and epic specs.

Does flux-grill work with git diffs and task data stored in .flux?▼

Yes, behavioral verification works directly with git diffs and task data. It accesses epic specs stored in the .flux directory and fluxctl-managed task data to drive a branch-by-branch verification workflow across all state transitions.

When should I use behavioral verification for quality assurance?▼

Use behavioral verification for quality assurance immediately after an epic review or right before shipping. It is needed when you must exhaustively confirm that implemented changes and state transitions align with the original epic design and surface edge-case gaps.

What is the best way to update epic specs when behavioral gaps are discovered?▼

The best way to update epic specs when gaps are discovered is to use verification guidance that flags ambiguities for clarification. This process provides actionable steps to update specs, create new tasks, and optionally record decisions in the brain vault.