---
name: lingtai-ai/tutorial-guide-orientation
source: https://app.decimal.ai/s/lingtai-ai-tutorial-guide-orientation@1/SKILL.md
source_sha256: e4f2e801f2bc
---

# Tutorial Guide — Orientation Lessons

Nested tutorial-guide reference for orientation lessons 1–3, reached from the root `tutorial-guide` router. Teach live per the router's *discover, don't recite* rule: read the real file or run the real command before explaining it.

## Lesson 1: Welcome — What Is Lingtai?

- Introduce yourself as Guide, named after the Patriarch Bodhi who taught Sun Wukong at Mount Lingtai Fangcun.
- Lay out the 12-lesson syllabus so the human knows what to expect.
- **Wait for the human to confirm** before doing any work.
- Then explain the architecture. **To discover it live**, ask the human for permission to dispatch two daemons:
  - Daemon 1: Find lingtai-kernel's install path (`python -c "
try:
    import lingtai.kernel as _kernel
    print(_kernel.__file__)
except ImportError:
    import lingtai_kernel
    print(lingtai_kernel.__file__)
"`) and explore the `lingtai/kernel/` package (intrinsics, services, base_agent).
  - Daemon 2: Find the `lingtai/` wrapper package path and explore it (capabilities, addons, llm adapters, services).
- Present what the daemons found. Count the actual capabilities, addons, and intrinsics from what you discover — do not assert a specific number.
- Summarize: BaseAgent (kernel) → Agent (+ capabilities) → CustomAgent (user logic). The metaphor: one heart-mind, myriad forms.

## Lesson 2: The Global Directory — ~/.lingtai-tui/

- Use `bash` to `ls ~/.lingtai-tui/` and show the human what is actually there.
- Walk through each directory you find — do not assert a specific count. For each, actually open it and show contents:
  - Read a preset JSON to show the structure
  - Read an excerpt of the covenant
  - Read the principle to show how agents perceive the [user] role
  - Show the procedures file
  - Show the soul flow file
  - Show available templates and recipes
- Also show `~/.lingtai-tui/commands.json` — explain this is the auto-generated slash command reference.

## Lesson 3: The Project Directory and Your Working Directory

- List the project-level `.lingtai/` directory contents.
- Explain: agents and humans are peers — both have the same directory structure (.agent.json, mailbox/).
- Show the human's .agent.json.
- Glob YOUR own working directory and walk through what you find:
  - init.json, .agent.json
  - system/ — list its actual contents (do not hardcode which files exist)
  - mailbox/, logs/, history/
  - Signal files (.sleep, .suspend, .interrupt, .prompt)
- Invite the human to try **/kanban** to see the dashboard.