Brett Franklin Breklin

Be pragmatic, surgical, and outcome-focused.

Default to the smallest correct change that solves the stated problem. Do not widen scope unless I explicitly ask for it. Do not refactor, rename, reorganise, or “clean up” unrelated code. Prefer modifying existing code over introducing new abstractions unless a new abstraction is clearly warranted.

Before making changes:

Identify the objective, constraints, and assumptions briefly.
Inspect the relevant files and locate the exact change points.

AGENTS.md Best Practices for AI Coding Assistants: Comprehensive Guide

AGENTS.md has emerged as the de facto open standard for guiding AI coding assistants, now adopted by over 20,000 repositories and formalized in August 2025 through collaboration between OpenAI, Google, Cursor, Factory, and Sourcegraph. This file acts as a "README for machines"—providing structured, technical context that helps AI assistants write better code from the start. For Python + AWS + Terraform projects, a well-crafted AGENTS.md dramatically reduces friction, ensuring generated code follows your conventions, uses the right tools, and adheres to security requirements.

What is AGENTS.md and why it matters

AGENTS.md is a dedicated Markdown file that complements, not replaces, README.md. While README targets human developers with project overviews and quick-start guides, AGENTS.md contains detailed technical instructions specifically for AI coding agents. Think of it as onboarding documentation for an AI team member: ex

### ABOUT
Modern AI coding tools converge on a simple idea: give the agent a **single, well-structured Markdown file that explains how your repo “works,”** and prepend that file to every LLM call so the agent never has to guess about architecture, commands, or conventions. Community gists, RFCs, and vendor playbooks all recommend the same core sections—overview, project map, build/test scripts, code style, security, and guardrails—plus support for nested AGENTS.md files that override one another hierarchically.

### SYSTEM
You are a meticulous technical writer and senior staff engineer.  
Your task is to create **AGENTS.md** for the repository whose contents are provided below.

### CONTEXT (replace the JSON blocks)
See the attached files.

The Autonomous Agent Prompting Framework

This repository contains a disciplined, evidence-first prompting framework designed to elevate an Agentic AI from a simple command executor to an Autonomous Principal Engineer.

The philosophy is simple: Autonomy through discipline. Trust through verification.

This framework is not just a collection of prompts; it is a complete operational system for managing AI agents. It enforces a rigorous workflow of reconnaissance, planning, safe execution, and self-improvement, ensuring every action the agent takes is deliberate, verifiable, and aligned with senior engineering best practices.

I also have Claude Code prompting for your reference: https://gist.github.com/aashari/1c38e8c7766b5ba81c3a0d4d124a2f58

Introduction
Install Windows Terminal
Install WSL Ubuntu
Install Nginx
Install MySQL

	module.exports = {
	trailingComma: 'es5',
	tabWidth: 4,
	semi: false,
	singleQuote: true,
	}

	<?php
	/**
	* Plugin Name: [Forminator] - Validation form fields.
	* Description: [Forminator] - Validate form fields based on defined validation rule.
	* Plugin URI: https://wpmudev.com/
	* Author: Abdoljabbar Bakhshande
	* Author URI: https://wpmudev.com/
	* License: GPLv2 or later
	*/

	<?php

	/**
	* This add a simple verification for selected fields if those have own value
	**/

	add_filter('forminator_custom_form_submit_errors', 'verification_for_unique_values_forminator_wp', 10, 3);

	function verification_for_unique_values_forminator_wp($submit_errors, $form_id, $field_data_array) {

	<?php

	add_action( 'wp_footer', function(){ ?>
	<script>
	(function ($) {
	$(function () {
	$(document).on("after.load.forminator", function (e, id) {
	var cvalinput = $('.custom-validate input');

	let regx = /^[0-9]*$/;

	<?php
	/**
	* Plugin Name: [Forminator] Custom number format for Calculation field.
	* Description: [Forminator] Custom number format for Calculation field.
	* Jira: SLS-470
	* Author: Thobk @ WPMUDEV
	* Author URI: https://premium.wpmudev.org
	* License: GPLv2 or later
	*/
	if ( ! defined( 'ABSPATH' ) ) {