ApertureOscillation

Analyzes one design question at component and system zoom levels to surface scope mismatches.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/ruban-s/DevOS --skill apertureoscillation-ruban-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ApertureOscillation
Source: https://github.com/ruban-s/DevOS/tree/main/skills/ApertureOscillation
Command: npx skills add https://github.com/ruban-s/DevOS --skill apertureoscillation-ruban-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design decisions made from a single framing often fail: a component that looks right in isolation clashes with the system around it, or a plan loyal to the big picture ignores what the part actually needs. This Skill resolves one design question twice — once component-first, once system-first — then names every divergence so scope mismatches and sizing errors surface before requirements freeze or an approach locks. ## Core Features & Use Cases - Three-pass scope sweep: Resolves the same question at close-up (part-first), pulled-back (whole-first), and synthesis zoom levels, producing a gap read no single framing yields. - Structured tension report: Outputs enumerated divergences, a resolution sketch per divergence, design tensions, criteria implications, and an ALIGNED or DIVERGENT coherence verdict. - Use Case: Before building a retry wrapper around a flaky vendor API, run the sweep to discover the platform already has a shared queue with dead-letter handling — the gap read recommends expressing backoff as queue options instead of a parallel delivery system. ## Quick Start Use aperture oscillation on this design decision: the build target is X and the surrounding intent is Y — give me the close-up view, the system view, and the gap read.

Frequently Asked Questions about ApertureOscillation

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

FAQPage Schema
How do I check if a design decision fits both the component and the system?▼

Run an aperture oscillation: resolve the same question once with the component as the focus and once with the system as the focus, then compare the two answers. Every point where they diverge becomes a named tension with a resolution sketch and a coherence verdict.

What is the difference between ApertureOscillation and IterativeDepth?▼

IterativeDepth rotates the analytical angle across 2-8 passes to map a problem from many sides, while ApertureOscillation shifts only the viewing distance in exactly three passes. Use IterativeDepth first to chart the problem, then ApertureOscillation to seat the solution in its system.

When should I use scope oscillation in a planning workflow?▼

Use it before requirements freeze or before an approach locks, when a concrete piece must serve both itself and a larger system. Typical triggers include sizing calls, feature shaping, coherence review of additions to live infrastructure, and scope arbitration.

What inputs does an aperture oscillation analysis require?▼

It requires two genuinely different inputs: a build target (the concrete thing under design) and a surrounding intent (the purpose or system it serves). If both collapse into one sentence at the same scale, there is no scope delta to expose and IterativeDepth is the better fit.

What are the limitations of the two-zoom scope analysis?▼

The sweep is fixed at exactly three passes; a fourth pass becomes lens rotation, which belongs to IterativeDepth. It also cannot run when target and intent are identical, and it does not invent alternatives — it only exposes frictions between the two framings.