skills.rest
jwilger
jwilgerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architecture-collaboration

Create Architectural Decision Records collaboratively with IDE diff modifications.

8|3|Updated Sep 7, 2025
Search Tags:#architecture#software engineering#decision making#collaboration#system design#adr#architectural decision records
One-click install
npx skills add https://github.com/jwilger/claude-code-setup --skill architecture-collaboration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-collaboration
Source: https://github.com/jwilger/claude-code-setup/tree/main/skills/architecture-collaboration
Command: npx skills add https://github.com/jwilger/claude-code-setup --skill architecture-collaboration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms architectural decision-making into a collaborative, transparent, and user-driven process. It guides you through creating Architectural Decision Records (ADRs), ensuring that every choice is thoroughly analyzed, alternatives are considered, and you retain final authority. This prevents architectural drift and ensures a well-documented, coherent system design.

Core Features & Use Cases

  • Collaborative ADR Creation: Co-create each section of an ADR (Context, Decision, Rationale, Consequences, Alternatives) with the AI using IDE diff modification, ensuring your direct input and ownership.
  • Alternatives Analysis: The AI presents and analyzes multiple architectural options, empowering you to make informed decisions based on your priorities.
  • Memento Integration: Automatically record all architectural decisions, rationales, and relationships (e.g., "supersedes", "depends_on") in a knowledge graph for persistent, searchable memory.
  • Use Case: Document critical architectural decisions through a collaborative process, ensuring all trade-offs are considered, alternatives analyzed, and the user retains final authority over the system's design.

Quick Start

Initiate collaborative ADR creation for a new architectural decision.

The AI will propose the Context section based on your project's needs.

You will review and modify it directly via your IDE.

Example interaction:

AI proposes: "Context: The system needs to handle concurrent updates to shared resources."

User adds: "QUESTION: What's the expected concurrency level? Are we talking 10s, 100s, or 1000s of concurrent users?"