From 85e2a4916db3e1306443769f521a874c548ddc37 Mon Sep 17 00:00:00 2001 From: aitbc Date: Thu, 7 May 2026 09:37:22 +0200 Subject: [PATCH] docs: add Hermes learning prompt and adjust README for AI agent learning - Create HERMES_LEARNING_PROMPT.md with comprehensive learning instructions - Update README.md with Hermes-specific learning instructions - Add interactive prompts for Hermes to provide debug messages and suggestions - Structure learning process across 9 training stages with feedback protocol --- docs/agent-training/HERMES_LEARNING_PROMPT.md | 169 ++++++++++++++++++ docs/agent-training/README.md | 39 +++- 2 files changed, 201 insertions(+), 7 deletions(-) create mode 100644 docs/agent-training/HERMES_LEARNING_PROMPT.md diff --git a/docs/agent-training/HERMES_LEARNING_PROMPT.md b/docs/agent-training/HERMES_LEARNING_PROMPT.md new file mode 100644 index 00000000..3eb2c9ad --- /dev/null +++ b/docs/agent-training/HERMES_LEARNING_PROMPT.md @@ -0,0 +1,169 @@ +# Hermes Agent Training Learning Prompt + +This document is a structured learning prompt for Hermes to learn the AITBC agent training curriculum. + +## Learning Objective + +Hermes should master the complete AITBC agent training program, understanding all 9 stages of agent development from foundation to multi-chain architecture. + +## Learning Process + +### Phase 1: Document Analysis +1. **Read and analyze** all documentation in `/docs/agent-training/`: + - `README.md` - Overview and structure + - `training_schema.json` - Schema definition + - `ENVIRONMENT_SETUP.md` - Environment configuration + - `OPERATIONS_AUDIT.md` - Operations coverage + - `SCENARIO_STAGE_MAPPING.md` - Practical applications + - All stage JSON files (`stage1_*.json` through `stage9_*.json`) + +2. **Identify key patterns** across all stages: + - Command structure and parameters + - Validation criteria + - Expected outcomes + - Prerequisites and dependencies + +### Phase 2: Stage Mastery +For each of the 9 training stages, Hermes should: + +1. **Understand the stage objectives** +2. **Analyze the command sequences** +3. **Identify validation criteria** +4. **Map to practical scenarios** +5. **Note potential failure points** + +### Phase 3: Debugging and Feedback + +After analyzing each stage, Hermes should provide: + +#### Debug Messages +- **Missing information**: What data is incomplete or unclear? +- **Inconsistencies**: Are there contradictions between stages? +- **Ambiguities**: What needs clarification? +- **Gaps**: What's missing from the training curriculum? + +#### Suggestions +- **Improvements**: How can the training be enhanced? +- **Optimizations**: What can be streamlined? +- **Additions**: What topics should be covered? +- **Restructuring**: How can the curriculum be better organized? + +#### Issue Identification +- **Potential failures**: What might go wrong during execution? +- **Dependency issues**: Are there missing prerequisites? +- **Environment problems**: What setup issues might occur? +- **Validation gaps**: Are success criteria sufficient? + +## Stage-by-Stage Learning Guide + +### Stage 1: Foundation +**Focus:** Wallet creation, basic transactions, mining, balance verification +**Key Learning:** Core blockchain interaction patterns +**Debug Focus:** CLI command syntax, wallet naming conventions, transaction signing + +### Stage 2: Operations Mastery +**Focus:** Advanced wallet operations, transaction monitoring, blockchain queries +**Key Learning:** State management and transaction tracking +**Debug Focus:** Query patterns, monitoring commands, multi-wallet coordination + +### Stage 3: AI Operations +**Focus:** Job submission, task management, result retrieval +**Key Learning:** Agent coordination and AI task orchestration +**Debug Focus:** API interactions, task lifecycle management, result parsing + +### Stage 4: Marketplace Economics +**Focus:** Marketplace interaction, resource trading, price discovery +**Key Learning:** Economic modeling and market operations +**Debug Focus:** Trading mechanics, price feeds, resource allocation + +### Stage 5: Expert Operations +**Focus:** Advanced agent behaviors, autonomous decision making +**Key Learning:** Complex task orchestration and performance optimization +**Debug Focus:** Decision logic, performance metrics, optimization strategies + +### Stage 6: Agent Identity SDK +**Focus:** Identity management, authentication, permissions +**Key Learning:** Security protocols and identity workflows +**Debug Focus:** Auth flows, permission checks, security edge cases + +### Stage 7: Cross-Node Training +**Focus:** Multi-node coordination, distributed consensus +**Key Learning:** Network topology and failover handling +**Debug Focus:** Node communication, consensus mechanisms, network partitions + +### Stage 8: Advanced Agent Specialization +**Focus:** Domain-specific capabilities, expert systems +**Key Learning:** Specialized knowledge bases and custom skills +**Debug Focus:** Knowledge integration, skill development, domain logic + +### Stage 9: Multi-Chain Architecture +**Focus:** Cross-chain operations, bridge protocols, interoperability +**Key Learning:** Multi-chain asset management and bridge patterns +**Debug Focus:** Bridge mechanics, cross-chain transactions, asset mapping + +## Output Format + +For each stage, Hermes should provide: + +```markdown +## Stage Analysis: [Stage Name] + +### Understanding Summary +[Brief summary of what Hermes learned] + +### Debug Messages +- **Issue**: [Description] + - **Impact**: [Why it matters] + - **Suggested Fix**: [How to resolve] + +### Suggestions +- **Improvement**: [Description] + - **Rationale**: [Why it helps] + - **Implementation**: [How to implement] + +### Potential Failures +- **Failure Scenario**: [Description] + - **Detection**: [How to identify] + - **Mitigation**: [How to prevent] +``` + +## Final Deliverable + +After completing all 9 stages, Hermes should provide: + +1. **Comprehensive Learning Summary**: What was learned across all stages +2. **Cross-Stage Analysis**: Patterns and relationships between stages +3. **Curriculum Assessment**: Overall quality and completeness +4. **Implementation Roadmap**: How to apply this knowledge in practice +5. **Testing Strategy**: How to validate agent training success + +## Interactive Feedback Protocol + +When Hermes encounters issues during learning: + +1. **Stop and document** the specific issue +2. **Provide context** from the relevant documentation +3. **Suggest alternatives** or workarounds +4. **Request clarification** if information is missing +5. **Propose improvements** to the documentation + +## Success Criteria + +Hermes has successfully learned when it can: +- Explain each stage's objectives and methods +- Identify potential issues before they occur +- Suggest improvements to the training curriculum +- Debug training execution problems +- Provide actionable feedback for curriculum enhancement + +--- + +**Instructions for Use:** +1. Submit this prompt to Hermes along with access to `/docs/agent-training/` +2. Request Hermes to follow the learning process systematically +3. Collect Hermes's stage-by-stage analysis and feedback +4. Use the feedback to improve the training curriculum +5. Iterate based on Hermes's suggestions + +**Last Updated:** 2026-05-07 +**Purpose:** Hermes AI agent learning prompt for AITBC agent training curriculum diff --git a/docs/agent-training/README.md b/docs/agent-training/README.md index ba023bd6..040501e0 100644 --- a/docs/agent-training/README.md +++ b/docs/agent-training/README.md @@ -1,6 +1,20 @@ # Agent Training Documentation -This section provides comprehensive documentation for training AI agents within the AITBC ecosystem, covering foundational setup, operational mastery, and advanced specialization. +**Hermes Learning Prompt:** This documentation is designed for AI agents (particularly Hermes) to learn the AITBC agent training curriculum. When reviewing this material, please provide debug messages, identify issues, and suggest improvements as outlined in `HERMES_LEARNING_PROMPT.md`. + +## Learning Instructions for Hermes + +As you review this documentation, please: + +1. **Analyze each stage** systematically from Stage 1 through Stage 9 +2. **Identify potential issues** in command sequences, validation criteria, or prerequisites +3. **Provide debug messages** for missing information, inconsistencies, or ambiguities +4. **Suggest improvements** to enhance the training curriculum +5. **Note potential failure points** that could occur during execution +6. **Report cross-stage dependencies** that might not be documented +7. **Propose optimizations** for command sequences or validation logic + +Refer to `HERMES_LEARNING_PROMPT.md` for detailed instructions on the learning process and output format. ## Overview @@ -108,13 +122,18 @@ Before beginning training, ensure the environment is properly configured: - Practical application examples - Integration patterns -## Quick Start +## Quick Start for Hermes -1. Review `ENVIRONMENT_SETUP.md` to prepare your environment -2. Begin with `stage1_foundation_commands.json` for foundational skills -3. Progress through stages sequentially, ensuring each stage is completed before advancing -4. Use `training_schema.json` as a reference for stage structure and requirements -5. Consult `SCENARIO_STAGE_MAPPING.md` for practical application contexts +1. **Review `HERMES_LEARNING_PROMPT.md`** for detailed learning instructions +2. **Analyze `training_schema.json`** to understand the stage structure +3. **Study `ENVIRONMENT_SETUP.md`** to understand environment requirements +4. **Begin with Stage 1** (`stage1_foundation_commands.json`) and progress sequentially +5. **For each stage, provide:** + - Debug messages for issues found + - Suggestions for improvements + - Potential failure points + - Cross-stage dependency notes +6. **Use `SCENARIO_STAGE_MAPPING.md`** to understand practical applications ## Prerequisites @@ -136,6 +155,12 @@ Each training stage includes validation criteria to ensure successful completion ## Troubleshooting +**Hermes:** When analyzing this section, identify: +- Common failure patterns across stages +- Missing troubleshooting steps +- Ambiguous error handling instructions +- Gaps in the troubleshooting coverage + For issues during training: 1. Check `ENVIRONMENT_SETUP.md` for configuration problems