folder-forensic-audit

Audit project folder structure, documentation, and configuration for technical debt.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/Brandondaymdr/Claude-Skills --skill folder-forensic-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: folder-forensic-audit
Source: https://github.com/Brandondaymdr/Claude-Skills/tree/main/folder-forensic-audit
Command: npx skills add https://github.com/Brandondaymdr/Claude-Skills --skill folder-forensic-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, gitleaks, jq, pnpm, and includes references (resource) and agents (resource) components.

What problem does it solve?

This skill resolves project disorganization, stale documentation, and configuration drift by performing a comprehensive forensic audit of your repository's structure, health, and developer experience.

Core Features & Use Cases

  • Multi-Domain Auditing: Evaluates folder structure, documentation, Claude configuration, code health, and git hygiene against industry best practices.
  • Prescriptive Conformance: Automatically retrofits projects to match canonical defaults, including CI workflows, ADR templates, and branch protection.
  • Use Case: Run this when a long-running project feels slow or disorganized to identify technical debt, missing documentation, or configuration gaps that are hindering your development speed.

Quick Start

Invoke the folder-forensic-audit skill to perform a full health check on your current project directory.

Frequently Asked Questions about folder-forensic-audit

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

FAQPage Schema
How do I audit my repository for technical debt and configuration drift?

To audit your repository for technical debt, you run a forensic audit of your project folder structure, documentation, and configuration. This process evaluates folder organization, git hygiene, and CI/CD workflows to identify health issues.

How do I automate project conformance for CI workflows and branch protection?

You automate project conformance by applying prescriptive fixes that retrofit your repository to canonical defaults. This automatically establishes standardized CI workflows, ADR templates, and branch protection rules to ensure a consistent developer experience.

What is a forensic folder structure audit and when do I need one?

A forensic folder structure audit is a comprehensive evaluation of your repository organization, documentation, and configuration against best practices. You need one when a long-running project feels slow or disorganized to identify missing documentation and configuration gaps.

Do I need gitleaks and jq installed to run a multi-agent project health check?

Yes, running a multi-agent project health check requires gitleaks, jq, gh, and pnpm installed in your environment. These dependencies support the forensic audit by enabling secret detection, JSON parsing, GitHub CLI operations, and package management.

Can this audit automatically fix missing documentation and code health issues?

Yes, the audit applies prescriptive conformance fixes to automatically retrofit projects with missing documentation and correct configuration gaps. It addresses code health and documentation issues by matching your project to canonical defaults.

What are the limitations of automated repository conformance for multi-agent environments?

Automated repository conformance applies prescriptive fixes based on canonical defaults, which may overwrite custom workflows if not reviewed carefully. While it standardizes developer experience across multi-agent environments, manual validation of complex CI/CD retrofits is recommended.