ad-guidelines

What problem does it solve?

Draft or update GUIDELINES.md at the repo root — the project's full engineering reference. Layer 1 Constitution trinity member (alongside WORKFLOW.md universal philosophy and AGENTS.md distilled rules). Covers Clean Architecture binding, SOLID application, Object Calisthenics tier (loose / moderate / strict per Bay 2008), naming conventions, error handling, complexity discipline, API rules, performance standards, build system, static analysis, quality gates, testing strategy, git workflow, documentation, and security. Scan-first — reads language toolchain, existing test/lint/format config, and existing AGENTS.md sections, pre-fills every placeholder it can verify, then asks only the genuine gaps and preference questions. Use when the user wants to draft, scaffold, audit, or update engineering guidelines / code standards / coding conventions / SOLID adoption / testing strategy / security policy / build conventions for the project. Skill is lazy — file only exists when the project needs engineering standards.

Core Features & Use Cases

• Guides drafting and auditing of engineering guidelines, coding standards, and security policies across a project.
• Scans the repository to pre-fill sections, ensuring consistency with existing artefacts like AGENTS.md and WORKFLOW.md.
• Provides a lazy lifecycle owner pattern, enabling teams to maintain a single source of truth for code standards and practices.

Quick Start

Update or create GUIDELINES.md at the repo root by running the skill to scaffold complete engineering guidelines.