architecture-research

Evaluate technology options and document decisions with Architecture Decision Records.

4|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/flight505/claude-project-planner --skill architecture-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-research
Source: https://github.com/flight505/claude-project-planner/tree/main/project_planner/.claude/skills/architecture-research
Command: npx skills add https://github.com/flight505/claude-project-planner --skill architecture-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to systematically research technology options, compare architectures, and document decisions with Architecture Decision Records (ADRs) to reduce risk and align stakeholders.

Core Features & Use Cases

  • ADRs: Create Architecture Decision Records with context, drivers, options, rationale, and consequences.
  • Technology Research: Evaluate stacks, patterns, and cloud options using documented sources.
  • C4 & Diagrams: Generate system diagrams (C4 Context/Container/Component) to communicate architecture decisions.
  • Best Practices & Templates: Use ADR templates, decision checklists, and research templates to capture evidence.
  • Use Case: When selecting a tech stack for a new service, run an ADR-driven study comparing PostgreSQL vs. Cassandra, monolith vs. microservices, and include deployment considerations.

Quick Start

Use the architecture-research skill to start an ADR-driven evaluation. Begin by outlining the context and decision drivers, then document options and evidence, and finally generate C4 diagrams to communicate the decision.

Frequently Asked Questions about architecture-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Architecture Decision Record to document a tech stack choice?

To create an Architecture Decision Record, outline the context and decision drivers, document technology options with evidence, and capture rationale and consequences using structured ADR templates to ensure governance and traceability.

What is the best way to compare technology options for system architecture?

The best way to compare technology options for system architecture is applying an ADR-driven evaluation that gathers context, researches documented sources, and provides evidence-backed comparisons to reduce risk and align stakeholders.

How do I generate C4 diagrams to communicate architecture decisions?

You generate C4 diagrams to communicate architecture decisions by documenting the system context, containers, and components after evaluating technology options, ensuring visual alignment across technical and non-technical stakeholders.

When do I need an ADR for evaluating design patterns and cloud technologies?

You need an ADR for evaluating design patterns and cloud technologies when selecting a stack for a new service, ensuring systematic research, evidence-backed comparisons, and deployment considerations are captured for governance and traceability.

Does this approach support comparing monolith vs microservices architectures?

Yes, this approach supports comparing monolith vs microservices architectures by running an ADR-driven study that evaluates deployment considerations, documents context and drivers, and provides evidence-backed comparisons for technology selection.

How do I structure technology research to align stakeholders on architecture decisions?

Structure technology research by applying systematic evaluation across context gathering, design-pattern evaluation, and documented sources, producing evidence-backed comparisons and ADRs to reduce risk and align stakeholders on architecture decisions.