architecture-lookup

vperreard's avatarfrom vperreard

Use this skill when exploring codebase architecture or planning new features requiring models/enums.AUTO-ACTIVATE when user mentions (FR/EN): - modèle, model, models, enum, enums, schema, Prisma schema - architecture, domain, domaine, existe, exists, available, disponible - créer, create, ajouter, add, nouveau, new, nouvelle feature - quel modèle, what model, which model,quel enum - 121 modèles, 87 enums, Planning, Leave, Business RulesThis skill provides INSTANT lookup (500 tokens vs 15k for full ERD) for 121 models and 87 enums.

⭐0stars🔀0forks📁View on GitHub🕐Updated Nov 25, 2025

When & Why to Use This Skill

This Claude skill provides an optimized architecture index for rapid codebase exploration and feature planning. It enables instant lookup of over 120 models and 90 enums across multiple domains (Planning, Business Rules, Leave Management), significantly reducing token consumption (500 vs 15k tokens) compared to full ERD analysis. It is designed to help developers maintain architectural consistency while maximizing context window efficiency.

Use Cases

  • Codebase Exploration: Quickly identify existing models and enums when navigating a complex architecture without loading heavy documentation.
  • Feature Planning: Verify if a specific data entity or business rule already exists before implementing new functionality to avoid redundancy.
  • Schema Reference: Access a categorized list of Prisma schemas and domain-specific enums for consistent data modeling and PascalCase compliance.
  • Token Optimization: Perform high-level architectural checks using minimal context window space, preserving tokens for complex logic and coding tasks.
namearchitecture-lookup
description>

Architecture Index - Quick Reference

Token Efficiency: 500 tokens vs 15k for full ERD Last Update: 27 October 2025

Quick Stats

  • 129 models across 10 domains
  • 91 enums categorized
  • 26 modules organized
  • PascalCase convention (Oct 2025 migration)

Models by Domain

Planning & Scheduling (28 models)

  • Core: Assignment, BlocDayPlanning, PlanningJob
  • V2: PlanningV2Assignment, PlanningV2Conflict
  • Templates: TrameModele, AffectationModele, PersonnelRequisModele
  • Legacy: TrameAffectation, RegularAssignment, PlanningSession

Business Rules (22 models)

  • Phase 2 BDD (6 types - Oct 2025):
    • ContinuityRule (rest after guards)
    • EquityRuleV2 (fair distribution)
    • InterSectorRule (cross-sector rules)
    • MaxHoursRule, MinRestRule, SkillMatchingRule
  • Legacy: EquityRule, SupervisionRule

Leave Management (12 models)

  • Core: PlannedAbsence, LeaveBalance, LeaveTypeSetting
  • Quota: QuotaCarryOver, QuotaTransfer
  • Legacy: Absence

Site & Infrastructure (8 models)

  • Site, OperatingRoom, OperatingSector
  • Department, Location, ActivityType

User & Auth (11 models)

  • User, Personnel, RefreshToken, LoginLog
  • Skill, UserSkill, WorkContract
  • ApprovalRequest

Enums by Category

Assignment & Planning

  • AssignmentType: GARDE, ASTREINTE, BLOC_PROGRAMME, CONSULTATION, REPOS, CONGE
  • AssignmentStatus: PENDING, CONFIRMED, CANCELLED, COMPLETED
  • Period: MATIN, APRES_MIDI, NUIT, JOURNEE, GARDE_24H

Leave Management

  • LeaveType: CP, RTT, FORMATION, MALADIE, CONGE_PARENTAL, MATERNITE, PATERNITE
  • LeaveStatus: PENDING, APPROVED, REJECTED, CANCELLED

Professional Roles

  • ProfessionalRole: MAR, IADE, CHIRURGIEN, CADRE, ADMINISTRATIF

Business Rules

  • RuleType: CONTINUITY, EQUITY, SUPERVISION, MAX_HOURS, MIN_REST, SKILL_MATCHING
  • RulePriority: CRITICAL, HIGH, MEDIUM, LOW

Decision Tree

New feature requested
  ↓
1. Check models by domain (this file - 500 tokens)
  ↓
2. Model exists in category?
   YES → Read specific ERD section (~200 tokens)
   NO  → Continue
  ↓
3. Enum exists?
   YES → Reuse
   NO  → Justify new creation
  ↓
4. Check DONT_DO.md if complex pattern

Progressive Resources

For complete listings:

  • resources/models-by-domain.md - All 121 models with details
  • resources/enums-reference.md - All 87 enums with values

Reference: ARCHITECTURE_INDEX.md, ENTITY_RELATIONSHIP_DIAGRAM.md Last Update: 27 October 2025