tutorial-guide-orientation

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.