mrdulasolutions/devlearn/devlearn-onboard

DevLearn: Onboard

Iron law

Teach without blocking ship. Setup should take one short exchange, then the user builds.

Voice

Follow ../shared/voice.md. Onboarding copy is warm and concrete — no curriculum lecture.

Context

New users have skills installed but no project config. This skill turns three answers into a working DEVLEARN.md, optional .devlearn/ artifacts, and a first agent prompt they can paste immediately.

Pairs with devlearn-curriculum-router for path selection and devlearn-teach-while-coding for ambient lessons once enabled.

Prerequisites

• DevLearn skills installed (./install.sh from repo root)
• A project folder (empty or existing code)

Before you start

1. Check if DEVLEARN.md already exists — offer to merge (keep user edits) or replace (fresh start)
2. Read package.json if present for stack autodetect
3. Scan for existing .devlearn/ or DEVLEARN_GLOSSARY.md — don't wipe without asking

Phase 1: Three questions (batch if user already answered)

Use AskQuestion when available; otherwise one message with A/B/C options.

Goal → lifecycle defaults:

Phase 2: Detect stack

Read package.json if present. Full rules: ../devlearn-curriculum-router/stack-detection.md.

Phase 3: Write DEVLEARN.md

Use template from repo DEVLEARN.md. Set:

• enabled: true
• persona, depth, stack from answers
• topics: [] or focused list from goal
• glossary, progress, decisions — default true (decisions matters for seasoned)
• before_big_changes: true
• lifecycle block per goal table above

Show the user a 3-line summary of what was written, not the full YAML dump unless they ask.

Phase 4: Initialize artifacts

When flags are true, create under project root:

mkdir -p .devlearn

If DevLearn repo isn't local, create minimal files from reference.md inline templates.

Phase 5: Install & rule reminder

If skills may be missing (user says commands not found):

git clone https://github.com/mrdulasolutions/DevLearn.git && cd DevLearn && ./install.sh
# All agents (Cursor, Claude, Codex, OpenCode):
./install.sh --agent all --verify
# This project:
./install.sh --project "$(pwd)" --copy-rule --copy-agents --project-skills --verify

Platform guide: ../shared/agent-compatibility.md

Optional Cursor rule: copy ../.cursor/rules/devlearn.example.mdc → .cursor/rules/devlearn.mdc

Optional Codex ambient: ./install.sh --copy-agents or copy ../AGENTS.md.example → AGENTS.md

Phase 6: Route + first prompt

Apply ../devlearn-curriculum-router/curriculum-map.md logic.

If goal includes go live, mention ship lifecycle chain:

/devlearn-pre-ship → /devlearn-security → /devlearn-deploy → /devlearn-post-ship

Output:

## You're set up
 
**DEVLEARN.md** written with persona [X], depth [Y], stack [Z].
 
**Your path:** `/devlearn-skill1` → `/devlearn-skill2` → ...
 
**Send this to your agent first:**
> "[specific build + teach prompt — see reference.md samples]"
 
**Optional:** `./install.sh --project . --copy-rule` if skills aren't global yet.

Persona tuning

Common mistakes

STOP checkpoint

After setup, ask one question:

"Paste the first prompt above to start building, or want /devlearn-curriculum-router for a longer path first?"

Required footer

---
DevLearn status: DONE
Config: DEVLEARN.md
Artifacts: [list created files]
Suggested next: /devlearn-[first-skill] | start building with first prompt
---

Additional resources

• Question scripts & first prompts → reference.md
• Full curriculum → devlearn-curriculum-router
• Ambient teaching → devlearn-teach-while-coding
• Example project → ../examples/todo-app/README.md