architecture-collaboration

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?"