Eunjae LeeGitHubDevin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>Claude Opus 4.5* feat: add GitHub workflows to sync agents/ to Devin Knowledge - Add parse-to-devin-knowledge.ts to convert agents/ markdown to Devin Knowledge JSON - Add validate-format.ts to validate rules have frontmatter and knowledge-base sections start with 'When...' - Add sync-to-devin.ts to sync knowledge entries to Devin API - Add export-devin-knowledge.sh to backup existing Devin knowledge - Add validate-agents-format.yml workflow to validate format on PRs - Add sync-agents-to-devin.yml workflow to sync on merge to main - Add devin-knowledge.json to .gitignore (generated file) Co-Authored-By: [email protected] <[email protected]> * fix: use tsx instead of ts-node for better ESM support in CI Co-Authored-By: [email protected] <[email protected]> * docs: add missing knowledge entries from Devin backup Co-Authored-By: [email protected] <[email protected]> * refactor: move agents scripts to scripts/ folder Co-Authored-By: [email protected] <[email protected]> * refactor: rename scripts to devin-knowledge-* for clarity Co-Authored-By: [email protected] <[email protected]> * refactor: move scripts to scripts/devin/ with clearer names Co-Authored-By: [email protected] <[email protected]> * rename DEVIN_API_TOKEN to DEVIN_API_KEY * docs: fix usage comment script path Co-Authored-By: [email protected] <[email protected]> * fix: remove folder creation from sync script (API doesn't support it) Co-Authored-By: [email protected] <[email protected]> * fix: add -S flag to shebang for proper env execution Co-Authored-By: [email protected] <[email protected]> * use pull_request_target * fix: add -S flag to shebang in sync-knowledge-to-devin.ts for proper env execution Co-Authored-By: unknown <> * restructure workflows * refactor: consolidate agent docs and split knowledge-base into modular rules - Delete knowledge-base.md, migrate content to 17 new rule files - Delete coding-standards.md (content duplicated in AGENTS.md and rules) - Add ci- and reference- prefixes to rules/_sections.md - Update AGENTS.md to reference new rule files - Update agents/README.md as rules index - Clean up parse-local-knowledge.ts (remove deleted file references) New rule files: - testing-playwright, testing-mocking, testing-timezone - ci-check-failures, ci-type-check-first, ci-git-workflow - data-prisma-migrations, data-prisma-feature-flags - quality-error-handling, quality-imports, quality-pr-creation, quality-code-comments - architecture-features-modules - patterns-workflow-triggers, patterns-app-store - reference-file-locations, reference-local-dev Co-Authored-By: Claude Opus 4.5 <[email protected]> * Revert "refactor: consolidate agent docs and split knowledge-base into modular rules" This reverts commit 8251b6b214c7c01a3bfe2137c6aa9292dd72427e. * refactor: reorganize agent docs - extract coding rules, keep domain knowledge - Slim down knowledge-base.md (356 → 96 lines) to domain knowledge only - Add Business rules section (managed events, orgs/teams, OAuth clients) - Delete coding-standards.md (content moved to rules) - Create 19 new rule files for coding guidelines: - quality-*: PR creation, error handling, imports, comments, code review - testing-*: playwright, mocking, timezone, incremental - ci-*: check failures, type-check-first, git workflow - data-prisma-*: migrations, feature flags - patterns-*: workflow triggers, app store - architecture-features-modules, reference-file-locations, reference-local-dev - Update agents/README.md as rules index (43 total rules) - Update _sections.md with CI/CD and Reference sections - Clean up parse-local-knowledge.ts Co-Authored-By: Claude Opus 4.5 <[email protected]> * fix: rename knowledge-base sections to start with "When..." Update section headers to pass validation rules: - "Business Rules" → "When working with managed events, organizations, or OAuth clients" - "Product & Codebase Knowledge" → "When you need product or codebase context" Co-Authored-By: Claude Opus 4.5 <[email protected]> * refactor: split knowledge-base business rules into separate sections Split the combined "When working with managed events, organizations, or OAuth clients" section into three distinct ## sections for better Devin triggering: - When working with managed event types - When working with organizations and teams - When working with OAuth clients Co-Authored-By: Claude Opus 4.5 <[email protected]> * refactor: simplify trigger description logic in parse-local-knowledge.ts Since validate-local-knowledge.ts enforces that all section titles must start with "When...", we can remove the manual fallback logic and just use the title directly as the trigger description. Co-Authored-By: Claude Opus 4.5 <[email protected]> * refactor: simplify knowledge-base section validation Simplify the validation to only check that section titles start with "When..." since we've standardized on that pattern. Remove the special cases for error, file naming, PR, and repo note sections. Co-Authored-By: Claude Opus 4.5 <[email protected]> * feat: add script to delete all Devin knowledge entries Add delete-all-devin-knowledge.ts script that: - Lists all knowledge entries before deletion - Requires interactive confirmation (Y) to proceed - Blocks execution in non-TTY environments (CI, piped input) - Shows progress while deleting entries Co-Authored-By: Claude Opus 4.5 <[email protected]> * docs: add API reference links to delete-all-devin-knowledge script Co-Authored-By: Claude Opus 4.5 <[email protected]> * fix: replace NOW() with CURRENT_TIMESTAMP in feature flag migration example Co-Authored-By: unknown <> * add -S * docs: consolidate agent documentation and add AI setup guide - Remove duplicated Project Structure & Tech Stack from agents/README.md - Condense Commands section in AGENTS.md, link to agents/commands.md - Add AI-Assisted Development section to root README.md explaining the agents/ folder structure and symlink configuration Co-Authored-By: Claude Opus 4.5 <[email protected]> * docs: remove incorrect CLAUDE.md symlink claim from README Co-Authored-By: unknown <> --------- Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: Claude Opus 4.5 <[email protected]>
1.7 KiB
1.7 KiB
Sections
This file defines all sections, their ordering, impact levels, and descriptions. The section ID (in parentheses) is the filename prefix used to group rules.
1. Architecture (architecture)
Impact: CRITICAL Description: Vertical Slice Architecture and Domain-Driven Design patterns that form the foundation of our codebase organization.
2. Code Quality (quality)
Impact: CRITICAL Description: Standards for maintaining high-quality, maintainable code including PR reviews, testing, and accountability.
3. Data Layer (data)
Impact: HIGH Description: Repository patterns, DTOs, and technology isolation to prevent coupling and enable maintainability.
4. API Design (api)
Impact: HIGH Description: Controller patterns, API stability, and proper separation of HTTP concerns from business logic.
5. Performance (performance)
Impact: HIGH Description: Algorithm complexity, data structure choices, and performance patterns for enterprise scale.
6. Testing (testing)
Impact: MEDIUM-HIGH Description: Test coverage requirements and testing strategies for maintaining code quality.
7. Design Patterns (patterns)
Impact: MEDIUM Description: Factory patterns, dependency injection, and other design patterns for clean, maintainable code.
8. Team Culture (culture)
Impact: MEDIUM Description: Engineering culture, accountability, and collaboration standards.
9. CI/CD (ci)
Impact: HIGH Description: Continuous integration practices, type checking priorities, and git workflow standards.
10. Reference (reference)
Impact: LOW Description: Informational lookups, file locations, and local development setup guides.