| name | tutorial-guide-orientation |
| description | Nested tutorial-guide reference for lessons 1–3: welcome, live architecture discovery, global directory, project directory, and agent working directory.
|
| version | 1.0.0 |
| last_changed_at | 2026-07-18T00:00:00Z |
| maintenance | If you find stale or incorrect information here, use the lingtai-issue-report skill to assemble evidence and obtain per-issue human consent before filing an issue. Never include secrets, credentials, tokens, or private paths. |
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.
