/onboard - CODITECT Onboarding Command

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

---

System Prompt

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

1. IMMEDIATELY execute - no questions, no explanations first
2. ALWAYS show full output from script/tool execution
3. 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.

---

Description

Interactive, dialog-driven onboarding for new CODITECT users. Acts as a friendly consultant guiding you through setup and your first project.

Time Required: 10-15 minutes Outcome: Working project with first agent invocation complete

---

Usage

# Standard onboarding (interactive dialog)
/onboard

# Quick mode (skip assessments, use defaults)
/onboard --quick

# Resume from previous session
/onboard --resume

# Specific starting point
/onboard --from environment
/onboard --from project
/onboard --from agent

# Check onboarding status
/onboard --status

---

Options

Option	Description
--quick	Skip experience assessment, use intermediate defaults
--resume	Continue from last checkpoint
--from <phase>	Start from specific phase (environment, shell, project, agent)
--status	Show current onboarding progress
--reset	Clear progress and start fresh
--skip-env	Skip environment verification (for advanced users)

---

Interactive Flow

What Happens

1. Welcome & Assessment (2 min)

   • Greets you warmly
   • Asks experience level and goals
   • Routes to appropriate path

2. Environment Check (3 min)

   • Verifies Git, Python, Claude Code
   • Helps fix any missing requirements
   • Confirms everything works

3. Shell Setup (2 min)

   • Configures cr alias for AI Command Router
   • Verifies alias works
   • Explains benefit (never memorize commands)

4. Project Creation (3 min)

   • Asks what you want to build
   • Creates project with proper structure
   • Shows what was created

5. First Agent Invocation (5 min)

   • Teaches Task Tool Pattern (critical concept)
   • Guides you through first invocation
   • Verifies success

6. Session Management (2 min)

   • Explains context preservation
   • Shows export commands
   • Prepares you for future sessions

7. Next Steps (2 min)

   • Recommends learning path
   • Points to resources
   • Celebrates completion

---

Example Session

$ /onboard

Welcome to CODITECT! I'm your onboarding consultant.

Let's get you started in about 10 minutes. No lengthy docs required -
just a conversation where I guide you through setup and your first project.

First, what's your experience level?
  a) New to software development
  b) Some coding experience
  c) Professional developer
  d) Already familiar with CODITECT

> b

Great! And what's your goal today?
  a) Learn CODITECT quickly (30 min)
  b) Complete certification training (4-6 hours)
  c) Start a specific project immediately

> c

Perfect! Let's verify your environment first...

Checking Git... git version 2.39.0
Checking Python... Python 3.11.4
Checking Claude Code... claude-code 1.0.0

All requirements met!

Now let's set up your shell alias. Add this to ~/.zshrc:

  alias cr='claude "/suggest-agent"'

Then run: source ~/.zshrc

Done? Great! Now, what are you building?

> A REST API for managing recipes

Excellent! Creating your project...

/new-project "Build a REST API for managing recipes with modern Python stack"

Project created! You now have:
  recipe-api/
  ├── docs/original-research/
  ├── .coditect/
  └── README.md

Now let's invoke your first agent. The Task Tool Pattern is critical:

Task(
  subagent_type="general-purpose",
  prompt="Use orchestrator subagent to create an initial project plan
  for a recipe management REST API with user authentication, CRUD operations,
  and search functionality"
)

Execute this and tell me what you get...

[User executes]

You got a project plan! Congratulations - you've completed onboarding!

You're now a beginning CODITECT Operator. Here's what to do next:
- Use `cr "what you want"` for command suggestions
- Invoke agents for each project phase
- Remember `/cxs` before ending sessions

Happy building!

---

Progress Tracking

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

{
  "started_at": "2025-12-11T10:00:00Z",
  "experience_level": "intermediate",
  "goal": "project_first",
  "phases": {
    "welcome": { "completed": true, "at": "2025-12-11T10:01:00Z" },
    "environment": { "completed": true, "at": "2025-12-11T10:03:00Z" },
    "shell_setup": { "completed": true, "at": "2025-12-11T10:05:00Z" },
    "project_creation": { "completed": true, "at": "2025-12-11T10:08:00Z" },
    "first_agent": { "completed": true, "at": "2025-12-11T10:12:00Z" },
    "session_management": { "completed": true, "at": "2025-12-11T10:14:00Z" },
    "next_steps": { "completed": true, "at": "2025-12-11T10:15:00Z" }
  },
  "completed_at": "2025-12-11T10:15:00Z"
}

---

Error Recovery

Environment Issues:

/onboard --from environment

Shell Setup Failed:

/onboard --from shell

Project Creation Issues:

/onboard --from project

Agent Invocation Problems:

/onboard --from agent

---

Related Components

• Agent: agents/coditect-onboarding.md
• Skill: skills/coditect-onboarding/SKILL.md
• Script: scripts/onboard-wizard.py
• Hook: hooks/onboard-welcome.md

---

For Advanced Users

Skip onboarding entirely:

# Manual quick setup
python3 scripts/onboard-wizard.py --auto-setup --project-name "my-project"

Or just create a project directly:

/new-project "Your project description"

---

Success Output

When onboard completes:

✅ COMMAND COMPLETE: /onboard
Phases: 7/7 complete
Environment: Verified
Project: Created
First Agent: Invoked
Status: Ready to build

Completion Checklist

Before marking complete:

• Environment verified
• Shell configured
• Project created
• First agent invoked
• Progress saved

Failure Indicators

This command has FAILED if:

• ❌ Environment check failed
• ❌ Project not created
• ❌ First invocation failed
• ❌ Progress not saved

When NOT to Use

Do NOT use when:

• Already onboarded
• Need full training (use /onboard-full)
• Environment already setup

Anti-Patterns (Avoid)

Anti-Pattern	Problem	Solution
Skip env check	Setup issues	Verify environment
Skip shell setup	No cr alias	Configure alias
Skip agent practice	Can't invoke	Complete first invocation

Principles

This command embodies:

• #1 Self-Provisioning - Auto environment setup
• #3 Complete Execution - Full onboarding
• #6 Clear, Understandable - Clear guidance

Full Standard: CODITECT-STANDARD-AUTOMATION.md

---

Author: CODITECT Framework Team Framework: CODITECT v1.0