@forwardimpact/map 0.11.0

package/examples/questions/capabilities/scale.yaml

@@ -0,0 +1,104 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/capability-questions.schema.json
+
+professionalQuestions:
+  working:
+    - id: scl_pro_work_decomp_1
+      text:
+        Your API currently handles 100 requests per second but needs to handle
+        1000 RPS in 6 months due to a new partnership. How would you approach
+        this?
+      context:
+        The API is a monolithic Node.js application backed by PostgreSQL.
+        Response time P99 is currently 200ms and must stay under 500ms.
+      decompositionPrompts:
+        - What would you need to measure and understand first?
+        - How would you identify the scaling bottlenecks?
+        - What architectural changes would you consider?
+        - How would you phase the work and validate progress?
+      lookingFor:
+        - Profiles current system before jumping to solutions
+        - Considers horizontal vs vertical scaling trade-offs
+        - Identifies database as likely bottleneck
+        - Plans incremental validation with load testing
+      expectedDurationMinutes: 15
+      followUps:
+        - What if the partnership deal accelerated and you had only 3 months?
+        - How would you handle if the new load had very different access
+          patterns?
+
+  practitioner:
+    - id: scl_pro_pract_decomp_1
+      text:
+        Your team maintains a data pipeline that processes events from multiple
+        sources. It's becoming increasingly difficult to add new sources. How
+        would you redesign it?
+      context:
+        Currently there are 15 event sources, each with custom integration code.
+        Adding a new source takes 3 weeks. The team receives requests for 5 new
+        sources per quarter.
+      decompositionPrompts:
+        - How would you analyze the current pain points systematically?
+        - What abstractions or patterns would improve extensibility?
+        - How would you migrate existing sources without disruption?
+        - How would you measure the success of the redesign?
+      lookingFor:
+        - Identifies common patterns across existing integrations
+        - Proposes schema standardization or adapter pattern
+        - Plans migration that doesn't break existing functionality
+        - Sets concrete targets for new source onboarding time
+      expectedDurationMinutes: 15
+      followUps:
+        - What if different sources had fundamentally incompatible data models?
+        - How would you get buy-in if the team is skeptical of a major rewrite?
+
+managementQuestions:
+  working:
+    - id: scl_mgmt_work_decomp_1
+      text:
+        Your team is responsible for a system that needs to scale significantly,
+        but you don't have dedicated infrastructure expertise. How would you
+        build this capability?
+      context:
+        The system needs to 10x in capacity over the next year. Your team of 6
+        engineers has strong application development skills but limited
+        infrastructure and performance engineering experience.
+      decompositionPrompts:
+        - How would you assess your team's current capabilities and gaps?
+        - What strategy would you use to build the needed expertise?
+        - How would you manage the risk during the scaling effort?
+        - How would you balance learning with delivery commitments?
+      lookingFor:
+        - Honestly assesses capability gaps without blame
+        - Considers multiple approaches (hire, train, partner, outsource)
+        - Creates risk mitigation plan for capability building period
+        - Protects learning time while meeting business needs
+      expectedDurationMinutes: 15
+      followUps:
+        - What if you can't hire and must develop expertise internally?
+        - How would you handle if early scaling efforts fail?
+
+  practitioner:
+    - id: scl_mgmt_pract_decomp_1
+      text:
+        Your organization's infrastructure costs have grown faster than revenue,
+        and leadership wants a 30% cost reduction while maintaining performance.
+        How would you approach this?
+      context:
+        Current cloud spend is $2M annually across 15 teams. Some services are
+        over-provisioned, others have inefficient architectures. Teams have
+        autonomy over their infrastructure but no accountability for costs.
+      decompositionPrompts:
+        - How would you analyze current spend and identify opportunities?
+        - What governance changes would you propose?
+        - How would you drive cost consciousness across teams?
+        - How would you ensure cost reduction doesn't impact performance?
+      lookingFor:
+        - Creates visibility into costs at service and team level
+        - Proposes accountability model while respecting team autonomy
+        - Identifies both quick wins and architectural improvements
+        - Establishes guardrails to prevent performance regression
+      expectedDurationMinutes: 15
+      followUps:
+        - What if teams push back on cost accountability?
+        - How would you handle if major cost savings require significant
+          refactoring?

package/examples/questions/skills/architecture_design.yaml

@@ -0,0 +1,115 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/skill-questions.schema.json
+
+professionalQuestions:
+  awareness:
+    - id: arch_pro_aware_1
+      text:
+        How do you decide where to draw boundaries when structuring new code?
+      lookingFor:
+        - Thinks about grouping related functionality together
+        - Considers how changes in one area might affect others
+        - Shows awareness that structure choices affect future maintainability
+      expectedDurationMinutes: 5
+  foundational:
+    - id: arch_pro_found_1
+      text: How do you decide on the structure when building a new feature?
+      followUps:
+        - What alternatives would you consider?
+        - How would AI tools change your approach to structuring code?
+      lookingFor:
+        - Considers multiple structural options before choosing
+        - Explains reasoning behind design decisions clearly
+        - Applies familiar patterns appropriately to new problems
+      expectedDurationMinutes: 5
+  working:
+    - id: arch_pro_work_1
+      text:
+        How do you approach designing a system when requirements involve
+        competing constraints?
+      followUps:
+        - How do you validate architectural decisions before committing?
+        - How would AI tools help you explore design alternatives?
+      lookingFor:
+        - Articulates trade-offs clearly with rationale for each choice
+        - Designs independently, seeking feedback at appropriate points
+        - Considers operational concerns alongside functional requirements
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: arch_pro_pract_1
+      text:
+        How do you guide your team through significant architectural decisions
+        where opinions conflict?
+      followUps:
+        - How do you balance technical purity with delivery pragmatism?
+        - How is AI changing the way your team evaluates architecture?
+      lookingFor:
+        - Facilitates decision-making that includes diverse perspectives
+        - Builds consensus without suppressing valid dissent
+        - Documents decisions and rationale for future reference
+      expectedDurationMinutes: 8
+  expert:
+    - id: arch_pro_expert_1
+      text:
+        How do you define and evolve architectural standards across a large
+        organization?
+      followUps:
+        - How do AI tools change your approach to architectural governance?
+      lookingFor:
+        - Creates standards that enable teams rather than constrain them
+        - Evolves architecture strategy as technology landscape changes
+        - Influences architectural direction across organizational boundaries
+      expectedDurationMinutes: 10
+
+managementQuestions:
+  awareness:
+    - id: arch_mgmt_aware_1
+      text: How do you recognize when your team needs architectural guidance?
+      lookingFor:
+        - Notices signals of architectural strain like coupling or tech debt
+        - Understands when to involve senior engineers in design decisions
+        - Connects architecture quality to team delivery outcomes
+      expectedDurationMinutes: 5
+  foundational:
+    - id: arch_mgmt_found_1
+      text: How do you support your team in making good architectural decisions?
+      followUps:
+        - What resources or guidance do you provide?
+      lookingFor:
+        - Enables team decision-making rather than dictating solutions
+        - Provides appropriate guardrails without micromanaging
+        - Connects teams with relevant expertise when needed
+      expectedDurationMinutes: 5
+  working:
+    - id: arch_mgmt_work_1
+      text:
+        How do you balance technical debt management with feature delivery in
+        your team?
+      followUps:
+        - How do you communicate architectural trade-offs to stakeholders?
+      lookingFor:
+        - Uses a clear framework to prioritize debt vs features
+        - Communicates trade-offs in business terms stakeholders understand
+        - Ensures the team has capacity for both maintenance and delivery
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: arch_mgmt_pract_1
+      text:
+        How do you drive architectural alignment across multiple teams in your
+        area?
+      followUps:
+        - How do you handle conflicts between team approaches?
+      lookingFor:
+        - Creates alignment through shared principles, not mandates
+        - Resolves architectural conflicts by surfacing underlying trade-offs
+        - Thinks strategically about technical direction across teams
+      expectedDurationMinutes: 8
+  expert:
+    - id: arch_mgmt_expert_1
+      text: How do you shape architectural strategy at the organizational level?
+      followUps:
+        - How do you ensure architectural strategy keeps pace with AI advances?
+      lookingFor:
+        - Defines architectural vision that aligns business and technical goals
+        - Influences technical direction across organizational boundaries
+        - Adapts strategy as technology landscape evolves
+      expectedDurationMinutes: 10

package/examples/questions/skills/cloud_platforms.yaml

@@ -0,0 +1,105 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/skill-questions.schema.json
+
+professionalQuestions:
+  awareness:
+    - id: cp_pro_aware_1
+      text: How do you decide what should run locally vs in the cloud?
+      lookingFor:
+        - Thinks about trade-offs between local and cloud deployment
+        - Shows awareness that cloud introduces operational considerations
+        - Recognizes cost, latency, and scalability as factors
+      expectedDurationMinutes: 5
+  foundational:
+    - id: cp_pro_found_1
+      text: How would you choose which cloud services to use for a new project?
+      lookingFor:
+        - Considers project requirements before picking services
+        - Weighs managed services against self-hosted options
+        - Thinks about cost and operational overhead
+      expectedDurationMinutes: 5
+  working:
+    - id: cp_pro_work_1
+      text:
+        Describe a cloud architecture you've designed. What services did you use
+        and why?
+      followUps:
+        - How did you handle cost optimization?
+      lookingFor:
+        - Explains service selection rationale tied to specific requirements
+        - Considers cost optimization alongside functionality
+        - Designs with operational concerns like monitoring and scaling
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: cp_pro_pract_1
+      text:
+        How would you design a multi-region, highly available architecture for a
+        critical application?
+      followUps:
+        - What about disaster recovery?
+        - How would AI-driven workloads change your architecture?
+      lookingFor:
+        - Designs for resilience across availability zones and regions
+        - Balances high availability with cost constraints
+        - Plans for failure scenarios and recovery procedures
+      expectedDurationMinutes: 10
+  expert:
+    - id: cp_pro_expert_1
+      text:
+        What are the key considerations when defining cloud governance and
+        strategy for a large organization?
+      lookingFor:
+        - Balances governance with team autonomy in cloud usage
+        - Considers compliance, security, and cost at organizational scale
+        - Shapes cloud strategy that adapts to emerging AI infrastructure needs
+      expectedDurationMinutes: 10
+
+managementQuestions:
+  awareness:
+    - id: cp_mgmt_aware_1
+      text:
+        How do you stay informed about cloud capabilities that could benefit
+        your team?
+      lookingFor:
+        - Actively explores cloud capabilities relevant to team work
+        - Evaluates new services for practical team benefit
+        - Shares learnings with the team proactively
+      expectedDurationMinutes: 5
+  foundational:
+    - id: cp_mgmt_found_1
+      text: How do you support team members in developing cloud platform skills?
+      lookingFor:
+        - Creates structured learning paths for cloud skills
+        - Pairs team members on cloud tasks for knowledge transfer
+        - Identifies skill gaps and addresses them proactively
+      expectedDurationMinutes: 5
+  working:
+    - id: cp_mgmt_work_1
+      text:
+        How do you balance cloud costs with team productivity and delivery
+        needs?
+      followUps:
+        - How do you communicate cloud spending to stakeholders?
+      lookingFor:
+        - Tracks cloud spending and communicates trends to stakeholders
+        - Makes trade-off decisions between cost and developer productivity
+        - Establishes team practices for cost-aware cloud usage
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: cp_mgmt_pract_1
+      text:
+        How do you drive cloud best practices and standards across your team?
+      followUps:
+        - How do you handle compliance requirements?
+      lookingFor:
+        - Establishes cloud standards that teams follow willingly
+        - Addresses compliance requirements with practical solutions
+        - Mentors team members on cloud best practices
+      expectedDurationMinutes: 10
+  expert:
+    - id: cp_mgmt_expert_1
+      text: How do you shape organizational cloud strategy and governance?
+      lookingFor:
+        - Defines cloud governance that enables innovation within guardrails
+        - Influences cloud direction across organizational boundaries
+        - Adapts strategy for emerging workloads like AI/ML infrastructure
+      expectedDurationMinutes: 10

package/examples/questions/skills/code_quality.yaml

@@ -0,0 +1,162 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/skill-questions.schema.json
+
+professionalQuestions:
+  awareness:
+    - id: cq_pro_aware_1
+      text:
+        How do you ensure the next person who reads your code understands it?
+      lookingFor:
+        - Thinks about readability from another developer's perspective
+        - Uses naming and structure to communicate intent
+        - Shows awareness that code is read more often than written
+      expectedDurationMinutes: 5
+  foundational:
+    - id: cq_pro_found_1
+      text: How do you ensure the code you write is readable by others?
+      followUps:
+        - What naming conventions do you follow?
+        - How do you decide when to add comments?
+      lookingFor:
+        - Uses consistent naming and structure that communicates intent to
+          readers
+        - Formats code for scanability and groups related logic together
+        - Writes comments that explain why, not what
+      expectedDurationMinutes: 5
+    - id: cq_pro_found_2
+      text: What testing practices do you follow when writing code?
+      lookingFor:
+        - Writes tests as part of development, not as an afterthought
+        - Understands the purpose of testing beyond just coverage numbers
+      expectedDurationMinutes: 5
+  working:
+    - id: cq_pro_work_1
+      text: How do you approach code review? What do you look for?
+      lookingFor:
+        - Follows a systematic approach covering correctness, clarity, and
+          design
+        - Balances thoroughness with keeping reviews timely
+        - Gives constructive feedback that helps the author improve
+      expectedDurationMinutes: 8
+    - id: cq_pro_work_2
+      text: How do you decide what to test and what level of testing to apply?
+      followUps:
+        - How does AI-generated code change your testing approach?
+      lookingFor:
+        - Chooses test types based on risk and complexity of the code
+        - Focuses testing effort where bugs would be most costly
+        - Considers the maintenance cost of tests alongside their value
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: cq_pro_pract_1
+      text: How have you improved code quality practices in your team?
+      lookingFor:
+        - Identifies specific quality gaps and addresses them with measurable
+          actions
+        - Influences team norms around quality through mentoring and example
+        - Balances quality investment with delivery commitments
+      expectedDurationMinutes: 8
+    - id: cq_pro_pract_2
+      text:
+        How do you balance code quality with delivery speed? Give a specific
+        example.
+      followUps:
+        - When have you chosen to accept technical debt?
+      lookingFor:
+        - Makes pragmatic trade-offs with clear reasoning about context
+        - Communicates quality decisions to stakeholders without jargon
+        - Distinguishes between deliberate trade-offs and sloppy shortcuts
+      expectedDurationMinutes: 8
+  expert:
+    - id: cq_pro_expert_1
+      text:
+        How have you established code quality standards across an organization
+        or multiple teams?
+      followUps:
+        - How did you gain adoption?
+        - How do you measure success?
+      lookingFor:
+        - Creates standards that teams adopt willingly because they solve real
+          problems
+        - Measures quality through defect rates and change failure, not just
+          lint scores
+        - Evolves standards as practices change, especially around AI-generated
+          code
+      expectedDurationMinutes: 10
+    - id: cq_pro_expert_2
+      text:
+        How do you approach reviewing AI-generated code at scale? What practices
+        ensure quality?
+      lookingFor:
+        - Designs review processes that catch AI-specific failure modes like
+          plausible but wrong logic
+        - Creates verification depth guidelines calibrated to risk, not just
+          code origin
+        - Establishes organisational patterns for when AI-generated code needs
+          deeper scrutiny
+      expectedDurationMinutes: 10
+
+managementQuestions:
+  awareness:
+    - id: cq_mgmt_aware_1
+      text: How do you communicate the importance of code quality to your team?
+      lookingFor:
+        - Connects quality to outcomes the team cares about like fewer bugs and
+          faster changes
+        - Uses concrete examples of quality impact rather than abstract
+          principles
+      expectedDurationMinutes: 5
+  foundational:
+    - id: cq_mgmt_found_1
+      text:
+        How do you help team members improve their coding and testing practices?
+      lookingFor:
+        - Provides specific, actionable feedback in code reviews rather than
+          vague suggestions
+        - Creates pairing opportunities that build quality skills through real
+          work
+        - Identifies individual skill gaps and tailors development approaches
+      expectedDurationMinutes: 5
+  working:
+    - id: cq_mgmt_work_1
+      text:
+        How do you establish and maintain code review practices in your team?
+      followUps:
+        - How do you handle disagreements about code quality?
+      lookingFor:
+        - Establishes review norms that balance thoroughness with turnaround
+          time
+        - Facilitates quality disagreements toward shared standards rather than
+          personal preference
+        - Creates review practices that work for AI-generated code, not just
+          human-written
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: cq_mgmt_pract_1
+      text:
+        How do you balance code quality standards with delivery pressure from
+        stakeholders?
+      followUps:
+        - How do you communicate quality trade-offs?
+      lookingFor:
+        - Translates quality trade-offs into business terms stakeholders can act
+          on
+        - Pushes back on shortcuts that create future cost while accepting
+          pragmatic trade-offs
+        - Creates visibility into quality metrics so trade-offs are informed,
+          not guesses
+      expectedDurationMinutes: 8
+  expert:
+    - id: cq_mgmt_expert_1
+      text:
+        How do you drive code quality culture and standards across multiple
+        teams?
+      followUps:
+        - How do you measure quality improvement?
+      lookingFor:
+        - Creates cross-team quality standards that teams adopt without heavy
+          governance
+        - Uses metrics like defect escape rate and change lead time to track
+          quality trends
+        - Shapes engineering culture so quality is a shared value, not a
+          compliance exercise
+      expectedDurationMinutes: 10

package/examples/questions/skills/data_modeling.yaml

@@ -0,0 +1,107 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/skill-questions.schema.json
+
+professionalQuestions:
+  awareness:
+    - id: dm_pro_aware_1
+      text: How do you decide how to store and organize data for a new feature?
+      lookingFor:
+        - Thinks about data relationships before choosing storage
+        - Considers how the data will be queried and used
+        - Shows awareness that data structure affects performance
+      expectedDurationMinutes: 5
+  foundational:
+    - id: dm_pro_found_1
+      text:
+        How would you design a simple database schema for a user management
+        system?
+      lookingFor:
+        - Identifies the key entities and relationships before writing SQL
+        - Considers how the schema will be queried, not just stored
+        - Makes normalization decisions with practical reasoning
+      expectedDurationMinutes: 5
+  working:
+    - id: dm_pro_work_1
+      text: How do you approach designing a data model for a complex domain?
+      followUps:
+        - How do you handle evolving requirements in your data model?
+      lookingFor:
+        - Balances normalization with query performance needs
+        - Makes deliberate trade-offs with clear reasoning
+        - Considers how the model will evolve over time
+      expectedDurationMinutes: 8
+  practitioner:
+    - id: dm_pro_pract_1
+      text:
+        How do you approach data modeling for complex domains with evolving
+        requirements?
+      lookingFor:
+        - Designs models that accommodate change without major rework
+        - Applies advanced techniques like event sourcing where appropriate
+        - Collaborates with domain experts to validate model accuracy
+      expectedDurationMinutes: 10
+  expert:
+    - id: dm_pro_expert_1
+      text:
+        How do you establish data modeling standards and practices across an
+        organization?
+      lookingFor:
+        - Creates modeling standards that improve consistency across teams
+        - Shapes organizational data architecture to enable interoperability
+        - Mentors teams on modeling practices and domain-driven design
+      expectedDurationMinutes: 10
+
+managementQuestions:
+  awareness:
+    - id: dm_mgmt_aware_1
+      text:
+        How do you ensure your team considers data modeling implications in
+        their work?
+      lookingFor:
+        - Ensures modeling decisions are considered during feature planning
+        - Communicates how data model quality affects system behaviour
+      expectedDurationMinutes: 5
+  foundational:
+    - id: dm_mgmt_found_1
+      text: How do you help team members develop data modeling skills?
+      lookingFor:
+        - Creates learning opportunities through real project work
+        - Pairs less experienced engineers with modeling-skilled colleagues
+        - Reviews data models as part of team process
+      expectedDurationMinutes: 5
+  working:
+    - id: dm_mgmt_work_1
+      text:
+        How do you facilitate data model review and alignment across your team?
+      followUps:
+        - How do you handle disagreements about modeling approaches?
+      lookingFor:
+        - Creates review processes that catch modeling issues before they reach
+          production
+        - Facilitates productive disagreements about modeling by focusing on
+          trade-offs and evidence
+        - Ensures the team aligns on modeling conventions to reduce
+          inconsistency
+      expectedDurationMinutes: 10
+  practitioner:
+    - id: dm_mgmt_pract_1
+      text:
+        How do you coordinate data modeling decisions across teams to ensure
+        consistency?
+      lookingFor:
+        - Creates cross-team alignment on shared data models and naming
+          conventions
+        - Facilitates discussions between teams when models need to interoperate
+        - Establishes modeling standards that reduce friction at team boundaries
+      expectedDurationMinutes: 10
+  expert:
+    - id: dm_mgmt_expert_1
+      text:
+        How do you shape organizational data modeling standards and governance?
+      lookingFor:
+        - Defines data modeling practices and governance adopted across the
+          business unit
+        - Creates organisational standards that improve data interoperability at
+          scale
+        - Influences how the organisation values and invests in data
+          architecture quality
+      expectedDurationMinutes: 10