behavioral-guidelines

Applies coding guidelines that reduce overcomplication and enforce surgical, verifiable changes.

659|81|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/ThibautBaissac/rails_ai_agents --skill behavioral-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: behavioral-guidelines
Source: https://github.com/ThibautBaissac/rails_ai_agents/tree/main/.agents/skills/behavioral-guidelines
Command: npx skills add https://github.com/ThibautBaissac/rails_ai_agents --skill behavioral-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

LLM coding assistants often overcomplicate solutions, make silent assumptions, refactor unrelated code, and declare success without verification. This Skill provides behavioral guidelines that counteract these tendencies when writing, reviewing, or refactoring code.

Core Features & Use Cases

  • Think Before Coding: Surfaces assumptions, ambiguities, and simpler alternatives before implementation instead of silently picking an interpretation.
  • Simplicity and Surgical Changes: Enforces minimum-code solutions and restricts edits to lines directly traceable to the user's request, matching existing style.
  • Goal-Driven Execution: Transforms vague tasks into verifiable success criteria (e.g., write a failing test, then make it pass) with explicit step-by-step verification plans.
  • Use Case: When asking an AI to fix a bug or add a validation in a Rails codebase, activate these guidelines so the assistant writes a reproducing test first, changes only the necessary lines, and avoids speculative abstractions.

Quick Start

Ask the assistant to apply the behavioral guidelines while implementing your next code change so it states assumptions, keeps edits minimal, and defines verifiable success criteria.

Frequently Asked Questions about behavioral-guidelines

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

FAQPage Schema
How do I stop an AI assistant from overcomplicating code?

Apply simplicity-first guidelines that forbid speculative features, single-use abstractions, and unrequested configurability. The assistant checks whether a senior engineer would call the solution overcomplicated and rewrites it if a shorter equivalent exists.

How to make AI code changes surgical and minimal?

Require that every changed line traces directly to the user's request. The assistant must not refactor adjacent code, reformat unrelated sections, or delete pre-existing dead code, while still cleaning up orphans its own changes created.

When should these behavioral guidelines not be applied?

The guidelines bias toward caution over speed, so for trivial tasks they may add unnecessary overhead. Use judgment and skip the full assumption-surfacing and planning process for very small, unambiguous changes.

How do I verify an AI actually completed a coding task?

Convert the task into verifiable success criteria, such as writing a failing test that reproduces a bug and then making it pass. For multi-step work, require a brief plan where each step has an explicit verification check.

Does this work with test-driven development workflows?

Yes, the goal-driven execution section maps naturally to TDD by framing tasks as tests to write and pass. Examples include writing tests for invalid inputs before adding validation and ensuring tests pass before and after refactoring.