abdullahbeam/learn-projects

🎯 AI Proactive Triggering (ONBOARDING SKILL)

This is an ONBOARDING skill with HIGH PRIORITY for proactive suggestion.

When to Proactively Suggest (AI MUST check user-config.yaml)

Check learning_tracker.completed.learn_projects in user-config.yaml. If false:

PROACTIVELY SUGGEST when user:

1. Says "create project" for the FIRST TIME (suggest learning before creating)
2. Describes work that sounds like a project (deliverable, deadline, finite work)
3. Asks about organizing work, tracking progress, or managing tasks
4. Expresses confusion about projects vs skills
5. Starts creating multiple similar "projects" (anti-pattern detection)
6. At the END of setup-goals or setup-workspace (natural next step)
7. When displaying the Nexus menu and total_projects = 0

Suggestion Pattern:

💡 Before creating your first project, would you like a quick 8-minute tutorial
on how Nexus projects work? It covers:
- When to use projects vs skills
- Project structure and lifecycle
- How to track progress effectively

Say 'learn projects' to start, or 'skip' to create your project directly.

DO NOT suggest if:

• learning_tracker.completed.learn_projects: true
• User explicitly says "just create the project" or "skip tutorial"
• User has already created projects successfully

---

Learn Projects

Teach how Nexus projects work through examples and decision framework.

Purpose

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

Time Estimate: 8-10 minutes

---

Workflow

Step 1: Concrete Examples

Show what IS and ISN'T a project:

✅ PROJECTS:
- Build client proposal for Acme Corp
- Research competitors and write analysis
- Create onboarding docs for new hires

❌ NOT PROJECTS (these are skills):
- Generate weekly status reports (repeating)
- Qualify incoming leads (repeating)
- Format documents (repeating)

Pattern: Projects END. Skills REPEAT.

Ask: "What work are YOU planning? Let's classify it."

---

Step 2: Decision Framework

Question 1: Direction or Work?
  • Direction = Goal (goals.md)
  • Work = Project or Skill

Question 2: Does it repeat?
  • NO → PROJECT (has endpoint)
  • YES → SKILL (reusable)

ANTI-PATTERN:
❌ "weekly-report-week-1", "weekly-report-week-2"...
✅ ONE "weekly-report" SKILL used every week

---

Step 3: Project Structure

📁 02-projects/05-client-proposal/
├── 01-planning/
│   ├── overview.md    # What & why
│   ├── plan.md        # How
│   └── steps.md       # Tasks (checkboxes)
├── 02-resources/      # Reference materials
├── 03-working/        # Work in progress
└── 04-outputs/        # Final deliverables

---

Step 4: Lifecycle

PLANNING → IN_PROGRESS → COMPLETE → ARCHIVED

Explain each state briefly.

---

Step 5: Practice

Ask: "Tell me 3 things you're planning to work on."

For each: apply decision framework together, explain reasoning.

---

Step 6: How to Create

To create a project, say:
• "create project for [description]"
• "new project: [name]"

Ready? Say "create project" to start one!

---

Step 7: Finalize

Actions (MUST complete all):

1. Mark skill complete in user-config.yaml:

   learning_tracker:
     completed:
       learn_projects: true  # ADD THIS LINE
   

2. Display completion:

   ✅ Learn Projects Complete!
   
   You now understand:
   • Projects vs Skills (projects END, skills REPEAT)
   • Decision framework (Direction → Work → Repeat?)
   • Project structure (planning → resources → working → outputs)
   • Lifecycle states (PLANNING → IN_PROGRESS → COMPLETE)
   
   Next steps:
   • 'create project' - Start your first project
   • 'learn skills' - Learn about reusable workflows
   • 'learn nexus' - System mastery
   

3. Prompt close-session:

   💡 When you're done working, say "done" to save progress.
   

---

Success Criteria

• [ ] User understands project vs skill distinction
• [ ] User can apply decision framework
• [ ] User knows project folder structure
• [ ] User understands lifecycle states
• [ ] learning_tracker.completed.learn_projects: true in user-config.yaml