stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/architecture-compass
architecture-compass
VerifiedSet up ADR governance, audit architecture and drift, or plan and execute bounded refactors and code simplification. Use when work needs binding architecture decisions, library reuse, shared-code ownership, provider-to-local mapping, or architecture PR review.
assets/adr-template.long.md
View on GitHub# ADR-NNNN: <title>
> Derived, non-normative asset. The applicable canonical Long ADRs prevail if this template conflicts or drifts.
ID: ADR-NNNN
Title: <title>
Status: Proposed
Date: YYYY-MM-DD
Owner: <owner>
Scope: repository
Category: <category>
Tags: <comma-separated tags>
Applies when: <trigger>
Adoptable: false
Variant: Long
Canonical variant: Long
Supersedes: none
Superseded by: none
Guide verified: YYYY-MM-DD
Gist: <one-sentence outcome>
Target-repository adoption note: allocate the target's native ID, owner, status, scope, category, tags, and links. Remove provider-only `Adoptable` metadata and `AC-ADR` identity unless the target convention defines equivalent fields; keep provider provenance in the mapping or non-normative Guide. Provider acceptance never makes this target ADR accepted.
Variants: [Short](NNNN-slug.short.md) · **Long, canonical** · [Guide](NNNN-slug.guide.md)
## Context
<Problem, forces, current evidence, and decision boundary.>
## Decision
<One durable architectural decision.>
## Invariants
- <required property>
- <failure or conflict behavior>
## Alternatives
- Chosen: <option and reason>
- Rejected: <option and reason>
## Consequences
- Benefit: <outcome>
- Tradeoff: <cost>
- Risk: <risk and mitigation>
## Acceptance
- <observable evidence that the decision is applied>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |