learn-builds

[TARGET] Build-First Onboarding (CONTEXTUAL SUGGESTION)

This is a learning skill. With Build-First onboarding, suggest AFTER first build, not before.

Auto-Complete via Checkpoint

# In user-config.yaml
build_first.checkpoints.first_build_created: true  → learn_builds auto-completed!

When user creates their first build, learn_builds is automatically marked complete via auto_complete_map. They learned by DOING.

When to Proactively Suggest (Post-Experience)

Check both:

• learning_tracker.completed.learn_builds - explicit completion
• build_first.checkpoints.first_build_created - auto-completion

PROACTIVELY SUGGEST when user:

1. AFTER first build - asks "how does this build system work?" (wants deeper understanding)
2. Expresses confusion about builds vs skills (after having used builds)
3. Starts creating multiple similar "builds" (anti-pattern detection)
4. Explicitly asks to learn/understand builds

Suggestion Pattern (Post-Experience):

💡 You've already created a build! Want to understand the system more deeply?

'learn builds' covers:
- When to use builds vs skills (avoid anti-patterns)
- Build lifecycle and best practices
- How to track progress effectively

Say 'learn builds' for the deep-dive (8 min), or continue working.

If user already created build, acknowledge it:

You've got practical experience now! This tutorial will deepen your understanding
of WHY the system works this way.

DO NOT suggest if:

• User is creating their FIRST build (let them DO first)
• User explicitly says "skip" or dismisses
• User is mid-task and focused

---

Learn Builds

Teach how Nexus builds work through examples and decision framework.

Purpose

Help user understand when to create builds vs skills, how builds are structured, and the build lifecycle. Uses concrete examples before abstract concepts.

Time Estimate: 8-10 minutes

---

Workflow

Step 1: Concrete Examples

Show what IS and ISN'T a build:

[OK] BUILDS:
- Build client proposal for Acme Corp
- Research competitors and write analysis
- Create onboarding docs for new hires

[ERROR] NOT BUILDS (these are skills):
- Generate weekly status reports (repeating)
- Qualify incoming leads (repeating)
- Format documents (repeating)

Pattern: Builds END. Skills REPEAT.