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-example.long.md
View on GitHub# ADR-0007: Resolve configuration at the deployable boundary
> Derived, non-normative asset. The applicable canonical Long ADRs prevail if this example conflicts or drifts.
ID: ADR-0007
Title: Resolve configuration at the deployable boundary
Status: Accepted
Date: 2026-07-28
Owner: example-team
Scope: repository
Category: runtime-platform
Tags: configuration, environment, bootstrap
Applies when: A deployable process reads environment-backed configuration.
Adoptable: false
Variant: Long
Canonical variant: Long
Supersedes: none
Superseded by: none
Guide verified: 2026-07-28
Gist: Select environment before bootstrap and parse resolved configuration once.
Variants: [Short](adr-example.short.md) · **Long, canonical** · [Guide](adr-example.guide.md)
## Context
Environment selection and configuration parsing become ambiguous when services load files or read global variables independently. Tests then need process-global mutation and deployments can select conflicting inputs.
## Decision
The process launcher, runtime, or deployment platform owns environment selection before application bootstrap. The deployable app owns one boundary parser that validates resolved input and creates typed immutable configuration. Bootstrap injects that configuration; domain, service, route, and shared modules do not load environment files or read scattered environment variables.
## Invariants
- Selection completes before runtime construction.
- One deployable owns one parsing boundary and redacts sensitive validation failures.
- Shared packages accept typed values and remain environment-source agnostic.
## Alternatives
- Chosen: launcher selection plus deployable-local parsing.
- Rejected: each module reads globals, because ownership and tests become implicit.
- Rejected: shared package loads dotenv, because it couples reusable code to one deployment model.
## Consequences
- Benefit: deterministic configuration ownership and test seams.
- Tradeoff: launch commands must state local environment selection explicitly.
- Risk: bypasses need static checks or review until automated enforcement exists.
## Acceptance
- A test can construct the runtime from typed config without mutating process environment.
- Production can run from injected variables without loading a repository file.
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 |