investigate
Installation
SKILL.md
Investigate Live
Input
- A live or deployed app, environment, host, service, incident, symptom, alert, or user-reported production issue.
- Use explicit input first; otherwise infer from context, logs, alerts, selected files, or branch.
- Safest default: identify environment, host/platform, timeframe, and symptom before running commands.
Workflow
- Define symptom. Capture what is broken, when it started, who is affected, and what changed recently.
- Map targets. Identify platform, environment, host/service names, deploy version, domains, databases, queues, and dependencies.
- Gather read-only evidence. Check health endpoints, logs, metrics, recent deploys, config, resource usage, errors, and dependency status.
- Form hypotheses. List likely causes and test one at a time.
- Use bounded commands. Prefer targeted commands with timeouts and limited output; avoid dumping secrets or huge logs.
- Recommend fix path. Separate immediate mitigation, root-cause fix, rollback, and follow-up hardening.
- Document findings. Update the relevant
docs/development/*.mdfile if the investigation reveals missing developer or operator knowledge.