@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.
- package/app/commands/agent.js +119 -31
- package/app/commands/command-factory.js +3 -3
- package/app/commands/interview.js +14 -7
- package/app/commands/job.js +52 -33
- package/app/commands/progress.js +14 -7
- package/app/commands/serve.js +5 -0
- package/app/commands/stage.js +0 -10
- package/app/commands/track.js +5 -8
- package/app/components/builder.js +117 -30
- package/app/css/components/surfaces.css +16 -0
- package/app/formatters/agent/profile.js +30 -115
- package/app/formatters/agent/skill.js +23 -44
- package/app/formatters/behaviour/dom.js +3 -0
- package/app/formatters/behaviour/microdata.js +106 -0
- package/app/formatters/discipline/dom.js +28 -1
- package/app/formatters/discipline/microdata.js +117 -0
- package/app/formatters/discipline/shared.js +49 -8
- package/app/formatters/driver/dom.js +3 -0
- package/app/formatters/driver/microdata.js +91 -0
- package/app/formatters/grade/dom.js +5 -4
- package/app/formatters/grade/microdata.js +151 -0
- package/app/formatters/index.js +32 -1
- package/app/formatters/interview/shared.js +13 -8
- package/app/formatters/job/description.js +70 -81
- package/app/formatters/job/dom.js +40 -113
- package/app/formatters/job/markdown.js +17 -13
- package/app/formatters/json-ld.js +242 -0
- package/app/formatters/microdata-shared.js +184 -0
- package/app/formatters/progress/shared.js +14 -11
- package/app/formatters/shared.js +7 -2
- package/app/formatters/skill/dom.js +3 -0
- package/app/formatters/skill/microdata.js +151 -0
- package/app/formatters/stage/dom.js +3 -18
- package/app/formatters/stage/microdata.js +110 -0
- package/app/formatters/stage/shared.js +0 -27
- package/app/formatters/track/dom.js +5 -30
- package/app/formatters/track/markdown.js +2 -25
- package/app/formatters/track/microdata.js +111 -0
- package/app/formatters/track/shared.js +6 -58
- package/app/handout-main.js +26 -12
- package/app/handout.html +7 -0
- package/app/index.html +11 -0
- package/app/lib/card-mappers.js +17 -12
- package/app/lib/form-controls.js +64 -1
- package/app/lib/job-cache.js +12 -9
- package/app/lib/render.js +8 -1
- package/app/lib/template-loader.js +75 -0
- package/app/lib/yaml-loader.js +25 -8
- package/app/main.js +8 -4
- package/app/model/agent.js +158 -130
- package/app/model/checklist.js +57 -91
- package/app/model/derivation.js +135 -68
- package/app/model/index-generator.js +1 -7
- package/app/model/job.js +19 -13
- package/app/model/levels.js +20 -12
- package/app/model/loader.js +41 -17
- package/app/model/matching.js +33 -3
- package/app/model/profile.js +38 -45
- package/app/model/schema-validation.js +438 -0
- package/app/model/validation.js +747 -68
- package/app/pages/agent-builder.js +125 -28
- package/app/pages/assessment-results.js +10 -4
- package/app/pages/discipline.js +36 -6
- package/app/pages/driver.js +9 -47
- package/app/pages/interview-builder.js +3 -1
- package/app/pages/interview.js +15 -4
- package/app/pages/job-builder.js +4 -1
- package/app/pages/job.js +43 -8
- package/app/pages/landing.js +10 -10
- package/app/pages/progress-builder.js +3 -1
- package/app/pages/progress.js +78 -26
- package/app/pages/self-assessment.js +3 -3
- package/app/pages/stage.js +3 -126
- package/app/slide-main.js +45 -17
- package/app/slides/index.js +3 -1
- package/app/slides/overview.js +40 -4
- package/app/slides/progress.js +4 -2
- package/app/slides.html +7 -0
- package/bin/pathway.js +28 -75
- package/examples/agents/.claude/skills/architecture-design/SKILL.md +58 -16
- package/examples/agents/.claude/skills/cloud-platforms/SKILL.md +59 -18
- package/examples/agents/.claude/skills/code-quality-review/SKILL.md +58 -17
- package/examples/agents/.claude/skills/devops-cicd/SKILL.md +64 -18
- package/examples/agents/.claude/skills/full-stack-development/SKILL.md +59 -15
- package/examples/agents/.claude/skills/sre-practices/SKILL.md +64 -18
- package/examples/agents/.claude/skills/technical-debt-management/SKILL.md +58 -17
- package/examples/agents/.github/agents/se-platform-code.agent.md +39 -88
- package/examples/agents/.github/agents/se-platform-plan.agent.md +41 -88
- package/examples/agents/.github/agents/se-platform-review.agent.md +38 -15
- package/examples/agents/.vscode/settings.json +1 -1
- package/examples/behaviours/outcome_ownership.yaml +1 -2
- package/examples/behaviours/polymathic_knowledge.yaml +1 -2
- package/examples/behaviours/precise_communication.yaml +1 -2
- package/examples/behaviours/relentless_curiosity.yaml +1 -2
- package/examples/behaviours/systems_thinking.yaml +1 -2
- package/examples/capabilities/business.yaml +80 -142
- package/examples/capabilities/delivery.yaml +155 -219
- package/examples/capabilities/people.yaml +2 -34
- package/examples/capabilities/reliability.yaml +161 -80
- package/examples/capabilities/scale.yaml +234 -252
- package/examples/copilot-setup-steps.yaml +25 -0
- package/examples/devcontainer.yaml +21 -0
- package/examples/disciplines/_index.yaml +1 -0
- package/examples/disciplines/data_engineering.yaml +14 -12
- package/examples/disciplines/engineering_management.yaml +63 -0
- package/examples/disciplines/software_engineering.yaml +14 -12
- package/examples/drivers.yaml +1 -4
- package/examples/framework.yaml +1 -2
- package/examples/grades.yaml +14 -15
- package/examples/questions/behaviours/outcome_ownership.yaml +1 -2
- package/examples/questions/behaviours/polymathic_knowledge.yaml +1 -2
- package/examples/questions/behaviours/precise_communication.yaml +1 -2
- package/examples/questions/behaviours/relentless_curiosity.yaml +1 -2
- package/examples/questions/behaviours/systems_thinking.yaml +1 -2
- package/examples/questions/skills/architecture_design.yaml +1 -2
- package/examples/questions/skills/cloud_platforms.yaml +1 -2
- package/examples/questions/skills/code_quality.yaml +1 -2
- package/examples/questions/skills/data_modeling.yaml +1 -2
- package/examples/questions/skills/devops.yaml +1 -2
- package/examples/questions/skills/full_stack_development.yaml +1 -2
- package/examples/questions/skills/sre_practices.yaml +1 -2
- package/examples/questions/skills/stakeholder_management.yaml +1 -2
- package/examples/questions/skills/team_collaboration.yaml +1 -2
- package/examples/questions/skills/technical_writing.yaml +1 -2
- package/examples/self-assessments.yaml +1 -3
- package/examples/stages.yaml +101 -46
- package/examples/tracks/_index.yaml +0 -1
- package/examples/tracks/platform.yaml +8 -13
- package/examples/tracks/sre.yaml +8 -18
- package/examples/vscode-settings.yaml +2 -7
- package/package.json +9 -3
- package/templates/agent.template.md +65 -0
- package/templates/job.template.md +47 -0
- package/templates/skill.template.md +28 -0
- package/examples/agents/.claude/skills/data-modeling/SKILL.md +0 -99
- package/examples/agents/.claude/skills/developer-experience/SKILL.md +0 -99
- package/examples/agents/.claude/skills/knowledge-management/SKILL.md +0 -100
- package/examples/agents/.claude/skills/pattern-generalization/SKILL.md +0 -102
- package/examples/agents/.claude/skills/technical-writing/SKILL.md +0 -129
- 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
|