@forwardimpact/pathway 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/app/commands/agent.js +119 -31
  2. package/app/commands/command-factory.js +3 -3
  3. package/app/commands/interview.js +14 -7
  4. package/app/commands/job.js +52 -33
  5. package/app/commands/progress.js +14 -7
  6. package/app/commands/serve.js +5 -0
  7. package/app/commands/stage.js +0 -10
  8. package/app/commands/track.js +5 -8
  9. package/app/components/builder.js +117 -30
  10. package/app/css/components/surfaces.css +16 -0
  11. package/app/formatters/agent/profile.js +30 -115
  12. package/app/formatters/agent/skill.js +23 -44
  13. package/app/formatters/behaviour/dom.js +3 -0
  14. package/app/formatters/behaviour/microdata.js +106 -0
  15. package/app/formatters/discipline/dom.js +28 -1
  16. package/app/formatters/discipline/microdata.js +117 -0
  17. package/app/formatters/discipline/shared.js +49 -8
  18. package/app/formatters/driver/dom.js +3 -0
  19. package/app/formatters/driver/microdata.js +91 -0
  20. package/app/formatters/grade/dom.js +5 -4
  21. package/app/formatters/grade/microdata.js +151 -0
  22. package/app/formatters/index.js +32 -1
  23. package/app/formatters/interview/shared.js +13 -8
  24. package/app/formatters/job/description.js +70 -81
  25. package/app/formatters/job/dom.js +40 -113
  26. package/app/formatters/job/markdown.js +17 -13
  27. package/app/formatters/json-ld.js +242 -0
  28. package/app/formatters/microdata-shared.js +184 -0
  29. package/app/formatters/progress/shared.js +14 -11
  30. package/app/formatters/shared.js +7 -2
  31. package/app/formatters/skill/dom.js +3 -0
  32. package/app/formatters/skill/microdata.js +151 -0
  33. package/app/formatters/stage/dom.js +3 -18
  34. package/app/formatters/stage/microdata.js +110 -0
  35. package/app/formatters/stage/shared.js +0 -27
  36. package/app/formatters/track/dom.js +5 -30
  37. package/app/formatters/track/markdown.js +2 -25
  38. package/app/formatters/track/microdata.js +111 -0
  39. package/app/formatters/track/shared.js +6 -58
  40. package/app/handout-main.js +26 -12
  41. package/app/handout.html +7 -0
  42. package/app/index.html +11 -0
  43. package/app/lib/card-mappers.js +17 -12
  44. package/app/lib/form-controls.js +64 -1
  45. package/app/lib/job-cache.js +12 -9
  46. package/app/lib/render.js +8 -1
  47. package/app/lib/template-loader.js +75 -0
  48. package/app/lib/yaml-loader.js +25 -8
  49. package/app/main.js +8 -4
  50. package/app/model/agent.js +158 -130
  51. package/app/model/checklist.js +57 -91
  52. package/app/model/derivation.js +135 -68
  53. package/app/model/index-generator.js +1 -7
  54. package/app/model/job.js +19 -13
  55. package/app/model/levels.js +20 -12
  56. package/app/model/loader.js +41 -17
  57. package/app/model/matching.js +33 -3
  58. package/app/model/profile.js +38 -45
  59. package/app/model/schema-validation.js +438 -0
  60. package/app/model/validation.js +747 -68
  61. package/app/pages/agent-builder.js +125 -28
  62. package/app/pages/assessment-results.js +10 -4
  63. package/app/pages/discipline.js +36 -6
  64. package/app/pages/driver.js +9 -47
  65. package/app/pages/interview-builder.js +3 -1
  66. package/app/pages/interview.js +15 -4
  67. package/app/pages/job-builder.js +4 -1
  68. package/app/pages/job.js +43 -8
  69. package/app/pages/landing.js +10 -10
  70. package/app/pages/progress-builder.js +3 -1
  71. package/app/pages/progress.js +78 -26
  72. package/app/pages/self-assessment.js +3 -3
  73. package/app/pages/stage.js +3 -126
  74. package/app/slide-main.js +45 -17
  75. package/app/slides/index.js +3 -1
  76. package/app/slides/overview.js +40 -4
  77. package/app/slides/progress.js +4 -2
  78. package/app/slides.html +7 -0
  79. package/bin/pathway.js +28 -75
  80. package/examples/agents/.claude/skills/architecture-design/SKILL.md +58 -16
  81. package/examples/agents/.claude/skills/cloud-platforms/SKILL.md +59 -18
  82. package/examples/agents/.claude/skills/code-quality-review/SKILL.md +58 -17
  83. package/examples/agents/.claude/skills/devops-cicd/SKILL.md +64 -18
  84. package/examples/agents/.claude/skills/full-stack-development/SKILL.md +59 -15
  85. package/examples/agents/.claude/skills/sre-practices/SKILL.md +64 -18
  86. package/examples/agents/.claude/skills/technical-debt-management/SKILL.md +58 -17
  87. package/examples/agents/.github/agents/se-platform-code.agent.md +39 -88
  88. package/examples/agents/.github/agents/se-platform-plan.agent.md +41 -88
  89. package/examples/agents/.github/agents/se-platform-review.agent.md +38 -15
  90. package/examples/agents/.vscode/settings.json +1 -1
  91. package/examples/behaviours/outcome_ownership.yaml +1 -2
  92. package/examples/behaviours/polymathic_knowledge.yaml +1 -2
  93. package/examples/behaviours/precise_communication.yaml +1 -2
  94. package/examples/behaviours/relentless_curiosity.yaml +1 -2
  95. package/examples/behaviours/systems_thinking.yaml +1 -2
  96. package/examples/capabilities/business.yaml +80 -142
  97. package/examples/capabilities/delivery.yaml +155 -219
  98. package/examples/capabilities/people.yaml +2 -34
  99. package/examples/capabilities/reliability.yaml +161 -80
  100. package/examples/capabilities/scale.yaml +234 -252
  101. package/examples/copilot-setup-steps.yaml +25 -0
  102. package/examples/devcontainer.yaml +21 -0
  103. package/examples/disciplines/_index.yaml +1 -0
  104. package/examples/disciplines/data_engineering.yaml +14 -12
  105. package/examples/disciplines/engineering_management.yaml +63 -0
  106. package/examples/disciplines/software_engineering.yaml +14 -12
  107. package/examples/drivers.yaml +1 -4
  108. package/examples/framework.yaml +1 -2
  109. package/examples/grades.yaml +14 -15
  110. package/examples/questions/behaviours/outcome_ownership.yaml +1 -2
  111. package/examples/questions/behaviours/polymathic_knowledge.yaml +1 -2
  112. package/examples/questions/behaviours/precise_communication.yaml +1 -2
  113. package/examples/questions/behaviours/relentless_curiosity.yaml +1 -2
  114. package/examples/questions/behaviours/systems_thinking.yaml +1 -2
  115. package/examples/questions/skills/architecture_design.yaml +1 -2
  116. package/examples/questions/skills/cloud_platforms.yaml +1 -2
  117. package/examples/questions/skills/code_quality.yaml +1 -2
  118. package/examples/questions/skills/data_modeling.yaml +1 -2
  119. package/examples/questions/skills/devops.yaml +1 -2
  120. package/examples/questions/skills/full_stack_development.yaml +1 -2
  121. package/examples/questions/skills/sre_practices.yaml +1 -2
  122. package/examples/questions/skills/stakeholder_management.yaml +1 -2
  123. package/examples/questions/skills/team_collaboration.yaml +1 -2
  124. package/examples/questions/skills/technical_writing.yaml +1 -2
  125. package/examples/self-assessments.yaml +1 -3
  126. package/examples/stages.yaml +101 -46
  127. package/examples/tracks/_index.yaml +0 -1
  128. package/examples/tracks/platform.yaml +8 -13
  129. package/examples/tracks/sre.yaml +8 -18
  130. package/examples/vscode-settings.yaml +2 -7
  131. package/package.json +9 -3
  132. package/templates/agent.template.md +65 -0
  133. package/templates/job.template.md +47 -0
  134. package/templates/skill.template.md +28 -0
  135. package/examples/agents/.claude/skills/data-modeling/SKILL.md +0 -99
  136. package/examples/agents/.claude/skills/developer-experience/SKILL.md +0 -99
  137. package/examples/agents/.claude/skills/knowledge-management/SKILL.md +0 -100
  138. package/examples/agents/.claude/skills/pattern-generalization/SKILL.md +0 -102
  139. package/examples/agents/.claude/skills/technical-writing/SKILL.md +0 -129
  140. package/examples/tracks/manager.yaml +0 -53
@@ -1,129 +0,0 @@
1
- ---
2
- name: technical-writing
3
- description: |
4
- Guide for creating clear technical documentation. Use when writing READMEs,
5
- API docs, specifications, or any technical content that needs to be clear
6
- and accurate.
7
- ---
8
-
9
- # Technical Writing
10
-
11
- ## When to use this skill
12
-
13
- Use this skill when:
14
-
15
- - Writing README files
16
- - Creating API documentation
17
- - Writing technical specifications
18
- - Documenting code and systems
19
- - Creating guides and tutorials
20
-
21
- ## Writing Principles
22
-
23
- ### Clarity First
24
-
25
- - Use simple, direct language
26
- - One idea per sentence
27
- - Active voice over passive
28
- - Avoid jargon unless defined
29
- - Be specific, not vague
30
-
31
- ### Know Your Audience
32
-
33
- - What do they already know?
34
- - What do they need to accomplish?
35
- - What's their skill level?
36
- - What questions will they have?
37
-
38
- ### Structure for Scanning
39
-
40
- - Lead with the most important information
41
- - Use headings and subheadings
42
- - Keep paragraphs short
43
- - Use lists for multiple items
44
- - Highlight key terms
45
-
46
- ## Document Types
47
-
48
- ### README
49
-
50
- - What is this project?
51
- - How do I get started?
52
- - How do I use it?
53
- - Where do I get help?
54
-
55
- ### API Documentation
56
-
57
- - Endpoint description
58
- - Parameters and types
59
- - Request/response examples
60
- - Error codes and handling
61
-
62
- ### Technical Specification
63
-
64
- - Problem statement
65
- - Proposed solution
66
- - Alternatives considered
67
- - Implementation plan
68
-
69
- ### Tutorial
70
-
71
- - Clear learning objective
72
- - Prerequisites listed
73
- - Step-by-step instructions
74
- - Expected outcomes shown
75
-
76
- ## README Template
77
-
78
- ```markdown
79
- # Project Name
80
-
81
- Brief description of what this project does.
82
-
83
- ## Getting Started
84
-
85
- ### Prerequisites
86
-
87
- - Required software and versions
88
-
89
- ### Installation
90
-
91
- Step-by-step installation instructions.
92
-
93
- ### Quick Start
94
-
95
- Minimal example to get running.
96
-
97
- ## Usage
98
-
99
- Common use cases with examples.
100
-
101
- ## Contributing
102
-
103
- How to contribute to the project.
104
-
105
- ## License
106
-
107
- License information.
108
- ```
109
-
110
- ## Code Examples
111
-
112
- Good examples are:
113
-
114
- - Complete and runnable
115
- - Minimal but realistic
116
- - Copy-pasteable
117
- - Annotated with comments
118
- - Tested and verified
119
-
120
- ## Technical Writing Checklist
121
-
122
- - [ ] Purpose is clear in first paragraph
123
- - [ ] Audience is identified
124
- - [ ] Prerequisites are listed
125
- - [ ] Examples are tested and work
126
- - [ ] Technical terms are defined
127
- - [ ] Structure supports scanning
128
- - [ ] No ambiguous pronouns
129
- - [ ] Updated when code changes
@@ -1,53 +0,0 @@
1
- # Track: Engineering Manager
2
- # People and delivery leadership
3
-
4
- name: Engineering Manager
5
-
6
- # Track type - management track (professional defaults to false)
7
- isManagement: true
8
-
9
- # Shared content (used by both human job descriptions and agent profiles)
10
- description:
11
- People and delivery leadership, focusing on team effectiveness, career
12
- development, and organizational outcomes. Creates space for curiosity and
13
- experimentation; models ownership behaviours.
14
- roleContext:
15
- In this leadership role, you will focus on people and delivery management,
16
- driving team effectiveness and career development. You will create space for
17
- curiosity and experimentation while modeling ownership behaviours and ensuring
18
- organizational outcomes are achieved.
19
-
20
- # Derivation inputs - used by both human and agent profiles
21
- skillModifiers:
22
- business: 2
23
- people: 2
24
- reliability: -1
25
- delivery: -2
26
- scale: -2
27
- behaviourModifiers:
28
- polymathic_knowledge: 1
29
- assessmentWeights:
30
- skillWeight: 0.4
31
- behaviourWeight: 0.6
32
-
33
- # Agent-specific content
34
- agent:
35
- coreInstructions: |
36
- You are a {specialization} leadership support agent. Your primary
37
- focus is supporting engineering managers with team effectiveness,
38
- process design, and communication.
39
-
40
- People and process over direct implementation. You help create space
41
- for curiosity and experimentation, model ownership behaviors, and
42
- remove organizational friction.
43
-
44
- Before making changes:
45
- 1. Consider team dynamics and individual growth
46
- 2. Think about systemic improvements over individual fixes
47
- 3. Focus on enabling others rather than doing directly
48
-
49
- Your role is to support engineering judgment, not replace it.
50
- constraints:
51
- - Focus on enabling and empowering rather than doing directly
52
- - Consider long-term team health over short-term fixes
53
- - Support engineering judgment, don't replace it