project-rules-design

Restructure project engineering rules into domain-based index.md and rules.md files.

Updated May 12, 2026
One-click install
npx skills add https://github.com/YeomanYe/skills --skill project-rules-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-rules-design
Source: https://github.com/YeomanYe/skills/tree/main/project-rules-design
Command: npx skills add https://github.com/YeomanYe/skills --skill project-rules-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams design, audit, restructure, or document a project's engineering rules system, clarifying rule domains, responsibilities, and how to route entrypoints like CONTRIBUTING and domain-specific indexes to improve governance and AI consumption.

Core Features & Use Cases

  • Define rule domains and responsibilities, establish clear boundaries between architecture, coding, UI, and AI-guide, and identify gaps in the rule framework.
  • Create a stable entry point (CONTRIBUTING.md) and per-domain indexes under docs/ (docs/<domain>/index.md) plus references and optional assets, enabling consistent navigation and AI routing.
  • Provide migration guidance and reference patterns (e.g., shadcn-admin) to illustrate domain classification and target structure.

Quick Start

Outline a domain-based rules architecture for a project by defining entry points, domain scopes, and a migration plan.

Frequently Asked Questions about project-rules-design

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

FAQPage Schema
How do I structure engineering documentation for a complex project?▼

To structure engineering documentation, you inventory existing rules and restructure them into domain-based folders. This creates a stable architecture with an entrypoint like CONTRIBUTING.md and per-domain indexes under docs/ to ensure consistent navigation and AI routing.

What is the best way to organize project rules by domain?▼

Organizing project rules by domain involves defining clear boundaries between architecture, coding, UI, and AI-guide areas. You assign responsibilities to each domain and establish index.md and rules.md files per domain to clarify governance and identify coverage gaps.

How do I migrate existing project rules into a new architecture?▼

To migrate project rules, you apply domain classification using reference patterns like shadcn-admin. This guides the transition to a target structure with domain indexes, references, and optional asset folders, while flagging coverage gaps against stack checklists.

When should I audit my project's engineering rules system?▼

You should audit your engineering rules system when your project lacks clear boundaries between architecture, coding, UI, and AI-guide domains. An audit clarifies rule responsibilities, identifies framework gaps, and establishes stable entry points for consistent navigation.

Can I use this approach to define boundaries between architecture and UI rules?▼

Yes, you can define boundaries between architecture, coding, UI, and AI-guide rules. The process involves assigning specific responsibilities to each domain and creating separate index.md and rules.md files to maintain clear governance and structural separation.

How do I create a CONTRIBUTING.md entrypoint for my engineering rules?▼

Creating a CONTRIBUTING.md entrypoint involves establishing it as the central navigation point for your engineering rules. It routes users and AI to per-domain indexes under docs/, ensuring consistent access to architecture, coding, and UI guidelines.