agent-guidelines

A Claude Code skill that encodes a mandatory personal development workflow for all Claude interactions.

What it does

The claude-guidelines skill enforces consistent, high-quality behavior across every software engineering task by codifying policies for:

• MCP Tool + Skill Discovery — Always discover tools and skills via the router before using them; never assume availability from a prior session.
• Codebase Navigation — LOI-first navigation (docs/index/_root.md) before falling back to Grep/Glob.
• Development Workflow — Write or update LOI intent before implementation code.
• Architecture — Domain / Application / Infrastructure separation with ports and adapters only when justified.
• Testing (TDD) — Failing test first, minimum passing code, then refactor.
• Git Workflow — Branch → commit → PR → CI → address feedback → merge.
• Web Search & HTTP — fetch-mcp only; never curl, wget, or shell HTTP clients.
• JSON Optimization — Pass large MCP JSON responses through optimize_json before reasoning.

Usage

The skill is registered as claude-guidelines and loads automatically for any software engineering task. It can also be invoked explicitly:

load_skill("claude-guidelines")

File

File	Description
SKILL.md	Full skill definition loaded by the MCP router