Skip to content

trombonet12/Rally-Copilot / .claude/skills/design-feature

design-feature

Verified

Diseñar una feature antes de implementarla (contratos, flujo de datos, impacto, plan de lotes); no registra decisiones (registrar-decision) ni revisa código (architecture-review).

FileKindSize
SKILL.mdskill md3.6 KB
---
name: design-feature
description: Diseñar una feature antes de implementarla (contratos, flujo de datos, impacto, plan de lotes); no registra decisiones (registrar-decision) ni revisa código (architecture-review).
allowed-tools: Read, Grep, Glob
---

# design-feature

Produce un diseño previo para la feature descrita en `$ARGUMENTS`, sin escribir código. Entrega: contratos, flujo de datos, impacto y plan de lotes delegables.

## Cuándo usarla
- Antes de implementar una feature que toca `app/` y `motor/`, el esquema Room, el servicio de ubicación, la voz o los datos offline.
- Antes de repartir trabajo en subagentes: el plan de lotes sale de aquí.

## Cuándo NO usarla
- Decisión técnica puntual que hay que registrar → usa `registrar-decision` (se invoca desde el paso 6).
- Revisar código ya escrito → usa `architecture-review`.
- Bugfix o cambio local sin contratos nuevos → impleméntalo directamente (`bugfix-flow`).

## Precondiciones
- `$ARGUMENTS` con la descripción de la feature; si falta, pedirla y parar.
- Haber leído `docs/ESTADO.md`, el hito activo de `ROADMAP.md`, `QUESTIONS.md`, `docs/arquitectura.md` (si existe) y `docs/DECISIONES.md`. La feature debe caber en el hito activo; si no, parar y avisar.

## Pasos
1. Acotar: objetivo, fuera de alcance, criterios de aceptación comprobables. Lo que sea **decisión de producto** (UI, comportamiento, alcance) no se inventa: va a `QUESTIONS.md` con opciones y recomendación.
2. Localizar código y contratos existentes (Grep/Glob) en `app/` y `motor/`. No suponer: citar archivo.
3. Contratos: modelos y funciones de `motor/` (geometría, notas, cronometraje, sectores, deltas, GPX/KML), entidades Room, interfaces de dominio. Indicar dueño y consumidores de cada uno.
4. Flujo de datos: offline por defecto; Room como persistencia de usuario; datos de mapas descargados desde la app; red solo para mapas e incidencias. Para la conducción: estado que sobrevive a pantalla apagada, segundo plano y muerte del proceso (foreground service de ubicación).
5. Impacto: hitos afectados, decisiones que contradice o que faltan, migraciones Room, tests críticos (TDD en notas, cronometraje, detección de tramos, deltas, parsing), permisos Android, batería y privacidad.
6. Si hay decisión estructural nueva, delegar en `registrar-decision`. Si el riesgo es alto, pedir `architecture-review` con un revisor [opus].
7. Plan de lotes con los límites de CLAUDE.md § Delegación: 1 objetivo, ≤ 5 archivos, 1 comando de validación, respuesta ≤ 15 líneas, modelo explícito. Paralelo solo con archivos disjuntos y **presupuesto simultáneo ≤ 2 puntos** (opus 1 · sonnet 0,5 · haiku 0,25). Los archivos reservados quedan para el agente principal.
8. Redactar cada lote con `docs/_templates/BRIEF.template.md` (skill `delegate-task`).

## Validaciones / tests
- Cada contrato tiene dueño, consumidor y test asociado.
- Ningún lote supera 5 archivos ni tiene dos comandos de validación.
- Los lotes paralelos no comparten archivos y respetan el presupuesto.

## Definition of Done
- [ ] Diseño con objetivo, contratos, flujo de datos, impacto y plan de lotes.
- [ ] Encaja en el hito activo y no contradice `docs/DECISIONES.md` (o propone registro).
- [ ] Dudas de producto apuntadas en `QUESTIONS.md`, no decididas.
- [ ] Riesgos listados; lo no verificable marcado `VERIFICAR`.
- [ ] Entregado en la respuesta (no se modifican archivos salvo petición).

## Docs a actualizar
- Hito en `ROADMAP.md` (si el diseño lo amplía) · `docs/DECISIONES.md` vía `registrar-decision` · `QUESTIONS.md` · docs/ESTADO.md (skill `session-handoff`)
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall