Skills de Claude Code para NetSuite

Un agente de código generalista escribe JavaScript generalista. Apuntalo a una extensión de SuiteCommerce Advanced y va a producir algo que parece correcto, usa ES6, ignora los límites de governance y falla al desplegar.

Esta es la corrección: una carpeta .claude/ que soltás en cualquier proyecto NetSuite para que el agente arranque con las restricciones ya cargadas.

Qué codifica

Cuatro skills cubren el trabajo que hago realmente. Extensiones de SuiteCommerce Advanced, hasta las convenciones de Backbone, la superficie de componentes de la Extensibility API, la arquitectura de checkout y el manifest.json. SuiteScript 2.x en los seis tipos de script, con patrones de autenticación de RESTlets y plantillas de código. Despliegue con SDF vía el CLI de suitecloud y XML de objetos. Y estimación, que es menos sobre código que sobre convertir un pedido difuso en un número defendible.

Cada skill trae archivos de referencia en capas en vez de un solo prompt largo, así el agente levanta el documento de arquitectura de checkout solo cuando está trabajando en checkout.

Por qué aguanta

La parte útil no es la documentación, son los anti-patrones: pares curados de antes/después que muestran la respuesta verosímil al lado de la que sobrevive en una cuenta real. El estilo ES5-only y los presupuestos de governance están escritos como restricciones y no como sugerencias, que es la diferencia entre código generado que compila y código generado que se puede desplegar.

La configuración es por placeholders ([vendor-prefix], nombres de proyecto), y una convención de project-notes.md separa las reglas durables del estado propio de cada ambiente para que no se pudran juntas. Un script sync-claude empuja el set de skills más nuevo a todos los proyectos de una.

El repositorio es privado por ahora. Se escribió como plantilla genérica desde el principio, así que una versión pública y limpia es el paso obvio.

Tecnología

• Skills de Claude Code: una carpeta .claude/ con una skill por dominio, cada una con archivos de referencia en capas que el agente carga a demanda en vez de un único prompt largo.
• SuiteScript 2.x, SuiteCommerce Advanced y SDF como materia: plantillas por tipo de script, patrones de autenticación para RESTlets, convenciones de Backbone y de la Extensibility API, despliegue con la CLI suitecloud y XML de objetos.
• Pares de anti-patrones antes/después como recurso central de enseñanza, con estilo solo ES5 y presupuestos de gobernanza planteados como restricciones duras.
• Shell: un script sync-claude que empuja el set de skills más nuevo a todos los proyectos de una, y configuración por placeholders para que el mismo pack sirva para cualquier prefijo de vendor.