How Porvelo Works
This is a reference guide for enrolled learners.
TL;DR
You enroll in a track, complete tasks, and submit proof of your work. An AI Coach guides you, evaluates your submissions, and builds your credibility score. Mentors are real practitioners who create tracks and offer optional one-on-one sessions. Your public profile shows your score and approved work to anyone with the link.
The AI Coach
Your AI Coach is a personalized AI assistant powered by Claude (Anthropic). During onboarding your Coach was assigned a name from a pool of options (Aria, Jordan, and others). That name and this AI Coach are the same thing: throughout the product you will see both used interchangeably.
Your Coach knows your career goal, your current task, and your submission history. You can talk to it any time from the Coach tab. Ask where to focus, what a concept means, or how your work is going. It responds in your preferred language and keeps a full conversation history so you can pick up where you left off.
Mentors
Mentors are real people: experienced practitioners who have applied to Porvelo, shared their background, and been reviewed by the team. They are distinct from your AI Coach.
Mentors create tracks, can review your submissions, and are available for one-on-one sessions depending on your plan. If your track was created by a Mentor, their name appears on the track detail page. Session booking is handled directly through the Mentor's booking link.
Tracks, Phases, Milestones, and Tasks
These are the four levels of your learning plan, from largest to smallest.
A structured learning program with a goal, estimated duration, and three phases. You enroll in one track at a time. Tracks are created either by Porvelo or by a Mentor.
A chapter of your track with a theme and a set of milestones. Most tracks have three phases. Phase 1 tasks are generated when you enroll. Later phases generate automatically when you get close to completing the previous one.
A named checkpoint inside a phase. Completing all tasks in a milestone marks it done automatically. Milestones give you a sense of where you are inside a phase.
A specific piece of work with instructions, resources, and a deliverable requirement. Most tasks begin with a set of reflection questions to answer before you start building. To complete a task, you submit proof of work and receive an AI evaluation. Some tasks are simulations (timed, no Coach help) and some include optional challenge constraints.
Your full plan is visible on the Plan page. Later phases are generated by your AI Coach as you progress, so they can take into account what you built in earlier phases.
Credibility Score
Your credibility score (0 to 100) is a running measure of your demonstrated work quality. It updates automatically each time a submission is approved. When your profile is public, this score is visible to employers who discover your profile. It measures only what you have actually built, not what you claim.
The score is a weighted average of three dimensions:
| Dimension | Weight | What it measures |
|---|---|---|
| Execution | 40% | How well you complete tasks to spec |
| Complexity | 30% | The difficulty and depth of work you take on |
| Consistency | 30% | Your track record of showing up and submitting |
Your overall score maps to a tier:
| Tier | Score |
|---|---|
| Beginner | 0 - 29 |
| Rising | 30 - 54 |
| Proven | 55 - 74 |
| Expert | 75 - 89 |
| Elite | 90 - 100 |
Your Public Profile
Your public profile (/profile/your-username) is visible to anyone with the link when you have profile visibility enabled and at least one approved submission.
It shows:
- Your credibility tier and overall score
- Total XP and current streak
- Badges earned from approved work
- Featured projects from your submissions
- Your headline and bio (from Settings)
You can toggle profile visibility from Settings. Employers can see your profile if you have made it public.
Submissions and Evaluation
When you complete a task, you submit proof of your work. Each task specifies what counts as proof: a GitHub link, a live demo, a video, a write-up, or a combination. Most tasks also ask you to complete a structured reflection before submitting: what you built, where you got stuck, what you would redo, and what you are proud of. Some tasks open with a set of short questions to answer before you start building, so you think through the problem first.
Your AI Coach evaluates everything automatically and returns a score with written feedback. Possible outcomes:
- Approved: Your credibility score updates, XP is awarded, and the task is marked complete.
- Revision needed: The Coach identified gaps. Read the feedback, address it, and resubmit.
- Not approved: The submission did not meet the task criteria. Review the feedback and try again.
All your submissions are saved in the Submissions tab, including prior attempts and their feedback.
Still confused about something? Send us a note and we will add it here.