The Archivist FAQs

Question 1

What is The Archivist Claude Code Skill?

Accepted Answer

The Archivist is a specialized extension for Claude Code designed to capture the 'why' behind engineering decisions. It enforces documentation of architectural trade-offs, technology selections, and design patterns to ensure institutional knowledge is preserved.

Question 2

What types of documentation does The Archivist generate?

Accepted Answer

The skill uses a tiered framework: Tier 1 for local inline comments, Tier 2 for brief decision logs (DECISIONS.md), and Tier 3 for comprehensive, MADR-inspired Architecture Decision Records (ADRs) for major system changes.

Question 3

When should I use The Archivist during development?

Accepted Answer

Use this skill whenever you face a choice between multiple implementation paths, such as selecting a database, adding a new library, or deviating from an established coding pattern. It helps document the rationale before the context is lost.

Question 4

Does The Archivist help identify when documentation is missing?

Accepted Answer

Yes. The skill includes automated triggers and detection questions that monitor for significant architectural shifts, security-related choices, and performance trade-offs, prompting you to document them immediately.

Question 5

How does this skill improve my engineering workflow?

Accepted Answer

It reduces future technical debt and onboarding time by creating a searchable history of decisions. Instead of guessing why a specific architecture was chosen, future maintainers can refer to structured records generated at the time of implementation.

The Archivist

The Archivist

主な機能

ユースケース

主な機能

ユースケース