@forwardimpact/schema 0.9.1 → 0.9.2

package/examples/questions/skills/team_collaboration.yaml

@@ -5,16 +5,17 @@ professionalQuestions:
     - id: tc_pro_aware_1
       text: How do you work with your team to complete shared tasks?
       lookingFor:
-        - Basic teamwork skills
-        - Communication practices
+        - Communicates progress and blockers to teammates without being asked
+        - Shows willingness to help others even when it's not their direct responsibility
       expectedDurationMinutes: 5
   foundational:
     - id: tc_pro_found_1
       text:
-        Describe how you've helped a teammate when they were stuck on a problem.
+        How do you help a teammate when they're stuck on a problem?
       lookingFor:
-        - Supportive collaboration
-        - Knowledge sharing
+        - Offers support proactively without waiting to be asked
+        - Shares knowledge in a way that builds the teammate's capability
+        - Balances helping others with their own delivery commitments
       expectedDurationMinutes: 5
   working:
     - id: tc_pro_work_1
@@ -22,15 +23,17 @@ professionalQuestions:
       followUps:
         - How do you handle remote collaboration?
       lookingFor:
-        - Active collaboration facilitation
-        - Team enablement
+        - Creates practices that make collaboration easy, like shared documentation and regular syncs
+        - Adapts collaboration approach for remote and distributed team members
+        - Identifies and removes collaboration friction points proactively
       expectedDurationMinutes: 8
   practitioner:
     - id: tc_pro_pract_1
-      text: Describe how you've built high-performing team dynamics.
+      text: How do you build high-performing team dynamics?
       lookingFor:
-        - Team building expertise
-        - Handling interpersonal challenges
+        - Creates conditions for psychological safety and productive conflict
+        - Addresses interpersonal friction before it undermines collaboration
+        - Builds shared goals that unite diverse working styles
       expectedDurationMinutes: 10
   expert:
     - id: tc_pro_expert_1
@@ -38,52 +41,55 @@ professionalQuestions:
         How do you create collaborative culture across multiple teams or an
         organization?
       lookingFor:
-        - Cross-team collaboration leadership
-        - Organizational culture shaping
+        - Creates cross-team collaboration practices adopted beyond their own teams
+        - Breaks down silos by establishing shared goals and mutual dependencies
+        - Influences organisational culture so collaboration is the default, not the exception
       expectedDurationMinutes: 10
 
 managementQuestions:
   awareness:
     - id: tc_mgmt_aware_1
-      text: How do you encourage collaboration within your team?
+      text:
+        How do you ensure your team communicates effectively?
       lookingFor:
-        - Basic collaboration encouragement
-        - Team communication awareness
+        - Creates clear team communication norms for standups, async updates, and escalations
+        - Notices when communication breaks down and addresses it promptly
       expectedDurationMinutes: 5
   foundational:
     - id: tc_mgmt_found_1
-      text: How do you handle conflicts or tensions within your team?
-      followUps:
-        - How do you prevent conflicts from escalating?
+      text:
+        How do you help team members develop collaboration skills?
       lookingFor:
-        - Conflict resolution approach
-        - Team harmony maintenance
+        - Creates opportunities for pair and mob programming to build collaboration habits
+        - Gives specific feedback on collaboration behaviours in 1:1s and retros
+        - Models effective collaboration in their own cross-functional interactions
       expectedDurationMinutes: 5
   working:
     - id: tc_mgmt_work_1
-      text: How do you build psychological safety and trust within your team?
+      text:
+        How do you facilitate team collaboration and handle conflicts?
       followUps:
-        - How do you measure team health?
+        - How do you build psychological safety?
       lookingFor:
-        - Psychological safety practices
-        - Team health monitoring
+        - Addresses conflicts early through facilitated discussion rather than avoidance
+        - Creates psychological safety by responding constructively to mistakes and disagreements
+        - Builds team practices that encourage healthy debate and productive conflict
       expectedDurationMinutes: 8
   practitioner:
     - id: tc_mgmt_pract_1
       text:
-        How do you develop collaboration skills and team culture in your team?
-      followUps:
-        - How do you onboard new members into the team culture?
+        How do you build high-performing team dynamics and sustain them over time?
       lookingFor:
-        - Team culture development
-        - Collaboration skill building
+        - Creates conditions where teams maintain high performance through personnel changes
+        - Addresses team health issues before they impact delivery
+        - Builds self-managing teams that sustain their own collaboration practices
       expectedDurationMinutes: 10
   expert:
     - id: tc_mgmt_expert_1
       text:
-        How do you foster collaborative culture across multiple teams you
-        influence?
+        How do you shape organizational collaboration culture across teams?
       lookingFor:
-        - Cross-team collaboration leadership
-        - Organizational culture shaping
+        - Defines cross-team collaboration practices adopted across the business unit
+        - Creates organisational norms that break down team silos and encourage knowledge sharing
+        - Influences how the organisation values and rewards collaborative behaviour
       expectedDurationMinutes: 10

package/examples/questions/skills/technical_writing.yaml

@@ -5,87 +5,91 @@ professionalQuestions:
     - id: tw_pro_aware_1
       text: How do you approach documenting your code and work?
       lookingFor:
-        - Basic documentation habits
-        - Understanding of documentation importance
+        - Documents work consistently, not just when asked
+        - Understands that documentation helps future maintainers
       expectedDurationMinutes: 5
   foundational:
     - id: tw_pro_found_1
       text: What makes a good README file? Walk me through what you'd include.
       lookingFor:
-        - README best practices
-        - Reader-centric documentation
+        - Structures READMEs for the reader's needs, not the author's
+        - Includes essentials like purpose, setup, usage, and contribution guide
+        - Keeps documentation concise and up-to-date
       expectedDurationMinutes: 5
   working:
     - id: tw_pro_work_1
       text:
-        How do you write technical specifications that enable others to
-        implement features?
+        How do you write technical specifications that enable others to implement
+        features?
       followUps:
-        - How detailed do you go?
+        - How do you write specs that AI tools can also use effectively?
       lookingFor:
-        - Spec writing skills
-        - Communication of technical requirements
+        - Writes specs that reduce ambiguity and enable independent implementation
+        - Calibrates detail level based on audience and feature complexity
+        - Structures specs so they can be verified against implementation
       expectedDurationMinutes: 8
   practitioner:
     - id: tw_pro_pract_1
       text:
         How do you establish documentation standards and practices in your team?
       lookingFor:
-        - Documentation leadership
-        - Spec-driven development advocacy
+        - Creates documentation standards that the team actually follows because they're practical
+        - Champions spec-driven development where documentation precedes implementation
+        - Reviews documentation quality with the same rigour as code reviews
       expectedDurationMinutes: 8
   expert:
     - id: tw_pro_expert_1
       text: How do you create organizational documentation culture and systems?
       lookingFor:
-        - Enterprise documentation strategy
-        - Knowledge management systems
+        - Creates documentation systems and practices adopted across the business unit
+        - Defines knowledge management approaches that reduce information silos at scale
+        - Influences organisational culture so documentation is valued as a first-class engineering output
       expectedDurationMinutes: 10
 
 managementQuestions:
   awareness:
     - id: tw_mgmt_aware_1
-      text: How do you ensure your team documents their work appropriately?
+      text:
+        How do you ensure your team maintains adequate documentation?
       lookingFor:
-        - Basic documentation expectations
-        - Team documentation awareness
+        - Sets clear expectations about what must be documented and when
+        - Checks for documentation as part of feature completion criteria
       expectedDurationMinutes: 5
   foundational:
     - id: tw_mgmt_found_1
       text:
-        How do you set documentation expectations and standards for your team?
-      followUps:
-        - How do you handle resistance to documentation?
+        How do you help team members improve their technical writing skills?
       lookingFor:
-        - Documentation standard setting
-        - Team buy-in practices
+        - Reviews documentation and provides specific, actionable feedback on clarity and structure
+        - Creates pair-writing or review opportunities to build writing skills through practice
+        - Models clear writing in their own specs, emails, and documentation
       expectedDurationMinutes: 5
   working:
     - id: tw_mgmt_work_1
       text:
-        How do you balance documentation effort with delivery speed in your
-        team?
+        How do you establish documentation standards and ensure consistency?
       followUps:
-        - What is the minimum documentation you require?
+        - How do you balance documentation effort with delivery?
       lookingFor:
-        - Documentation vs velocity trade-offs
-        - Pragmatic documentation approach
+        - Creates practical documentation standards that reduce inconsistency without overhead
+        - Balances documentation effort against delivery by focusing on high-value documentation
+        - Ensures documentation stays current through process integration, not manual enforcement
       expectedDurationMinutes: 8
   practitioner:
     - id: tw_mgmt_pract_1
-      text: How do you build a documentation culture within your team?
-      followUps:
-        - How do you keep documentation current?
+      text:
+        How do you drive documentation culture and spec-driven development in your team?
       lookingFor:
-        - Documentation culture development
-        - Knowledge management practices
+        - Creates team expectation that specs are written before code, not after
+        - Makes documentation quality a visible part of team health metrics and retrospectives
+        - Builds a culture where engineers view documentation as an investment, not a chore
       expectedDurationMinutes: 8
   expert:
     - id: tw_mgmt_expert_1
       text:
-        How do you drive documentation practices and knowledge sharing across
-        multiple teams?
+        How do you shape organizational documentation practices and knowledge management?
       lookingFor:
-        - Cross-team documentation leadership
-        - Organizational knowledge strategy
+        - Defines documentation practices and knowledge management systems adopted across the business unit
+        - Creates organisational standards that reduce information fragmentation at enterprise scale
+        - Influences how the organisation values and invests in documentation infrastructure
       expectedDurationMinutes: 10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/schema",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Schema definitions and data loading for skills, behaviours, and role frameworks",
   "license": "Apache-2.0",
   "repository": {