Why are validation gates mandatory in this workflow?

Validation gates use independent subagents to verify findings, ensuring the documentation is consistent, follows the contract, and avoids the common pitfalls of rushed AI analysis.

What kind of deliverables can I expect?

Depending on your choice, you can get high-level C4 diagrams, comprehensive subsystem catalogs, quality assessments, and architect-ready handover reports.

Can it handle undocumented legacy code?

Absolutely. It is designed specifically for 'archaeology'—uncovering the structure and logic of systems where documentation is missing or outdated.

What is the System Archaeologist skill for Claude Code?

It is a specialized skill that coordinates AI agents to systematically explore and document the architecture of existing codebases, producing diagrams and catalogs.

Does this skill work for large repositories?

Yes, it includes a parallel orchestration strategy specifically for systems with over 20,000 lines of code or more than five independent subsystems.

System Archaeologist

Name: System Archaeologist
Author: tachyon-beep

bytachyon-beep

•

学習とドキュメンテーション

Generates comprehensive architecture documentation and C4 diagrams for existing codebases using coordinated subagent exploration and quality gates.

System Archaeologist is a rigorous framework for Claude Code designed to map and document complex or unfamiliar codebases. It moves beyond simple file reading by establishing a mandatory workspace, employing a deliverable-based menu for varied stakeholder needs, and orchestrating subagents for parallel exploration of large systems. By enforcing strict validation gates and subagent handoffs, it ensures that architectural assessments, subsystem catalogs, and C4 diagrams are accurate, consistent, and pressure-resistant, making it ideal for legacy system discovery and refactoring planning.

主な機能

01Subagent orchestration for parallel analysis of large codebases

02Automated C4 diagram and subsystem catalog generation

035 GitHub stars

04Mandatory validation gates using independent validator agents

05Structured workspace management for analysis artifacts

06Multi-tier deliverable menu (Quick Overview to Full Architect-Ready)

ユースケース

01Generating architecture documentation for legacy systems with no existing records

02Performing technical debt assessments and refactoring planning for complex software

03Onboarding developers to large-scale projects by mapping dependencies and subsystems

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tachyon-beep/skillpacks using-system-archaeologist

For use in Claude.ai and ChatGPT

Download Skill