/onboard-full - Comprehensive CODITECT Onboarding

Version: 1.0.0 Category: Onboarding & Training Status: Production Last Updated: December 11, 2025

Description

Comprehensive, interactive onboarding covering all 7 CODITECT component types with confidence checkpoints, practice exercises, and exit/resume capabilities.

Time Required: 20-30 minutes Outcome: Full understanding of Agents, Skills, Commands, Scripts, Tools, Workflows, and Cookbook

Usage

# Full interactive onboarding (recommended)
/onboard-full

# Resume from previous session
/onboard-full --resume

# Check current progress
/onboard-full --status

# Start from specific phase (0-10)
/onboard-full --from 3

# Quick mode (shorter explanations)
/onboard-full --quick

# Reset progress and start fresh
/onboard-full --reset

# Skip to specific component
/onboard-full --skip-to agents
/onboard-full --skip-to skills
/onboard-full --skip-to commands
/onboard-full --skip-to scripts
/onboard-full --skip-to tools
/onboard-full --skip-to workflows
/onboard-full --skip-to cookbook

Options

Option	Description
`--resume`	Continue from last saved checkpoint
`--status`	Show current progress without continuing
`--from <phase>`	Start from specific phase number (0-10)
`--quick`	Condensed explanations, faster pace
`--reset`	Clear all progress and start fresh
`--skip-to <component>`	Jump directly to a component section
`--practice-only`	Only run practice exercises
`--quiz-only`	Only run comprehension quizzes

Progress Persistence

Progress is saved to .coditect/onboarding-full-progress.json:

{
  "version": "1.0.0",
  "started_at": "2025-12-11T10:00:00Z",
  "last_activity": "2025-12-11T10:15:00Z",
  "profile": {
    "experience_level": "intermediate",
    "ai_familiarity": "regular",
    "learning_goal": "full_onboarding",
    "learning_style": "hands_on"
  },
  "phases": {
    "0_welcome": { "status": "completed", "score": null, "completed_at": "..." },
    "1_big_picture": { "status": "completed", "score": 1, "completed_at": "..." },
    "2_commands": { "status": "completed", "score": 2, "completed_at": "..." },
    "3_agents": { "status": "in_progress", "score": null, "completed_at": null },
    "4_skills": { "status": "pending", "score": null, "completed_at": null },
    "5_scripts": { "status": "pending", "score": null, "completed_at": null },
    "6_tools": { "status": "pending", "score": null, "completed_at": null },
    "7_workflows": { "status": "pending", "score": null, "completed_at": null },
    "8_cookbook": { "status": "pending", "score": null, "completed_at": null },
    "9_integration": { "status": "pending", "score": null, "completed_at": null },
    "10_final_check": { "status": "pending", "score": null, "completed_at": null }
  },
  "exercises_completed": [],
  "quiz_scores": {},
  "total_time_minutes": 15,
  "exit_points": [
    { "phase": 3, "reason": "user_requested", "at": "2025-12-11T10:15:00Z" }
  ]
}

Phase Structure

Phase 0: Welcome & Assessment (3 min)

Experience level question
AI familiarity question
Learning goal question
Profile confirmation

Phase 1: The Big Picture (2 min)

Framework overview
1-2-3 summary
Confidence checkpoint

Phase 2: Commands (3 min)

Introduction
Live /help demo
Practice exercise
Confidence checkpoint

Phase 3: Agents (5 min)

Introduction with analogies
Task tool pattern explanation
Hands-on demo
Practice exercise
Confidence checkpoint

Phase 4: Skills (3 min)

Background automation explanation
Skill examples
Confidence checkpoint

Phase 5: Scripts (2 min)

Python automation introduction
Common scripts
Confidence checkpoint

Phase 6: Tools (2 min)

Claude's capabilities
Tool list
Confidence checkpoint

Phase 7: Workflows (3 min)

Multi-component orchestration
Example workflow
Confidence checkpoint

Phase 8: Cookbook (3 min)

Recipe structure
Hands-on lookup
Confidence checkpoint

Phase 9: Integration (2 min)

Connection diagram
1-2-3 summary

Phase 10: Final Check (2 min)

7-question comprehension quiz
Celebration
Next steps

Exit & Resume

Graceful Exit

At any point, the user can type:

exit - Save progress and exit
pause - Save progress and pause
skip - Skip current section
back - Go to previous section

Exit Dialog:

You're exiting at Phase 3 (Agents).

Your progress has been saved. You've completed:
  ✅ Phase 0: Welcome
  ✅ Phase 1: Big Picture
  ✅ Phase 2: Commands
  🔄 Phase 3: Agents (in progress)

To resume: /onboard-full --resume
To check status: /onboard-full --status

See you next time!

Resume Dialog

Welcome back! Let's continue your onboarding.

Last session: December 11, 2025 at 10:15 AM
You completed: 3 of 11 phases
Time spent: 15 minutes

You were working on: Phase 3 - Agents

Ready to continue? (yes / start over / status)

Practice Exercises

Commands Practice

EXERCISE 1: Command Discovery
Try these commands and note what happens:
  1. /help
  2. /status
  3. /version

What did you learn about each?

Agents Practice

EXERCISE 2: Agent Invocation
Invoke the Explore agent to find README files:

Task(
  subagent_type="Explore",
  prompt="Find all README.md files in this project and summarize what each describes"
)

Did you get a list of READMEs with summaries?

Skills Practice

EXERCISE 3: Skill Observation
Run /git-sync --dry-run and observe:
  - What skill is being used?
  - What automation happens?
  - What output do you see?

Scripts Practice

EXERCISE 4: Script Execution
Run the component counter:
  python3 scripts/update-component-counts.py

Check the output in config/component-counts.json
How many agents, commands, and skills exist?

Workflow Practice

EXERCISE 5: Workflow Planning
Use the orchestrator to plan a simple workflow:

Task(
  subagent_type="orchestrator",
  prompt="Create a 3-step workflow for adding a new feature to a web app"
)

Does the plan include multiple component types?

Cookbook Practice

EXERCISE 6: Recipe Lookup
Open docs/02-user-guides/CODITECT-COOKBOOK.md
Find the recipe for "Debug an error"
What agent does it recommend? What's the Task pattern?

Comprehension Quizzes

Quick Quiz (after each phase)

Single question to verify understanding before proceeding.

Final Quiz (Phase 10)

7 questions covering all component types:

1. [Commands] What character do commands start with?
   a) @ b) / c) # d) !

2. [Agents] What tool invokes specialized agents?
   a) Skill() b) Agent() c) Task() d) Run()

3. [Skills] Where do skills operate?
   a) Foreground b) Background c) Manually d) Externally

4. [Scripts] How do you run a Python script?
   a) /script-name b) run script c) python3 scripts/name.py d) exec script

5. [Tools] Who uses Tools (Read, Write, Edit)?
   a) The user b) Scripts c) Claude automatically d) Commands

6. [Workflows] A workflow combines:
   a) Only agents b) Only commands c) Multiple component types d) Only tools

7. [Cookbook] The cookbook contains:
   a) Code templates b) Ready-to-use recipes c) API documentation d) Test files

Passing Score: 5/7 (70%)

Adaptive Behavior

Experience-Based Adjustments

Beginner:

More analogies and real-world examples
Slower pace with more confirmations
Extra celebration at milestones
Simpler practice exercises

Intermediate:

Balanced explanation and hands-on
Standard pace
Moderate practice complexity

Advanced:

Concise explanations
Faster pace
Advanced practice exercises
Skip basic confirmations

Expert:

Skip most explanations
Focus on advanced orchestration
Power-user tips only

System Prompt

⚠️ EXECUTION DIRECTIVE: When the user invokes this command, you MUST:

IMMEDIATELY execute - no questions, no explanations first
ALWAYS show full output from script/tool execution
ALWAYS provide summary after execution completes

DO NOT:

Say "I don't need to take action" - you ALWAYS execute when invoked
Ask for confirmation unless requires_confirmation: true in frontmatter
Skip execution even if it seems redundant - run it anyway

The user invoking the command IS the confirmation.

You are executing the comprehensive CODITECT onboarding system.

Behavior Rules:

ALWAYS check for existing progress file first
If --resume, load progress and continue from last checkpoint
Ask ONE question at a time, wait for response
Save progress after EVERY phase completion
On exit request, save immediately and confirm
Celebrate milestones explicitly
Adapt pace based on user profile
Provide hints on wrong answers, never shame

Progress File: .coditect/onboarding-full-progress.json

Exit Keywords: exit, quit, pause, stop, later, bye

Skip Keywords: skip, next, already know this

Back Keywords: back, previous, go back

Execute the onboarding flow:

# Check for resume
if args.resume or args.status:
    progress = load_progress()
    if args.status:
        show_status(progress)
        return
    resume_from_checkpoint(progress)
else:
    start_fresh_onboarding()

Agent: agents/expanded-onboarding.md
Basic Command: commands/onboard.md
Design Doc: docs/01-getting-started/EXPANDED-ONBOARDING-DESIGN.md
Cookbook: docs/02-user-guides/CODITECT-COOKBOOK.md

Success Output

When onboard-full completes:

✅ COMMAND COMPLETE: /onboard-full
Phases: 11/11 complete
Quiz Score: N/7
Time: N minutes
Status: Certified

Completion Checklist

Before marking complete:

All 11 phases complete
Quiz passed (5/7+)
Progress saved
Next steps provided

Failure Indicators

This command has FAILED if:

❌ Quiz score < 5/7
❌ Phases skipped without confirmation
❌ Progress not saved
❌ Exit without save

When NOT to Use

Do NOT use when:

Already onboarded
Quick start needed (use /onboard)
Specific component only

Anti-Patterns (Avoid)

Anti-Pattern	Problem	Solution
Rush through	Poor retention	Take time on exercises
Skip quiz	No verification	Complete final quiz
No practice	Theory only	Do all exercises

Principles

This command embodies:

#3 Complete Execution - Full onboarding
#6 Clear, Understandable - Clear progress
#9 Based on Facts - Quiz verification

Full Standard: CODITECT-STANDARD-AUTOMATION.md

Author: CODITECT Framework Team Framework: CODITECT v1.7.2

Description​

Usage​

Options​

Progress Persistence​

Phase Structure​

Phase 0: Welcome & Assessment (3 min)​

Phase 1: The Big Picture (2 min)​

Phase 2: Commands (3 min)​

Phase 3: Agents (5 min)​

Phase 4: Skills (3 min)​

Phase 5: Scripts (2 min)​

Phase 6: Tools (2 min)​

Phase 7: Workflows (3 min)​

Phase 8: Cookbook (3 min)​

Phase 9: Integration (2 min)​

Phase 10: Final Check (2 min)​

Exit & Resume​

Graceful Exit​

Resume Dialog​

Practice Exercises​

Commands Practice​

Agents Practice​

Skills Practice​

Scripts Practice​

Workflow Practice​

Cookbook Practice​

Comprehension Quizzes​

Quick Quiz (after each phase)​

Final Quiz (Phase 10)​

Adaptive Behavior​

Experience-Based Adjustments​

System Prompt​

System Prompt​

Related Components​

Success Output​

Completion Checklist​

Failure Indicators​

When NOT to Use​

Anti-Patterns (Avoid)​

Principles​

Description

Usage

Options

Progress Persistence

Phase Structure

Phase 0: Welcome & Assessment (3 min)

Phase 1: The Big Picture (2 min)

Phase 2: Commands (3 min)

Phase 3: Agents (5 min)

Phase 4: Skills (3 min)

Phase 5: Scripts (2 min)

Phase 6: Tools (2 min)

Phase 7: Workflows (3 min)

Phase 8: Cookbook (3 min)

Phase 9: Integration (2 min)

Phase 10: Final Check (2 min)

Exit & Resume

Graceful Exit

Resume Dialog

Practice Exercises

Commands Practice

Agents Practice

Skills Practice

Scripts Practice

Workflow Practice

Cookbook Practice

Comprehension Quizzes

Quick Quiz (after each phase)

Final Quiz (Phase 10)

Adaptive Behavior

Experience-Based Adjustments

System Prompt

System Prompt

Related Components

Success Output

Completion Checklist

Failure Indicators

When NOT to Use

Anti-Patterns (Avoid)

Principles