CommunityProgramación y desarrollogithub.com

Investigar primero

Diagnostica fallos ambiguos antes de editar. Úsalo para causas desconocidas, comportamiento intermitente, regresiones de rendimiento o investigaciones que necesiten hipótesis clasificadas por evidencia.

¿Qué es Investigar primero?

Esta habilidad transforma el enfoque de depuración de un desarrollador al priorizar la recopilación de evidencia antes de cualquier modificación del código. Es ideal para fallos con causa desconocida, problemas intermitentes, regresiones de rendimiento o cualquier investigación compleja donde la causa raíz no es obvia. La habilidad guía al agente (como Claude Code, Cursor, Codex, etc.) a separar el síntoma observado de la causa inferida, rastrear entradas, transiciones de estado, límites de propiedad y salidas de error. Luego clasifica hipótesis por la cantidad de evidencia que las respalda y su valor de falsación económica, y detiene la exploración cuando la evidencia es suficiente para nombrar la causa o el bloqueador exacto. No permite editar el código hasta que se haya identificado un mecanismo creíble que explique la evidencia. Finalmente, reporta la causa y la prueba, sin realizar ninguna corrección a menos que la tarea lo autorice explícitamente. Es compatible con múltiples plataformas de agentes de IA y se basa en el archivo SKILL.md para su configuración.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuliusBrussee/caveman/tree/main/skills/investigate-first

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Investigar primero?

Recopila evidencia antes de modificar el código del producto.

  • Separa el síntoma observado de la causa inferida.
  • Rastrea entradas, transiciones de estado, límites de propiedad y salida de error.
  • Clasifica las hipótesis por evidencia y valor de falsación económica.
  • No edites hasta que un mecanismo creíble explique la evidencia.
  • Detén la exploración cuando la evidencia sea suficiente para nombrar la causa o el bloqueador exacto.

Reporta la causa y la prueba. No realices ninguna corrección a menos que la tarea autorice la implementación.

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

JuliusBrussee/caveman-discover

Find and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover workflows" or breaking LLM spend down by workflow.

JuliusBrussee/caveman-evidence-review

Read-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Caveman found or where LLM spend goes.

JuliusBrussee/caveman-explore

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

JuliusBrussee/caveman-learn

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

JuliusBrussee/caveman-manage

Inspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a Caveman experiment.

JuliusBrussee/caveman-optimize

Turn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or evaluate a Caveman optimization report. Needs explicit approval.

JuliusBrussee/caveman-setup

Wire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or adding LLM spend observability.

JuliusBrussee/lean-build

Build feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope, and an explicit stop condition matter.

JuliusBrussee/migration

Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

JuliusBrussee/safe-refactor

Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits.

JuliusBrussee/surgical-patch

Fix bugs and small behavior changes at the narrowest responsible layer. Use when regression proof, preserved surrounding behavior, and task-relevant tests matter.

JuliusBrussee/verify-and-stop

Prove existing work meets acceptance conditions without expanding scope. Use for validation-only tasks, completion checks, focused gate runs, and last-mile proof.

Skills relacionados