Forked from psavelis/must_have_engineering_skills.json
Created
April 7, 2026 14:46
-
-
Save gabrielle-lima/e3c78343df3b5fb3ae34253d73daf353 to your computer and use it in GitHub Desktop.
Sumary of must have knowledge required for top engineering roles
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| { | |
| "title": "Knowledge Framework for Senior-to-Staff Engineer+ Roles", | |
| "overview": "This is the definitive, complete, and non-negotiable body of knowledge required for true Staff Engineer and Principal-level roles. Every topic has been significantly augmented with deeper strategic depth, elevated language reflecting org-wide leadership impact, expanded key_competencies (now 5 per topic), and a new consistent field 'org_impact' that explicitly articulates the business and platform-level outcomes expected at this level. The framework is now fully self-contained, exhaustive, and calibrated for large-scale, AI-augmented, globally distributed systems where Staff+ engineers set the technical bar across the entire organization.", | |
| "requirements": [ | |
| { | |
| "topic": "SOLID + GRASP", | |
| "key_focus": "true responsibility assignment at scale", | |
| "staff_level_mastery": "At Staff+ level, engineers demonstrate instinctive, org-wide mastery of SOLID principles (SRP, OCP, LSP, ISP, DIP) combined with all nine GRASP patterns. They define, evolve, and enforce responsibility boundaries that remain crystal-clear across codebases spanning tens of millions of lines and hundreds of autonomous teams, while actively mentoring senior and staff engineers and preventing architectural erosion even as AI agents continuously inject new logic at extreme velocity.", | |
| "key_competencies": [ | |
| "Instinctively apply SOLID + GRASP in multi-million-line codebases", | |
| "Design responsibility models that survive hundreds of contributors and AI agents", | |
| "Mentor and audit teams to eliminate responsibility leakage", | |
| "Establish org-wide patterns for true separation of concerns at scale", | |
| "Lead cross-team responsibility audits and boundary refactoring initiatives" | |
| ], | |
| "org_impact": "Creates maintainable, evolvable platforms that scale to hundreds of teams without architectural decay, dramatically reducing onboarding time and technical debt accumulation.", | |
| "reference": "Applying UML and Patterns by Craig Larman (GRASP) + Robert C. Martin SOLID principles" | |
| }, | |
| { | |
| "topic": "Object Calisthenics + Clean Code", | |
| "key_focus": "so agents don’t create unmaintainable trash", | |
| "staff_level_mastery": "At Staff+ level, engineers internalize and enforce the complete set of Object Calisthenics rules together with Clean Code practices as non-negotiable org standards. They ruthlessly refactor — including all AI-generated output — and establish automated guardrails so the entire platform remains readable, testable, and evolvable at massive scale, even when hundreds of agents continuously modify the codebase.", | |
| "key_competencies": [ | |
| "Enforce full Object Calisthenics as org standard", | |
| "Build automated linting and review pipelines for AI-generated code", | |
| "Ruthlessly refactor any violation at platform scale", | |
| "Mentor seniors on writing maintainable code under high velocity", | |
| "Define and evolve code-quality SLAs used across the entire engineering organization" | |
| ], | |
| "org_impact": "Eliminates unmaintainable code at source, enabling sustained high-velocity development and preventing engineering productivity collapse at scale.", | |
| "reference": "The ThoughtWorks Anthology (Object Calisthenics by Jeff Bay) + Clean Code by Robert C. Martin" | |
| }, | |
| { | |
| "topic": "GoF Patterns", | |
| "key_focus": "know exactly when to use or ruthlessly reject them", | |
| "staff_level_mastery": "At Staff+ level, engineers possess deep fluency with the 23 Gang of Four patterns and the judgment to apply or reject them with surgical precision. They define when a pattern adds accidental complexity versus genuine value and teach senior engineers how to achieve pattern intent through simpler, modern language features without cargo-culting classic implementations.", | |
| "key_competencies": [ | |
| "Evaluate every pattern for real value vs accidental complexity", | |
| "Implement pattern intent with minimal code using modern language features", | |
| "Create org-wide guidance on pattern usage and rejection criteria", | |
| "Mentor teams to avoid pattern abuse in AI-augmented code", | |
| "Lead pattern-review gates for major platform initiatives" | |
| ], | |
| "org_impact": "Prevents pattern cargo-culting and accidental complexity, resulting in cleaner, more maintainable architectures that scale reliably.", | |
| "reference": "Design Patterns: Elements of Reusable Object-Oriented Software by Gamma, Helm, Johnson, Vlissides (Gang of Four)" | |
| }, | |
| { | |
| "topic": "D.R.Y. + K.I.S.S. + Y.A.G.N.I.", | |
| "key_focus": "balanced with zero mercy", | |
| "staff_level_mastery": "At Staff+ level, engineers apply DRY, KISS, and YAGNI with extreme precision and zero tolerance for dogma, continuously re-evaluating trade-offs across the entire system lifecycle. They establish org-wide decision frameworks that senior and staff engineers follow, knowing exactly when controlled duplication or added complexity serves long-term business velocity.", | |
| "key_competencies": [ | |
| "Make precise, context-aware trade-off decisions on duplication and simplicity", | |
| "Define org-wide decision rubrics for DRY/KISS/YAGNI", | |
| "Continuously audit systems for dogmatic application of the principles", | |
| "Balance short-term velocity with long-term maintainability at scale", | |
| "Teach senior engineers strategic application of these principles in complex domains" | |
| ], | |
| "org_impact": "Delivers optimal balance between delivery speed and long-term sustainability, directly influencing engineering velocity and cost efficiency at enterprise scale.", | |
| "reference": "The Pragmatic Programmer by Hunt and Thomas (DRY)" | |
| }, | |
| { | |
| "topic": "Domain-Driven Design", | |
| "key_focus": "strategic + context mapping", | |
| "staff_level_mastery": "At Staff+ level, engineers operate at full strategic DDD maturity: they define and evolve Bounded Contexts, sophisticated Context Maps, Core/Supporting/Generic domain classification, and explicit Ubiquitous Language across polyglot, multi-team organizations. They align enterprise architecture with business reality at global scale and mentor other staff engineers on strategic modeling.", | |
| "key_competencies": [ | |
| "Lead strategic DDD modeling across multiple business domains", | |
| "Design and maintain sophisticated Context Maps at enterprise scale", | |
| "Establish and evolve Ubiquitous Language across polyglot teams", | |
| "Mentor other staff engineers on DDD application", | |
| "Drive alignment between technical and business strategy through DDD artifacts" | |
| ], | |
| "org_impact": "Ensures architecture remains tightly aligned with business strategy, reducing translation gaps and enabling faster, more accurate feature delivery at scale.", | |
| "reference": "Domain-Driven Design: Tackling Complexity in the Heart of Software by Eric Evans (Blue Book)" | |
| }, | |
| { | |
| "topic": "Hexagonal / Clean Architecture", | |
| "key_focus": "agents must plug in layers independently", | |
| "staff_level_mastery": "At Staff+ level, engineers design and enforce Ports & Adapters (Hexagonal), Onion, or Clean Architecture as the default org pattern. They guarantee complete isolation of the domain from infrastructure and AI agents, enabling seamless swapping, parallel execution, and independent testing/replacement of every layer across hundreds of services.", | |
| "key_competencies": [ | |
| "Enforce domain isolation as the default org architecture", | |
| "Design pluggable layers for AI agents and infrastructure", | |
| "Enable independent testing, swapping, and evolution of layers", | |
| "Create org-wide reference implementations and guardrails", | |
| "Lead architecture migrations to Hexagonal/Clean patterns at platform scale" | |
| ], | |
| "org_impact": "Creates future-proof platforms where any layer (including AI components) can be replaced without ripple effects, dramatically improving agility and reducing risk.", | |
| "reference": "https://alistair.cockburn.us/hexagonal-architecture (original) + Clean Architecture by Robert C. Martin" | |
| }, | |
| { | |
| "topic": "Deep Algorithms, Data Structures & Performance at Scale", | |
| "key_focus": "performance at scale", | |
| "staff_level_mastery": "At Staff+ level, engineers maintain expert command of advanced data structures (B-trees, LSM-trees, skip lists, bloom filters, CRDTs, etc.) and algorithms across graph, string, numerical, and distributed domains. They drive sub-millisecond latency and sub-linear cost scaling while making deliberate, data-driven trade-offs between compute, memory, storage, and developer velocity at planetary scale.", | |
| "key_competencies": [ | |
| "Select and optimize advanced data structures for global scale", | |
| "Drive performance from sub-millisecond to sub-linear cost", | |
| "Make data-driven trade-offs across compute, memory, and cost", | |
| "Mentor teams on performance-critical design decisions", | |
| "Lead performance engineering initiatives that impact millions of users and billions in revenue" | |
| ], | |
| "org_impact": "Delivers massive cost savings and superior user experience through optimized systems that scale efficiently with business growth.", | |
| "reference": "Designing Data-Intensive Applications by Martin Kleppmann" | |
| }, | |
| { | |
| "topic": "Distributed Systems Mastery", | |
| "key_focus": "CAP, consensus, sharding, consistency models", | |
| "staff_level_mastery": "At Staff+ level, engineers command the CAP theorem, consensus algorithms (Raft, Paxos, Zab), sharding strategies, replication topologies, failure models, and every consistency guarantee (strong, eventual, causal, linearizable). They design and evolve globally distributed systems that predictably survive partition, latency, and node failure while defining org-wide resilience standards.", | |
| "key_competencies": [ | |
| "Design fault-tolerant systems under CAP constraints", | |
| "Choose and implement appropriate consensus and consistency models", | |
| "Define org-wide sharding and replication strategies", | |
| "Establish resilience standards used across all teams", | |
| "Lead incident post-mortems and resilience improvements at platform level" | |
| ], | |
| "org_impact": "Builds highly available, globally scalable systems that maintain predictable behavior under failure, protecting revenue and user trust at enterprise scale.", | |
| "reference": "Designing Data-Intensive Applications by Martin Kleppmann" | |
| }, | |
| { | |
| "topic": "Event-Driven + CQRS + Event Sourcing + Saga Patterns", | |
| "key_focus": "orchestration and choreography at enterprise scale", | |
| "staff_level_mastery": "At Staff+ level, engineers architect enterprise-scale processes using Event-Driven Architecture, CQRS, Event Sourcing, and both Orchestration and Choreography Sagas. They guarantee idempotency, out-of-order event handling, temporal queries, and reliable compensation across hundreds of services and AI agents while establishing these patterns as org defaults.", | |
| "key_competencies": [ | |
| "Design reliable event-driven systems at enterprise scale", | |
| "Implement CQRS + Event Sourcing with full temporal and compensation guarantees", | |
| "Choose between orchestration and choreography sagas strategically", | |
| "Set org-wide standards for event-driven patterns", | |
| "Lead complex saga and event-sourcing implementations that span business domains" | |
| ], | |
| "org_impact": "Enables loosely-coupled, highly scalable business processes that evolve independently while maintaining strong consistency guarantees.", | |
| "reference": "Greg Young - CQRS Documents and talks" | |
| }, | |
| { | |
| "topic": "Observability & Resilience", | |
| "key_focus": "OpenTelemetry, tracing, chaos engineering", | |
| "staff_level_mastery": "At Staff+ level, engineers treat full-stack observability as a first-class architectural concern: they implement OpenTelemetry (traces, metrics, logs, baggage), SLOs, error budgets, and chaos engineering at org scale. They design systems that self-recover from any failure mode without human intervention and mentor other staff engineers on resilience strategies.", | |
| "key_competencies": [ | |
| "Design and enforce full OpenTelemetry observability at platform scale", | |
| "Implement SLOs, error budgets, and chaos engineering as standard", | |
| "Build self-healing systems with zero human intervention", | |
| "Mentor staff engineers on advanced resilience patterns", | |
| "Define and track org-wide observability and resilience KPIs" | |
| ], | |
| "org_impact": "Creates self-healing, observable platforms that minimize downtime and accelerate mean-time-to-resolution across the entire organization.", | |
| "reference": "OpenTelemetry official documentation + Chaos Engineering practices (Netflix)" | |
| }, | |
| { | |
| "topic": "Secure-by-Design + Zero-Trust Architecture", | |
| "key_focus": "security as a non-functional requirement", | |
| "staff_level_mastery": "At Staff+ level, engineers embed security into every architectural layer: least privilege, zero-trust networking, immutable infrastructure, threat modeling, and continuous validation. They assume breach by default (including compromised AI agents) and define org-wide secure-by-design standards that all senior and staff engineers follow.", | |
| "key_competencies": [ | |
| "Embed zero-trust and secure-by-design in every layer", | |
| "Assume breach for all components including AI agents", | |
| "Define and enforce org-wide secure architecture standards", | |
| "Integrate continuous threat modeling and validation", | |
| "Lead security architecture reviews for critical platform components" | |
| ], | |
| "org_impact": "Establishes unbreakable security posture that protects the organization from breaches while enabling rapid innovation.", | |
| "reference": "NIST SP 800-207 Zero Trust Architecture" | |
| }, | |
| { | |
| "topic": "Agent Reliability Engineering", | |
| "key_focus": "building guardrails, deterministic pipelines around probabilistic agents, and critical review of AI-generated code", | |
| "staff_level_mastery": "At Staff+ level, engineers design deterministic guardrails, verification pipelines, human-in-the-loop gates, and automated rollback mechanisms around probabilistic AI agents. They treat AI-generated code with the same (or higher) rigor as human code, enforcing static analysis, property-based testing, and formal verification while establishing these practices as org-wide standards.", | |
| "key_competencies": [ | |
| "Build deterministic pipelines around probabilistic AI agents", | |
| "Design guardrails, review gates, and automated rollbacks", | |
| "Enforce formal verification and property-based testing on AI output", | |
| "Establish org-wide Agent Reliability Engineering standards", | |
| "Lead the creation of AI reliability frameworks adopted across all product teams" | |
| ], | |
| "org_impact": "Enables safe, high-velocity use of AI agents at massive scale without compromising reliability, quality, or security.", | |
| "reference": "Emerging practice in AI-augmented software engineering" | |
| }, | |
| { | |
| "topic": "Systems Thinking & Trade-off Mastery", | |
| "key_focus": "cost (FinOps/token economics), political, reliability, and AI-specific decisions", | |
| "staff_level_mastery": "At Staff+ level, engineers evaluate every decision across financial (FinOps/token economics), political (stakeholder alignment), reliability, and AI-specific dimensions (latency vs accuracy, determinism vs creativity). They consistently make optimal holistic trade-offs for the business and teach senior and staff engineers how to navigate these multi-dimensional decisions at enterprise scale.", | |
| "key_competencies": [ | |
| "Perform multi-dimensional trade-off analysis (cost, political, reliability, AI-specific)", | |
| "Master FinOps and token economics at platform scale", | |
| "Align technical decisions with organizational incentives", | |
| "Teach holistic systems thinking to other staff engineers", | |
| "Drive executive-level technical trade-off discussions and recommendations" | |
| ], | |
| "org_impact": "Ensures every architectural decision maximizes business value across multiple competing dimensions, directly impacting profitability and strategic execution.", | |
| "reference": "Systems Thinking literature (e.g., Thinking in Systems by Donella Meadows)" | |
| }, | |
| { | |
| "topic": "Leadership Without Authority", | |
| "key_focus": "RFC-driven vision, cross-team influence, org-wide guardrails", | |
| "staff_level_mastery": "At Staff+ level, engineers drive technical direction through high-impact RFCs, influence without direct reports, establish and maintain org-wide engineering guardrails, and build consensus across autonomous teams and business units. They translate executive strategy into concrete technical vision and mentor other staff engineers on influence and alignment.", | |
| "key_competencies": [ | |
| "Drive org-wide technical vision through RFCs", | |
| "Influence and align autonomous teams without authority", | |
| "Establish and maintain cross-org engineering guardrails", | |
| "Mentor staff engineers on leadership and consensus building", | |
| "Shape company-wide engineering culture and technical standards" | |
| ], | |
| "org_impact": "Creates aligned, high-performing engineering organizations that execute complex initiatives without relying on hierarchy.", | |
| "reference": "Staff Engineer: Leadership beyond the management track by Will Larson" | |
| }, | |
| { | |
| "topic": "Agents Handle Syntax and Velocity", | |
| "key_focus": "humans focus on judgment, architecture, and strategic trade-offs", | |
| "staff_level_mastery": "At Staff+ level, engineers leverage AI agents as high-velocity force-multipliers for syntax, boilerplate, and routine work while retaining absolute ownership of system design, architectural decisions, strategic direction, and final quality gates. They define the judgment layer that no AI can replicate and set org-wide standards for human-AI collaboration at scale.", | |
| "key_competencies": [ | |
| "Orchestrate AI agents as high-velocity multipliers", | |
| "Retain full ownership of architecture and strategic decisions", | |
| "Define the irreplaceable human judgment layer", | |
| "Set org-wide standards for human-AI collaboration", | |
| "Lead the evolution of human-AI engineering workflows at enterprise scale" | |
| ], | |
| "org_impact": "Multiplies engineering output by 5-10x while preserving architectural excellence and strategic control, giving the organization a decisive competitive advantage.", | |
| "reference": "Emerging practice in AI-assisted software engineering" | |
| } | |
| ] | |
| } |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment