What documentation formats does it support?

It is optimized for Markdown-based documentation common in modern repositories, including docs/decisions/ and docs/architecture/ directories.

Does this skill actually look at my source code?

Yes, when a question requires implementation context, it examines the codebase to verify how architectural patterns are applied in practice.

Can I use this for developer onboarding?

Absolutely. It is specifically designed to help new team members explore the architecture and understand the 'why' behind the codebase independently.

How does arch-query find answers to my questions?

It searches through your project's ADRs, architecture documents, proposals, and CLAUDE.md files to synthesize a coherent response based on your natural language query.

Does it provide references for the information it gives?

Yes, every claim made by the skill includes specific citations to the source documents, such as ADR-001 or specific architecture markdown files.

Architecture Query

Name: Architecture Query
Author: alexnodeland

byalexnodeland

•

Aprendizaje y Documentación

Provides interactive, context-aware answers to natural-language questions about a project's architecture and decision history.

Architecture Query is a specialized skill for developers and architects that facilitates seamless navigation through complex system designs by cross-referencing Architectural Decision Records (ADRs), internal proposals, and live codebase structures. It simplifies technical discovery and onboarding by synthesizing information from disparate documentation sources and providing cited evidence for every architectural claim, ensuring that teams remain aligned with established design principles and governance rules without manual searching.

Características Principales

01Cross-referencing across ADRs, documentation, and source code

02Verifiable citations linking every answer to specific source documents

03Automated identification of module governance and dependency rules

04Historical context retrieval for past technical trade-offs and decisions

053 GitHub stars

06Natural language processing for complex architectural inquiries

Casos de Uso

01Onboarding new developers by explaining the rationale behind specific architectural patterns

02Reviewing architectural compliance and governance rules during system refactoring

03Investigating the historical context and alternative solutions considered in past technical decisions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled arch-query

For use in Claude.ai and ChatGPT

Download Skill