avgarcia/runcriticon / .claude/skills/frontend-feature-dev
frontend-feature-dev
VerifiedScaffold de una feature Angular nueva (componente standalone OnPush, servicio Signals, ruta lazy, tests Jest y Playwright+axe-core) ajustada a ADR-0001 y ADR-0012. Usar al crear cualquier pantalla, sección o feature nueva del frontend de Runcriticon.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| referencias/api-client.md | markdown | 5.2 KB |
| referencias/arquitectura.md | markdown | 2.9 KB |
| referencias/componentes.md | markdown | 4.7 KB |
| referencias/convenciones.md | markdown | 3.1 KB |
| referencias/testing.md | markdown | 4.6 KB |
referencias/convenciones.md
View on GitHub# Convenciones del frontend — Runcriticon
Fuente: ADR-0001 D4, ADR-0012 D4/D5/D9, `frontend/CLAUDE.md`, `docs/glosario.md`
## Prefijo de selectores
Todos los componentes usan el prefijo `rc`:
```typescript
@Component({ selector: 'rc-grupos', ... })
@Component({ selector: 'rc-plan-semanal', ... })
@Component({ selector: 'rc-vista-hoy', ... })
```
Configurado en `eslint.config.js` como regla obligatoria.
## Lenguaje ubicuo — español
Los nombres de dominio van en **español** en todo el código: componentes, rutas, servicios, señales, propiedades. El glosario autoritativo es `docs/glosario.md`.
Términos clave del dominio (ejemplos representativos):
| Término español | Nunca usar |
|-----------------|-----------|
| `alumno` | student, athlete, runner |
| `entrenador` | coach, trainer |
| `sesion` | session, workout, training |
| `plan` | plan (OK), schedule |
| `tag` | tag (permitido — está en el glosario así) |
Tabla completa de equivalencias → skill `glosario-guardian`. Fuente canónica → `docs/glosario.md`.
Permitidos en inglés: identificadores técnicos (nombres de librerías, métodos HTTP, siglas como `HTTP`, `API`, `WCAG`, `CSRF`).
## Rutas URL
En kebab-case español:
```typescript
'/grupos'
'/plan-semanal'
'/vista-hoy'
'/gestion-alumnos'
```
## TypeScript strict (ADR-0001 D4)
- `strict: true` en `tsconfig.json` — activado globalmente.
- `strictTemplates: true` en `tsconfig.app.json` — type-checking en templates HTML.
- Cero `any` injustificados. Si se necesita, comentar por qué.
- `definite assignment assertion` (`!`) aceptable puntualmente en propiedades inyectadas.
## ESLint (flat config, ESLint 9)
Reglas clave:
```javascript
'@typescript-eslint/no-explicit-any': 'error'
'@angular-eslint/component-selector': ['error', { prefix: 'rc', style: 'kebab-case' }]
'@angular-eslint/use-component-change-detection': 'error' // OnPush obligatorio
```
Ejecutar antes de cada commit: `npm run lint`.
## Prettier
Configuración en `.prettierrc.json`:
```json
{
"printWidth": 100,
"singleQuote": true,
"trailingComma": "all",
"semi": true
}
```
## Componentes standalone (ADR-0001 D5)
- Siempre `standalone: true` — nunca `NgModule` en código propio.
- Cada componente declara sus propios `imports[]` explícitamente.
- No hay barrel de imports centralizado.
## i18n — $localize (ADR-0012 D9)
- MVP en castellano únicamente.
- Todos los textos visibles marcados con `i18n` attribute o `$localize` template tag.
- No se usa `@ngx-translate` en MVP.
```html
<h1 i18n>Mis grupos</h1>
<p i18n>No hay sesiones registradas esta semana.</p>
```
```typescript
const mensaje = $localize`Bienvenido, ${nombre}`;
```
## Un solo paradigma de estilos (ADR-0012 D5, revisión 2026-07)
- Solo spartan.ng (helm copiados en `src/app/ui/` + `@spartan-ng/brain`) + **utilidades Tailwind v4 en el template**.
- **No añadir Angular Material** ni otra librería de componentes o utilidades.
- SCSS/hoja de estilos por componente solo cuando una utilidad no llega (justificado en el PR).
- `::ng-deep` prohibido salvo en casos justificados y documentados.
- Utilities y tokens propios en `src/styles.css` (`@theme`), con criterio (no clases preventivas).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |