agent-conventions

Conventions that make codebases searchable, predictable, and agent-friendly. The core principle: agents write the code; conventions write the law.

Use a predictable layout so agents can place and find files deterministically.

Scope: The folder structures below are organized by project type. Universal rules (naming, exports, testing, errors, logging, security) apply to all project types. Folder structures are type-specific — don't force web app folders onto a game or CLI.

Обеспечьте соблюдение соглашений по коду, которые делают базы кода удобными для агентов и самовосстанавливающимися. Вдохновлен философией Factory AI «разработка с использованием собственных агентов», в которой правила и соглашения о ворсинках действуют как ограждения для агентов кодирования ИИ. Используйте этот навык при создании, проверке или рефакторинге кода на любом языке или платформе. Запускается при: генерации кода, создании файла, рефакторинге, проверке кода, новых функциях, исправлениях ошибок, миграции или любой задаче, создающей исходный код. Охватывает организацию файлов, именование, возможность поиска, тестирование, обработку ошибок, ведение журнала, безопасность и архитектурные границы. Справочники по стеку доступны для React, Vue, Angular, Laravel, .NET, Python, Go, Rust и других. Источник: zokor/agent-conventions.