FIS Architecture

FIS Architecture 3.2 Pro

Multi-agent workflow framework for CyberMao (Main) → Worker coordination using JSON tickets and Discord Forum threads.

When to Use This Skill

Use FIS when:

Agent Roles: | Role | Agent ID | Expertise | |------|----------|-----------| | Architect | main | Coordination, task routing, user communication | | Coding | engineer | Python, gprMax, algorithms, data analysis | | Research | researcher | Theory, literature, simulation planning | | Writing | writer | Documentation, LaTeX, visualization |

Discord Bot Permissions (REQUIRED)

Each agent's Discord bot must have these permissions configured in the Discord server. Without them, Thread creation and messaging will fail silently.

Required Bot Permissions:

How to configure: 1. Go to Discord Server Settings → Roles 2. For each bot role (CyberMao, Researcher, Engineer, Writer), enable the permissions above 3. Ensure each Forum channel grants these permissions to the relevant bot roles

Verify with:

{ "action": "threadCreate", "channelId": "", "name": "Permission Test" }

Tool Configuration

| Tool | Purpose | Path | |------|---------|------| | fis_lifecycle_pro.py | Ticket lifecycle (create/status/complete/list) | scripts/fis_lifecycle_pro.py | | fis_coordinator.py | Generate delegation templates (CyberMao only) | scripts/fis_coordinator.py | | fis_worker_toolkit.py | Spawn sub-agents, generate reports (Workers only) | scripts/fis_worker_toolkit.py |

Python Environment: Requires Python 3.8+ with standard library only (no external dependencies).

Core Workflow

Step 1: CyberMao Delegates Task

# Generate ticket + Thread template + A2A command
python3 scripts/fis_coordinator.py delegate \
  --agent engineer \
  --task "Implement GPR signal filter" \
  --forum coding

Output:

Step 2: CyberMao Creates Forum Thread

Use the discord tool to create a Thread in the appropriate Forum channel:

{
  "action": "threadCreate",
  "channelId": "",
  "name": "TASK_xxx: Implement GPR signal filter"
}

The response returns the new Thread ID. Then notify the Worker with the Thread ID:

python3 scripts/fis_coordinator.py notify \
  --ticket-id TASK_xxx \
  --thread-id 

Execute the generated sessions_send command to notify the Worker.

Step 3: Worker Executes Task

# Check ticket
python3 scripts/fis_lifecycle_pro.py list
Update status
python3 scripts/fis_lifecycle_pro.py status \
  --ticket-id TASK_xxx --status doing
Optional: Spawn sub-agent for complex sub-tasks
python3 scripts/fis_worker_toolkit.py spawn \
  --parent-ticket TASK_xxx \
  --subtask "Analyze algorithm complexity"

Worker replies in the Forum Thread using the discord tool:

{
  "action": "threadReply",
  "channelId": "",
  "content": "Task received. Starting execution."
}

Step 4: Worker Reports Completion

# Generate completion report
python3 scripts/fis_worker_toolkit.py report \
  --parent-ticket TASK_xxx \
  --summary "Successfully implemented GPR filter" \
  --deliverables filter.py test_results.json

Execute the generated sessions_send command to notify CyberMao.

Step 5: CyberMao Finalizes

# View report
python3 scripts/fis_coordinator.py report --ticket-id TASK_xxx
Mark complete
python3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx

Archive the Thread and report to User in #daily-chat.

Architecture

User/Linn
    ↓
CyberMao (Main) - Architect, coordinator
    ↓ sessions_send + discord threadCreate
Worker (Engineer/Researcher/Writer) - Domain experts
    ↓ (optional) sessions_spawn mode="run"
SubAgent (temporary, background) - Complex sub-tasks

Key Principles: 1. A2A via sessions_send — Main calls Workers, Workers report back 2. Ticket tracking — All tasks have JSON tickets in fis-hub/ 3. Programmatic Thread creation — CyberMao creates Forum Threads via discord tool's threadCreate action 4. SubAgent background mode — sessions_spawn with mode="run", no new Thread

Commands Reference

fis_lifecycle_pro.py

# Create ticket
python3 scripts/fis_lifecycle_pro.py create \
  --agent engineer --task "Description" --channel-type coding
Update status (todo/doing/done)
python3 scripts/fis_lifecycle_pro.py status \
  --ticket-id TASK_xxx --status doing --note "Progress update"
Mark complete
python3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx
List active tickets
python3 scripts/fis_lifecycle_pro.py list
Archive old tickets
python3 scripts/fis_lifecycle_pro.py archive

fis_coordinator.py (CyberMao only)

# Delegate and generate templates
python3 scripts/fis_coordinator.py delegate \
  --agent researcher --task "GPR theory analysis" --forum theory
Notify Worker after Thread is created
python3 scripts/fis_coordinator.py notify \
  --ticket-id TASK_xxx --thread-id 
View detailed report
python3 scripts/fis_coordinator.py report --ticket-id TASK_xxx

fis_worker_toolkit.py (Workers only)

# Spawn sub-agent (background, no Thread)
python3 scripts/fis_worker_toolkit.py spawn \
  --parent-ticket TASK_xxx --subtask "Complex sub-task description"
Generate completion report
python3 scripts/fis_worker_toolkit.py report \
  --parent-ticket TASK_xxx \
  --summary "Completion summary" \
  --deliverables file1.py file2.json

Channel Mapping

| Category | Forum Channel | Worker | Tool Flag | |----------|--------------|--------|-----------| | RESEARCH | 🔬-theory-derivation | @Researcher | --forum theory | | RESEARCH | 📊-gpr-simulation | @Researcher | --forum simulation | | DEVELOPMENT | 💻-coding | @Engineer | --forum coding | | WRITING | 📝-drafts | @Writer | --forum drafts |

Error Handling

If ticket creation fails:

If Thread creation fails:

If A2A fails:

If sub-agent spawn fails:

Quality Standards

1. One Task = One Ticket — Never reuse ticket IDs 2. Status Updates Required — Workers must update status (TODO → DOING → DONE) 3. Thread Per Task — Each task gets its own Forum Thread (created via threadCreate) 4. A2A Confirmation — Always confirm receipt via sessions_send 5. Archive After Complete — Archive Thread after task completion

Configuration

Required in ~/.openclaw/openclaw.json:

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "researcher", "engineer", "writer"]
    }
  }
}

Testing

Quick A2A Test

# Test connectivity
sessions_send(sessionKey="engineer", message="A2A test")

Thread Creation Test

{ "action": "threadCreate", "channelId": "", "name": "FIS Test Thread" }

Full Workflow Test

# 1. Create task
python3 scripts/fis_coordinator.py delegate \
  --agent researcher --task "Test task" --forum theory
2. Create Forum Thread via discord tool threadCreate
3. Notify Worker with Thread ID
python3 scripts/fis_coordinator.py notify \
  --ticket-id TASK_xxx --thread-id 
4. Execute A2A command
5. Complete
python3 scripts/fis_lifecycle_pro.py complete --ticket-id TASK_xxx

*FIS 3.2 Pro | Multi-Agent Workflow Framework*

Required in ~/.openclaw/openclaw.json:

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "researcher", "engineer", "writer"]
    }
  }
}