flow-audit-loop

Automate ACF flow auditing with bundle generation and cross-reference checks.

1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/speelbreaker/ralph-trader --skill flow-audit-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-audit-loop
Source: https://github.com/speelbreaker/ralph-trader/tree/main/SKILLS/flow-audit-loop
Command: npx skills add https://github.com/speelbreaker/ralph-trader --skill flow-audit-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end ACF flow auditing to validate and maintain flow integrity.

Core Features & Use Cases

  • Deterministic loop: bundle -> discovery audit -> patch specs -> regenerate bundle -> run checkers, repeat until no findings.
  • Ensures complete ARCH_FLOWS.yaml coverage and cross-reference consistency for specs/CONTRACT.md.
  • Use Case: Teams can repeatedly audit ACF-### flows to maintain flow integrity across deployments.

Quick Start

Use the flow-audit-loop skill to bootstrap an audit, generate a fresh bundle for ACF-XXX, and execute the checkers until clean.

Frequently Asked Questions about flow-audit-loop

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

FAQPage Schema
How do I audit ACF flow contracts for cross-reference consistency?

You can audit ACF flow contracts by running a deterministic loop that generates a bundle, runs discovery audits, patches specs, regenerates the bundle, and checks cross-references until no findings remain.

What is the best way to maintain ARCH_FLOWS.yaml coverage during deployments?

Maintaining ARCH_FLOWS.yaml coverage requires repeatedly auditing ACF-### flows using Python scripts like check_arch_flows.py to validate flow integrity and ensure complete coverage across deployments.

How do I fix cross-reference errors in specs/CONTRACT.md files?

Fix CONTRACT.md cross-reference errors by running check_contract_crossrefs.py within an audit loop that patches specs and regenerates bundles until the checker reports zero findings.

Do I need Python scripts to perform deterministic flow auditing?

Yes, deterministic flow auditing relies on Python scripts such as extract_contract_excerpts.py, check_contract_crossrefs.py, and check_arch_flows.py to perform repeatable checks on specs and ARCH_FLOWS.yaml.

What are the limitations of automated ACF flow contract patching?

Automated ACF flow contract patching is limited to deterministic, repeatable checks on ARCH_FLOWS.yaml and specs/CONTRACT.md files, requiring the loop to repeat until all cross-reference and discovery findings are resolved.