What format are the generated records in?

The skill uses the MADR (Markdown Architectural Decision Records) format, which is a lean, standardized template for capturing decisions in version control.

Is a PRD necessary to use this skill?

While having a Product Requirements Document (PRD) is recommended for better context, the skill can derive most architectural decisions directly from the code structure and dependencies.

How does this skill identify architectural choices?

The skill analyzes project entry points, dependency manifests (like package.json), configuration files, and directory patterns to infer which frameworks, libraries, and design patterns are currently in use.

Does it support existing ADRs?

Yes, it includes a Conflict Analysis phase that scans existing ADRs to determine if new decisions should supersede, extend, or relate to existing documentation.

What is an Architecture Decision Record (ADR)?

An ADR is a document that captures an important architectural decision made along with its context and consequences. It helps teams understand the 'why' behind the current state of a system.

Blueprint ADR Generator

Name: Blueprint ADR Generator
Author: laurigates

bylaurigates

•

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

Automatically derives and documents architectural decisions by analyzing existing project codebases, dependencies, and structures.

The Blueprint ADR Generator is a specialized Claude Code skill that automates the creation of Architecture Decision Records (ADRs) for existing projects. By performing deep analysis of directory structures, package manifests, and configuration files, it reconstructs the implicit reasoning behind framework choices, state management, and deployment strategies. It features a robust conflict-analysis engine that detects overlaps with existing documentation, ensuring architectural consistency through bidirectional linking and automated manifest updates, making it an essential tool for onboarding and technical debt management.

主な機能

01Automatic manifest synchronization and document indexing

0210 GitHub stars

03Automated discovery of architectural patterns from source code

04Bidirectional relationship tracking for ADR versioning

05Intelligent conflict analysis and superseding of legacy decisions

06Standardized MADR-compliant template generation

ユースケース

01Onboarding developers to legacy projects by documenting implicit architecture

02Ensuring consistency in decision-making across large-scale distributed systems

03Formalizing technical debt and architectural shifts during major refactors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins blueprint-derive-adr

For use in Claude.ai and ChatGPT

Download Skill