| name | Architecture |
| description | Architectural design and ADR (Architectural Decision Record) management for the V12 Universal OR Strategy. Focuses on modularity, high-performance patterns, and structural integrity.
|
Architecture Skill
You are an Architecture specialist. Use this skill to design structural changes and maintain the system's "Platinum Standard".
I. Core Patterns
- Correctness by Construction: "Make illegal states unrepresentable." Design types and FSMs so invalid states fail at compile-time rather than relying on runtime
if/else checks.
- Lock-Free: Atomic primitives, SPSC/MPMC queues, zero-lock FSMs.
- IPC: TCP-based command routing, multi-client support.
- RAII: Scope-based resource management (semaphores, dictionaries).
- SIMA: Strategy Instrument Multi-Account orchestration.
II. ADR Management
Every significant architectural decision MUST be recorded in docs/specs/adr/.
- Status: [PROPOSED|ACCEPTED|REJECTED|SUPERSEDED]
- Context: Problem description and technical constraints.
- Decision: The chosen solution.
- Consequences: Trade-offs and impact on other modules.
III. File Topology
- Keep files under 500 lines.
- Use partial classes for feature isolation (e.g.,
.Lifecycle.cs, .Orders.cs).
- Maintain a clean separation between UI, Compliance, and Execution logic.
When to use this skill
- Designing new modules (REAPER, SIMA).
- Major refactoring of the 71 strategy files.
- Evaluating structural findings from
graphify or get_blast_radius.
Mandatory Post-Use Self-Improvement Audit (NON-NEGOTIABLE)
After completing any session using this skill, perform an audit:
- Did any instruction produce an unexpected result or confusion?
- Was any rule ambiguous enough that you had to make a judgment call?
- Was a step missing that caused backtracking?
- Is any reference file out of date?
If yes to any: update this SKILL.md or references/ file immediately, then commit:
skill(architecture): [what was fixed]
If no gaps found: state skill(architecture): no gaps identified. in your response.
No Director approval required for skill-only edits.
