Seed PE Engineering Career Framework as default roles

[Modsofthenation]

Summary

Prefills the app’s default role catalog from the PE Engineering Job Descriptions & Career Progression Chart so you can assign people without authoring roles first. Roles remain editable and you can still upload/replace frameworks.

What’s seeded

IC track

• Graduate Developer (IC1)
• Junior Software Engineer (IC2)
• Software Engineer (IC3)
• Senior Software Engineer (IC4)
• Staff Engineer (IC5)
• Principal Engineer (IC6)

Management track

• Lead Software Engineer (L1)
• Engineering Manager (M1)
• Head of Engineering (M2)
• Chief Technical Officer / CTO (M3)

Each role includes summary, day-to-day responsibilities, behavioural expectations, and progression requirements, plus next role links (e.g. Senior → Staff or Lead).

Wiring

• Empty workspace create and demo seed both publish this framework
• Creating with Your name (EM) also assigns Engineering Manager
• Setup copy points people at Roles for assignment

Test plan

• pnpm --filter @prm/api test (includes pack integrity tests)
• pnpm --filter @prm/api typecheck
• pnpm --filter @prm/ui typecheck
• Create empty workspace → Roles shows the full PE ladder
• Assign a direct to Software Engineer / Senior, set next role

  

Summary by CodeRabbit

• New Features

  • Added a preloaded PE Engineering Career Framework spanning Graduate through CTO across individual contributor and management tracks.
  • Empty and demo workspaces now include role summaries, responsibilities, expectations, and progression paths.
  • New workspaces start with an Engineering Manager and can assign current and next roles.

• Documentation

  • Updated onboarding and setup guidance to explain the preloaded career framework and role assignment steps.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: dbffb416-5c5f-4818-aa2c-bf68f750089b

📥 Commits

Reviewing files that changed from the base of the PR and between 895c3e1 and 45a82cb.

📒 Files selected for processing (10)

• CHANGELOG.md
• apps/api/src/defaultRoleFramework.test.ts
• apps/api/src/defaultRoleFramework.ts
• apps/api/src/index.ts
• apps/api/src/seed.ts
• apps/api/src/seedDefaultRoleFramework.ts
• apps/ui/src/components/OnboardingWizard.tsx
• apps/ui/src/pages/HomePage.tsx
• apps/ui/src/pages/UnlockPage.tsx
• docs/CORE_LOOP_EVAL.md

---

📝 Walkthrough

Walkthrough

The PR adds a typed PE Engineering career framework from Graduate through CTO, seeds it into empty and demo workspaces, assigns the initial engineering manager role, and updates onboarding and documentation text.

Changes

PE career framework provisioning

Layer / File(s)	Summary
Framework definition and validation apps/api/src/defaultRoleFramework.ts, apps/api/src/defaultRoleFramework.test.ts	Defines IC and management roles with expectations, competencies, progression links, and successor roles. Tests validate role structure and references.
Framework persistence and workspace initialization apps/api/src/seedDefaultRoleFramework.ts, apps/api/src/index.ts, apps/api/src/seed.ts	Persists the published framework and assigns the seeded engineering manager role with an eng_m2 progression target. Demo seed data uses updated IC and management progression targets.
Setup guidance and release documentation apps/ui/src/components/OnboardingWizard.tsx, apps/ui/src/pages/HomePage.tsx, apps/ui/src/pages/UnlockPage.tsx, docs/CORE_LOOP_EVAL.md, CHANGELOG.md	Describes the preloaded Graduate-to-CTO PE Engineering framework and updated workspace setup flow.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant WorkspaceInitialization
  participant seedDefaultRoleFramework
  participant Database
  participant RoleAssignment
  WorkspaceInitialization->>seedDefaultRoleFramework: Seed default framework
  seedDefaultRoleFramework->>Database: Insert framework, version, roles, and expectations
  seedDefaultRoleFramework-->>WorkspaceInitialization: Return framework and role IDs
  WorkspaceInitialization->>Database: Create optional EM person
  WorkspaceInitialization->>RoleAssignment: Assign eng_m1 and eng_m2 progression target

Loading

Possibly related PRs

• Modsofthenation/PerformanceReviewManager#40: Both modify workspace seeding and initialization.
• Modsofthenation/PerformanceReviewManager#60: Both modify workspace setup, onboarding, and EM provisioning.

Suggested reviewers: cursoragent

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/pe-default-roles-framework-ebae

---

_{Comment @coderabbitai help to get the list of available commands.}