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.guide.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: Guide
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](adr-example.long.md) · **Guide**
## Example procedure
1. Define a schema beside the deployable entrypoint.
2. Select local files through the launcher or runtime; use platform-injected variables in production.
3. Parse once before constructing services.
4. Pass typed configuration through the composition root.
5. Test valid, missing, malformed, and redacted-error cases.
## Bun example
Bun can select one or more files with `--env-file` or disable automatic files with `--no-env-file`. Keep exact launch syntax in package scripts or deployment configuration, not in domain modules.
## Validation
```bash
pnpm test -- config
pnpm typecheck
```
## Source
- [Bun environment variables](https://bun.com/docs/runtime/environment-variables), verified 2026-07-28.
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 |