architecture-compass

Set up or refactor code to adhere to Architecture Decision Records.

4|1|Updated May 19, 2026

Search Tags:#architecture #coding standards #code refactoring #ADR #repository governance

Ready to run

npx skills add https://github.com/stark-ai-de/agent-skills --skill architecture-compass-stark-ai-de

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-compass
Source: https://github.com/stark-ai-de/agent-skills/tree/main/skills/engineering-workflows/architecture-compass
Command: npx skills add https://github.com/stark-ai-de/agent-skills --skill architecture-compass-stark-ai-de

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps establish and enforce architectural governance by setting up ADRs (Architecture Decision Records) or refactoring repositories to adhere to existing ADRs and patterns.

Core Features & Use Cases

ADR Setup: Install durable ADR guardrails for future agent instructions and code adherence.
Code Refactoring: Align code, diffs, or new implementations with existing ADRs and examples.
Use Case: For a repository starting a new project, use this Skill to define and install ADRs, ensuring all future code changes follow the established guidelines.

Quick Start

Use the architecture-compass skill to set up ADR guardrails for your new repository.

Frequently Asked Questions about architecture-compass

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

FAQPage Schema

How do I enforce architecture decision records in my repository?▼

Refactoring code to align with established architecture patterns involves evaluating existing diffs against ADR definitions. This Skill applies repository governance rules to restructure implementations, ensuring ongoing maintenance strictly follows the documented architectural decisions.

What is the best way to set up architecture governance for a new project?▼

To begin applying architecture guidelines, you need existing ADR definitions and architecture patterns established in your repository. This Skill uses those inputs to execute code refactoring, repository setup, and maintenance tasks that enforce structural governance.

Can I use this to refactor code to match existing ADRs?▼

This Skill does not generate the initial ADR definitions; it requires existing architecture guidelines and ADRs as input prerequisites. It functions by applying and enforcing those predefined architecture patterns during code refactoring and repository setup.

Why do I need architecture decision records for code refactoring?▼

No, this Skill does not generate the initial ADR definitions; it requires existing architecture guidelines and ADRs as input prerequisites. It functions by applying and enforcing those predefined architecture patterns during code refactoring and repository setup.

Does this work for repository setup and ongoing maintenance?▼

Yes, this Skill applies to both initial repository setup and ongoing maintenance tasks. It installs ADR guardrails during setup and continuously enforces architecture patterns during subsequent code refactoring to maintain long-term repository governance.