aitbc/docs/scenarios/_TEMPLATE.md

[SCENARIO TITLE]

Level: [Getting Started/Blockchain/Expert]
Prerequisites: [List prerequisites]
Estimated Time: [X minutes]
Last Updated: 2026-05-02
Version: 1.0

🧭 Navigation Path:

🏠 Documentation Home → 🎭 Agent Scenarios → You are here

breadcrumb: Home → Scenarios → [Scenario Name]

---

🎯 See Also:

• 📖 Related Scenario: [Link to related scenario]
• 🤖 Agent SDK: Agent SDK Documentation
• 🧩 Feature Documentation: [Link to relevant feature docs]

---

📚 Scenario Overview

[Brief description of what this scenario demonstrates and what the agent will accomplish]

Use Case

[Describe the real-world use case this scenario addresses]

What You'll Learn

• [Learning objective 1]
• [Learning objective 2]
• [Learning objective 3]

---

📋 Prerequisites

Knowledge Required

• [Prerequisite knowledge 1]
• [Prerequisite knowledge 2]

Tools Required

• [Tool 1]
• [Tool 2]

Setup Required

• [Setup step 1]
• [Setup step 2]

---

🔧 Step-by-Step Workflow

Step 1: [Step Title]

[Description of step 1]

# Command examples
command_here

Step 2: [Step Title]

[Description of step 2]

# Command examples
command_here

[Continue with additional steps as needed]

---

🧪 Validation

Validate this scenario with the shared 3-node harness:

bash scripts/workflow/44_comprehensive_multi_node_scenario.sh

Node coverage:

• aitbc1: genesis / primary node checks
• aitbc: follower / local node checks
• gitea-runner: automation / CI node checks

Validation guide:

• Scenario Validation Guide

Expected result:

• Scenario-specific commands complete successfully
• Cross-node health checks pass
• Blockchain heights remain in sync
• Any node-specific step is documented in the scenario workflow

---

💻 Code Examples Using Agent SDK

Example 1: [Example Title]

from aitbc_agent_sdk import Agent, AgentConfig

# Code example
config = AgentConfig(
    name="my-agent",
    blockchain_network="mainnet"
)

agent = Agent(config)
agent.start()

Example 2: [Example Title]

# Additional code example

---

🎯 Expected Outcomes

After completing this scenario, you should be able to:

• [Outcome 1]
• [Outcome 2]
• [Outcome 3]

---

🔗 Related Resources

AITBC Documentation

• [Related documentation link 1]
• [Related documentation link 2]

External Resources

• [External resource 1]
• [External resource 2]

Next Scenarios

• [Next beginner scenario]
• [Related intermediate scenario]
• [Related advanced scenario]

---

📊 Quality Metrics

• Structure: 10/10 - Clear workflow with step-by-step instructions
• Content: 10/10 - Comprehensive coverage of scenario topic
• Code Examples: 10/10 - Working Agent SDK code examples
• Status: Active scenario

---

Last updated: 2026-05-02
Version: 1.0
Status: Active scenario document