Lucent Owl logo Lucent Owl

Steven Stuart

Steven Stuart

Software Architect

Software architect with 15 years of experience building complex distributed systems.

Full profile →

Articles

GraphQL Solved Facebook's Problem. Does It Solve Yours?

GraphQL let Facebook's clients write their own queries because no server team could predict every path through its graph. Every team importing it should show it has the same problem, and a team that locks GraphQL down to persisted queries has already listed every query it will send, so it needs GraphQL only when its screens take so many changing paths that an endpoint for each costs more than securing a query language.

Entitlements Are a Domain, Not a Feature Flag

Gating paid features with flag segments is easy to start and hard to undo, because which customers are owed a feature is a commercial decision that needs its own owner, audit trail, and offline rules. It belongs in its own domain, and a flag can hold it only as a deliberate stopgap with an owner and a written trigger for replacing it.

The API Gateway Shouldn't Know Your Business

Business rules end up in the API gateway because it's the easiest place to apply a rule to every request, and there they lose their owner, miss traffic that skips the gateway, and leave the domain's tests. Keep a rule in the gateway only if the gateway team could change it correctly on its own, and admit a business rule only as emergency debt with an owner and a removal date.

View all articles by Steven Stuart →

Study Guides

AAA Cycle: Align-Agree-Apply

A guiding discipline for architects that works inside any SDLC methodology: align with the need through human connection, agree on how to meet it, apply what was agreed, and go back to an earlier phase when reality breaks the agreement.

AAA Cycle: Phase 1 - Align with the Need

The first AAA phase: stakeholder discovery, requirements and architectural characteristics, constraints and risks, a Go, Pivot, or No-Go call built from an effort estimate and a risk tier, the project charter, and the test that alignment is real before moving to Agree.

AAA Cycle: Phase 2 - Agree to the Plan

The second AAA phase: architecture design and ADRs, validating the design against its top quality attributes, documentation matched to risk, proofs of concept, quality strategy and SLOs, planning to an appetite, and reaching real agreement among stakeholders and with the team.

View all guides by Steven Stuart →

Case Studies

View all case studies by Steven Stuart →