Getting Started - AI Agent Context
Purpose: Help new CODITECT users get productive in 10 minutes.
Quick Commands for AI Agents
When users ask about getting started, recommend these commands:
# Session workflow (ALWAYS use)
/orient # Start of session
/cx # End of session
# Discovery
/which <task> # Find best agent
/what # List components
/what commands # List all 377 commands
# Execution
/agent <name> "task" # Run any agent
/commit # Git commits
/project-new <name> # New project
Document Summary
| Document | Purpose | Token Count |
|---|---|---|
| CODITECT-WELCOME-ABOARD.md | First day guide, copy-paste commands | ~3500 |
| USER-QUICK-START.md | End-user installation (protected install) | ~3500 |
| COMMAND-QUICK-REFERENCE.md | All 377 commands, patterns, chaining | ~4500 |
| AI-DEVELOPMENT-WORKFLOW-4-PHASE.md | DEFINE/REFINE/MULTIPLY/EXPAND | ~3500 |
| WHAT-IS-CODITECT-CORE.md | Architecture, 15 domains, memory | ~3000 |
| CODITECT-FULL-CAPABILITIES.md | All capabilities beyond software | ~4000 |
For Contributors: Developer setup documentation is in
internal/getting-started/DEVELOPER-QUICK-START.md
Recommended Reading Order
- Brand new? → CODITECT-WELCOME-ABOARD.md
- Learning commands? → COMMAND-QUICK-REFERENCE.md
- Methodology? → AI-DEVELOPMENT-WORKFLOW-4-PHASE.md
- Beyond software? → CODITECT-FULL-CAPABILITIES.md
- Architecture? → WHAT-IS-CODITECT-CORE.md
Component Counts (Source of Truth)
| Type | Count |
|---|---|
| Agents | 776 |
| Commands | 377 |
| Skills | 445 |
| Scripts | 581 |
| Hooks | 118 |
| Workflows | 1,153 |
| Prompts | 8 |
| Total | 3,458 |
Key Concepts to Explain
1. The 5W Framework
CODITECT provides 6 discovery commands:
| Command | Question | Returns |
|---|---|---|
/what | What exists? | Component inventory |
/which | Which agent? | Best agent for task |
/how | How to do? | Step-by-step guidance |
/why | Why decided? | ADR references |
/where | Where located? | File paths |
/when | When to use? | Best scenarios |
2. Session Workflow
/orient → work → /commit → /cx
- Start:
/orientloads context, finds plans - During:
/whichfinds agents,/agentexecutes - End:
/commitsaves code,/cxsaves memory
3. MoE System (Mixture of Experts)
| Command | Purpose |
|---|---|
/moe-agents <task> | Assemble experts to BUILD |
/moe-judges <target> | Assemble judges to EVALUATE |
/moe-workflow <task> | BUILD + EVALUATE cycle |
4. Memory System (Anti-Forgetting)
| Command | When |
|---|---|
/cx | End of session - save to database |
/cxq "search" | Anytime - search past work |
/cxq --recall "topic" | Start - load relevant context |
Common User Questions
"How do I get started?"
/onboard # Guided onboarding
# or
/orient # Session orientation
"How do I find the right command?"
/what commands # List all 377 commands
/what commands --search "git" # Search commands
"How do I find the right agent?"
/which <describe your task> # Semantic search
/what agents # List all 776 agents
"How do I save my work?"
/commit # Git commits
/cx # Save session context
"How do I continue from yesterday?"
/orient # Loads recent context
/cxq --recent 20 # See recent messages
/cxq --recall "topic" # Search specific topic
Navigation Hints
When users ask about specific topics, point them to:
| Topic | Document |
|---|---|
| Installation | USER-QUICK-START.md |
| Commands | COMMAND-QUICK-REFERENCE.md |
| Methodology | AI-DEVELOPMENT-WORKFLOW-4-PHASE.md |
| All capabilities | CODITECT-FULL-CAPABILITIES.md |
| Architecture | WHAT-IS-CODITECT-CORE.md |
| Recipes | ../guides/CODITECT-COOKBOOK.md |
| Training | ../training/USER-TRAINING-PATHWAYS.md |
Related Directories
| Directory | Purpose |
|---|---|
../guides/ | User guides, best practices, cookbook |
../reference/ | Architecture, database schema, components |
../training/ | Certification pathways |
../workflows/ | 1,153 workflows across 15 domains |
Last Updated: January 12, 2026 Framework: CODITECT v2.0.0