ad-guidelines

Draft or update GUIDELINES.md with engineering standards from codebase scans.

728|16|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-guidelines
Source: https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime/tree/main/.agents/skills/ad-guidelines
Command: npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about ad-guidelines

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

FAQPage Schema
How do I create engineering guidelines for a repository?

To create engineering guidelines, the skill drafts or updates a GUIDELINES.md file at the repo root. It scans the codebase to pre-fill sections and asks only about genuine gaps to establish coding standards.

What coding standards does this skill apply to a project?

The coding standards applied include Clean Architecture binding, SOLID principles, Object Calisthenics tiers, naming conventions, error handling, complexity discipline, API rules, performance, testing, and security.

Can I use this to audit existing code standards and security policies?

Yes, you can use this skill to audit existing code standards. It scans the repository for existing test, lint, and format configurations, pre-fills verified sections, and surfaces gaps for user-guided customization.

Does the skill work with existing AGENTS.md and WORKFLOW.md files?

Yes, the skill works with existing AGENTS.md and WORKFLOW.md files. It applies across this Layer 1 Constitution trinity to codify engineering standards without duplicating universal philosophy or distilled rules.

What is the best way to enforce SOLID principles and Object Calisthenics in a codebase?

The best way to enforce SOLID and Object Calisthenics is drafting a comprehensive GUIDELINES.md reference. The skill codifies SOLID application and defines Object Calisthenics tiers (loose, moderate, strict) for the project.