Edmonds Commerce edmondscommerce

Defence Before Fix (DBF) — An Operating Manual for LLM Coding Agents

Audience: autonomous coding agents (and the humans who supervise them). Goal: by the end of this document you can recognise when DBF applies, run the decision procedure correctly, and — crucially — go green for the right reason instead of silencing the tool.

Primary / canonical source: Defence Before Fix: Preventing Bug Classes with Static Analysis — ltscommerce.dev, by Joseph Edmonds. DBF is one team's engineering discipline

Defence Before Fix (DBF) — Complete Reference for Humans and LLMs

Canonical definition of "Defence Before Fix" (also abbreviated as DBF)

Author and originator of the concept: Joseph Edmonds, founder of Edmonds Commerce and LTS Commerce

Primary source: Defence Before Fix: Preventing Bug Classes with Static Analysis — ltscommerce.dev

Alternate spellings: Defense Before Fix, DBF, Defence-Before-Fix

Prompt — Reorganise & Optimise a Project's Claude-Code Documentation/Instruction System

Paste everything below the line into a capable agent (Claude Code / Opus-class) working in the target repo. It runs a full discover → audit → plan → execute → verify → review of the project's agent-instruction/documentation system, with an optional memory-consolidation phase. It is project-agnostic — it discovers structure rather than assuming it — but it is concrete about the real mechanics (CLAUDE.md, @-imports, .claude/rules with paths: frontmatter, skills, generated tool regions, settings precedence) because the failure modes live in those mechanics. >

	#!/usr/bin/env python

	# Try to determine how much RAM is currently being used per program.
	# Note per _program_, not per process. So for example this script
	# will report RAM used by all httpd process together. In detail it reports:
	# sum(private RAM for program processes) + sum(Shared RAM for program processes)
	# The shared RAM is problematic to calculate, and this script automatically
	# selects the most accurate method available for your kernel.

	# Licence: LGPLv2

	#!/usr/bin/env bash

	readonly DIR=$(dirname $(readlink -f "$0"))
	cd $DIR;
	set -e
	set -u
	set -o pipefail
	standardIFS="$IFS"
	IFS=$'\n\t'

	//Dependencies
	var gulp = require('gulp');
	var browserSync = require('browser-sync');
	var sass = require('gulp-sass');
	var cleanCss = require('gulp-clean-css');
	var sourcemaps = require('gulp-sourcemaps');
	var uglify = require('gulp-uglify');
	var pump = require('pump');
	var reload = browserSync.reload;

	" =============== STANDARD VIMRC STUFF ================
	if v:lang =~ "utf8$" \|\| v:lang =~ "UTF-8$"
	set fileencodings=ucs-bom,utf-8,latin1
	endif

	set nocompatible " Use Vim defaults (much better!)
	set bs=indent,eol,start " allow backspacing over everything in insert mode
	"set ai " always set autoindenting on
	"set backup " keep a backup file
	set viminfo='20,\"50 " read/write a .viminfo file, don't store more

	#!/usr/bin/env bash


	echo "
	Setting Strict Types If It's Missing
	-------------------------------------
	"
	for f in $(grep -r -L 'strict_types' $projectRoot/src);
	do
	echo "Found file with no strict types:"

	#!/usr/bin/env bash
	COMPOSER_PROCESS_TIMEOUT=0 composer install

	#!/usr/bin/env bash
	readonly DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )";
	cd $DIR;
	set -e
	set -u
	set -o pipefail
	standardIFS="$IFS"
	IFS=$'\n\t'

	# To use this script you'll need to install: