project-conventions

Discover and enforce existing project conventions before modifying code.

44|9|Updated May 7, 2026
One-click install
npx skills add https://github.com/Omar-Obando/qwen-orchestrator --skill project-conventions-omar-obando
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-conventions
Source: https://github.com/Omar-Obando/qwen-orchestrator/tree/main/skills/project-conventions
Command: npx skills add https://github.com/Omar-Obando/qwen-orchestrator --skill project-conventions-omar-obando

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents AI coding agents from breaking established conventions in existing codebases by forcing discovery of the current architecture, request/query patterns, code style, and database conventions before writing any new code.

Core Features & Use Cases

  • Convention discovery for existing projects: Maps frameworks, directory structure, entry points, API patterns, error/pagination behavior, and state/data fetching approaches used by the current stack.
  • Style and architecture compliance rules: Enforces strict matching of naming, imports, error handling, libraries, and state management to avoid introducing mismatched patterns.
  • Safety guardrails and “ask when unsure”: Requires reading existing files in the target area and routes ambiguous cases to an explicit user question.

Quick Start

Use the project-conventions skill when updating an existing repository and ask the AI to discover conventions first, then propose changes that comply with the codebase style and architecture.

Frequently Asked Questions about project-conventions

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

FAQPage Schema
How do I make an AI coding agent follow existing project conventions when modifying a codebase?

To enforce project conventions, the AI agent maps existing frameworks, directory structures, and coding standards before writing any code. It then strictly applies these discovered patterns during refactoring or feature additions to maintain consistency.

What is architecture discovery and how does it work for an existing codebase?

Architecture discovery maps an existing project's frameworks, directory structures, entry points, and API request patterns before any code changes. This process ensures new modifications match the established request flow and coding standards.

How do I add a feature to an existing project without breaking established coding standards?

To add features without breaking coding standards, the agent reads existing files in the target area, discovers the current style and error handling patterns, and applies strict compliance rules to match the established codebase architecture.

Can an AI agent discover database conventions and API patterns before refactoring code?

Yes, the agent performs mandatory convention discovery across architecture, API patterns, and database conventions before refactoring. It maps current state management and data fetching approaches to ensure strict compliance with the existing codebase.

What happens when an AI agent is unsure about existing code style during a codebase modification?

When unsure about existing code style, the agent uses safety guardrails to route ambiguous cases to an explicit user question. This prevents introducing mismatched patterns, naming conventions, or libraries into the project.