APEX

APEX = Analyze → Plan → Execute → eXamine

APEX = Analyze → Plan → Execute → eXamine

APEX est la méthodologie SmartStack de développement incrémental. C'est un orchestrateur qui coordonne la génération de code via les skills existants (/controller, /application, /ui-components, /efcore) et les outils MCP.

APEX is the SmartStack incremental development methodology. It is an orchestrator that coordinates code generation through existing skills (/controller, /application, /ui-components, /efcore) and MCP tools.

Démarrage Rapide

Quick Start

/apex add absence management to HR module           # Add section
/apex -a fix the leave request controller            # Auto fix
/apex -a -x -s -pr add PDF export to Orders          # Full workflow
/apex -e add status field to Project entity          # Economy (no agents)
/apex -r                                             # Resume previous
/apex -d .ralph/prd.json                             # Delegate mode (from ralph-loop)

Drapeaux

Flags

Architecture: 9 Étapes

Architecture: 9 Steps

43 POST-CHECKs (Étape 04)

43 POST-CHECKs (Step 04)

Validation automatisée couvrant:

Automated validation covering:

• Conventions namespace, usage BaseEntity, ITenantEntity
• Namespace conventions, BaseEntity usage, ITenantEntity
• Filtrage TenantId dans les services (clause de garde obligatoire)
• TenantId filtering in services (guard clause mandatory)
• [RequirePermission] sur contrôleurs (pas seulement [Authorize])
• [RequirePermission] on controllers (not just [Authorize])
• Routes chemin complet, permissions en kebab-case
• Full-path routes, kebab-case permissions
• Complétude données seed (navigation, permissions, rôles, traductions)
• Seed data completeness (navigation, permissions, roles, translations)
• Idempotence traductions (gardes AnyAsync)
• Translation idempotency (AnyAsync guards)
• Sécurité données seed FK (requête IDs réels de DB)
• FK seed data safety (query actual IDs from DB)
• Frontend: i18n 4 langues, pas imports statiques en routes, pas couleurs en dur
• Frontend: i18n 4 languages, no static imports in routes, no hardcoded colors
• Pas de modaux pour formulaires, pages create/edit existent, fichiers test existent
• No modals for forms, create/edit pages exist, test files exist
• EntityLookup pour champs FK, param search sur GetAll
• EntityLookup for FK fields, search param on GetAll
• Complétude sous-ressources, onglets page détail état local
• Sub-resource completeness, detail page tabs local state

Gestion des Erreurs

Error Handling

Critères de Succès

Success Criteria

Mode Délégué (ralph-loop)

Delegate Mode (ralph-loop)

Quand ralph-loop invoque APEX avec `-d .ralph/prd.json`, APEX lit le contexte PRD et exécute le workflow complet en mode autonome.

When ralph-loop invokes APEX with `-d .ralph/prd.json`, APEX reads PRD context and executes the full workflow in autonomous mode.

{
  "version": "1.0",
  "metadata": {
    "name": "Feature Name",
    "domain": "module-path",
    "category": "feature|bugfix|refactor"
  },
  "context": {
    "domain": {...},
    "infrastructure": {...},
    "application": {...},
    "api": {...},
    "seedData": {...},
    "frontend": {...}
  },
  "tasks": [
    {
      "id": "entity",
      "category": "domain",
      "status": "pending",
      "completed_at": null,
      "commit_hash": null,
      "files_changed": []
    }
  ]
}

APEX met à jour `task.status`, `completed_at`, `commit_hash`, et `files_changed` au fur et à mesure. Ralph lit le fichier PRD mis à jour après que APEX retourne.

APEX updates `task.status`, `completed_at`, `commit_hash`, and `files_changed` as it progresses. Ralph reads the updated PRD file after APEX returns.

Points d'Intégration

Integration Points

APEX intègre:

APEX integrates:

Référence

Reference

templates/skills/apex/