flux-prime

Run parallel scouts to assess codebase readiness and generate remediation plans.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comprehensive, standardized readiness assessments to reveal agent readiness and production-readiness gaps, enabling teams to act with targeted fixes rather than guesswork.

Core Features & Use Cases

  • Nine scouts run in parallel to audit code quality, tests, docs, CI/CD, and security signals.
  • Generates a structured remediation plan focused on agent readiness with non-destructive, consent-based changes.
  • Seeds or refresh a canonical architecture note at .flux/brain/codebase/architecture.md for the team’s map of the product.
  • Supports interactive remediation through AskUserQuestion to capture explicit user consent before applying changes.
  • Produces a comprehensive report of agent readiness gaps and informational production-readiness signals to guide improvements.

Quick Start

Invoke the Prime workflow with /flux:prime to start the assessment in the current repository.

Frequently Asked Questions about flux-prime

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

FAQPage Schema
How do I assess codebase readiness for agent workflows?

Codebase readiness for agent workflows is assessed by running parallel scouts that audit code quality, tests, docs, CI/CD, and security. This generates a structured remediation plan with multi-pillar scoring to identify agent readiness gaps.

Can I run an automated codebase health check across a multi-language monorepo?

Yes, automated codebase health checks support monorepos and multi-language stacks of all sizes. Nine scouts run in parallel to evaluate production-readiness signals and produce a comprehensive report of architectural gaps.

How do I generate an architecture note for my software project automatically?

To generate an architecture note automatically, the workflow seeds or refreshes a canonical map of the product at .flux/brain/codebase/architecture.md. This provides a shared architectural reference for the entire team.

Does the remediation plan apply patches without user consent?

No, the remediation plan applies non-destructive patch proposals that require explicit user consent. Interactive remediation captures your approval through AskUserQuestion before any changes are made to the codebase.

What is the best way to identify production-readiness gaps in a CI/CD pipeline?

The best way to identify production-readiness gaps is using parallel scouts that audit CI/CD alignment alongside code and security signals. This produces informational reports to guide targeted improvements rather than guesswork.

When should I not use an automated codebase readiness assessment?

You should not use automated codebase readiness assessment if you need to apply changes without explicit consent or require manual architectural reviews. The workflow is strictly non-destructive and relies on interactive user approval.