repo-10x-audit-to-bmad

Audit a repository against a 10/10 quality contract and generate BMAD-ready remediation input.

1|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill repo-10x-audit-to-bmad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-10x-audit-to-bmad
Source: https://github.com/jongensutrecht/demo-ai-stack/tree/main/lars%20skills/repo-10x-audit-to-bmad
Command: npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill repo-10x-audit-to-bmad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a repository into a hard, evidence-based 10/10 audit target by scoring it against searchability, usability, governance, and maintainability contracts, then converting the findings into BMAD-ready remediation input.

Core Features & Use Cases

  • Repo contract audit: Evaluates a codebase with strict PASS/FAIL reasoning across quality gates, sources of truth, search hygiene, and file-limit enforcement.
  • BMAD plan generation: Produces structured remediation artifacts that can be executed as a prioritized recovery plan.
  • Evidence-first workflow: Forces UNKNOWN handling, exact verification checks, and explicit stop conditions when a claim cannot be proven.
  • Use case: Use it when a team needs to harden a repository for LLM-assisted development, enforce governance, and make the codebase easier for both humans and agents to navigate.

Quick Start

Ask the skill to audit this repository against the 10/10 contract and generate a BMAD-ready remediation plan with evidence, priorities, and stop conditions.

Frequently Asked Questions about repo-10x-audit-to-bmad

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

FAQPage Schema
How do I audit a repository against strict quality gates for LLM-assisted development?

Repository audit for LLM-assisted development requires scoring the codebase against deterministic searchability, human usability, and governance traceability contracts. It enforces evidence-based PASS/FAIL checks for search hygiene, sources-of-truth documentation, and file-limit compliance.

What is a BMAD-ready remediation plan for repository governance?

A BMAD-ready remediation plan converts repository audit findings into structured, prioritized recovery artifacts. It uses evidence-based PASS/FAIL scoring and explicit stop conditions to harden codebase governance for LLM-assisted development.

How do I enforce file limits and search hygiene in a codebase?

Enforce file limits and search hygiene by applying strict repo-root checks and deterministic searchability audits with explicit exceptions. This ensures human usability and agent navigation without hitting unprovable UNKNOWN states.

Does repository audit scoring require evidence-based verification checks?

Yes, repository audit scoring requires evidence-based verification checks to handle UNKNOWN states and enforce explicit stop conditions. This prevents unprovable claims and guarantees deterministic 10/10 quality contract compliance.

When do I need to generate a 10/10 quality contract remediation plan?

You need a 10/10 quality contract remediation plan when a team must harden a repository for LLM-assisted development and enforce strict governance. It resolves searchability and maintainability failures before deploying automated agents.