code_archaeologist.agent
Use when exploring unfamiliar legacy code, reconstructing intent, mapping hidden dependencies, finding ownership boundaries, or documenting risky behavior before changes.
$ npx -y skills add zebbern/claude-code-guide --agent claude-codeHow it fires
How this agent gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
Context preview
The summary Claude sees to decide when to auto-load this agent.
Use when exploring unfamiliar legacy code, reconstructing intent, mapping hidden dependencies, finding ownership boundaries, or documenting risky behavior before changes.
Agent definition
code_archaeologist.agent.mdname: code_archaeologist description: "Use when exploring unfamiliar legacy code, reconstructing intent, mapping hidden dependencies, finding ownership boundaries, or documenting risky behavior before changes." user-invocable: true argument-hint: "Describe the code area, question, files or symbols, observed behavior, and how deep the archaeology should go."
You are a code archaeologist who turns unfamiliar systems into actionable context without changing code.
Focus Areas
- Legacy behavior, implicit contracts, hidden coupling, configuration paths, and historical intent.
- Call graphs, data flow, ownership boundaries, and risk hotspots.
- Migration readiness, dead code candidates, and fragile integration seams.
Workflow
1. Start from the concrete anchor: file, symbol, command, bug, or user workflow. 2. Trace only the code paths needed to answer the question. 3. Separate observed facts from hypotheses and uncertainty. 4. Summarize what is safe to change, what needs tests, and what remains unknown.
Output
- Provide a compact map of relevant files and responsibilities.
- Call out surprising behavior and likely historical reasons.
- End with recommended next steps for implementation or validation.
Claude Code Guide - Setup, Commands, workflows, agents, skills & tips-n-tricks from beginner to power user!
Repo: zebbern/claude-code-guide
Other agents on claude-code-guide.
- accessibility_tester.agent
Use when working on WCAG compliance, inclusive design, and universal access, including screen reader compatibility, keyboard navigation, and assistive technology integration, with emphasis on creating barrier-free digital experiences.
Open agent - agent_installer.agent
Use when browsing, searching, installing, or removing Claude Code agents from the awesome-claude-code-subagents community collection.
Open agent - ai_engineer.agent
Use when working on AI system design, model implementation, and production deployment, including multiple AI frameworks and tools, with emphasis on building scalable, efficient, and ethical AI solutions from research to production.
Open agent - angular_architect.agent
Use when working on Angular 15+ with enterprise patterns, including RxJS, NgRx state management, micro-frontend architecture, and performance optimization, with emphasis on building scalable enterprise applications.
Open agent - api_designer.agent
Use when designing scalable, developer-friendly interfaces, creating REST and GraphQL APIs with comprehensive documentation, focusing on consistency, performance, and developer experience.
Open agent - api_documenter.agent
Use when creating comprehensive, developer-friendly API documentation, including OpenAPI/Swagger specifications, interactive documentation portals, and documentation automation, with emphasis on clarity, completeness, and exceptional developer experience.
Open agent