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.