guidelines

Enforce explicit assumptions and minimal edits in LLM-generated code.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/BrunoAMSilva/my-config --skill guidelines-brunoamsilva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guidelines
Source: https://github.com/BrunoAMSilva/my-config/tree/main/coding/skills/guidelines
Command: npx skills add https://github.com/BrunoAMSilva/my-config --skill guidelines-brunoamsilva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

These behavioral guidelines reduce common mistakes when LLMs write, review, or refactor code by surfacing assumptions, avoiding overcomplication, and defining verifiable success criteria so changes are safe and reviewable.

Core Features & Use Cases

  • Explicit assumptions: Require stating uncertainties and alternative interpretations before coding.
  • Simplicity first: Favor minimal code that directly solves the request and avoid speculative features.
  • Surgical changes: Limit edits to only what the task requires and remove only new orphaned artifacts.
  • Goal-driven execution: Convert tasks into verifiable steps with checks (e.g., tests) to validate completion.
  • Use Cases: Generating new functions, fixing bugs with reproducible tests, reviewing pull requests, and performing small refactors guided by LLMs.

Quick Start

When reviewing or implementing code from an LLM, state assumptions, choose the simplest solution, make only surgical edits, and define one or two verifiable success checks.

Frequently Asked Questions about guidelines

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

FAQPage Schema
How do I prevent LLM generated code from overcomplicating my project?

To prevent overcomplication in LLM generated code, enforce simplicity-first implementations that favor minimal code directly solving the request. State explicit assumptions, avoid speculative features, and make surgical changes limited only to what the task requires.

Why does LLM refactoring introduce unnecessary changes to my codebase?

LLM refactoring often introduces unnecessary changes when surgical edits are not enforced. To stop this, limit modifications to only what the task requires, avoid speculative features, and remove only newly orphaned artifacts to keep changes safe and reviewable.

What is the best way to review LLM code for pull requests?

The best way to review LLM code for pull requests is to require explicit assumptions, choose the simplest solution, and define verifiable success checks like tests. Ensure edits are surgical and minimal to produce safe, reviewable results.

How do I verify LLM bug fixes without breaking existing functionality?

To verify LLM bug fixes without breaking functionality, convert tasks into verifiable steps with checks like reproducible tests. Define one or two success criteria to validate completion, ensuring the changes are safe and do not introduce speculative features.

Can I force an LLM to state assumptions before writing code?

Yes, you can force an LLM to state assumptions before writing code by applying behavioral guidelines. Require it to surface uncertainties and alternative interpretations beforehand, ensuring goal-driven execution and verifiable success criteria for testable results.

When should I not use automated LLM code generation?

You should not use automated LLM code generation without explicit guidelines if the task requires strict surgical edits or verifiable success criteria. Avoid it when simplicity-first implementations are mandatory and unchecked speculative features could compromise the codebase.