​

📜 docs/HUB-AND-SPOKE-MODEL.md (v2.0)

​

🏛️ The Hub-and-Spoke Collaboration Model

“Federated Intelligence. Centralised Strategy. Zero Conflict.”

​

1. Executive Overview

​

2. 🏛️ Detailed Brain Structure Display

.agents/brain/
├── global/
│   └── task-master.md      <- THE HUB: Managed by Lead Architect (Haris).
│                           Summarises progress from all members.
│                           Defines the "Official" project status.
│
├── wings/                  <- THE PALACE: Sovereign Markdown Palace v1.0
│   ├── palace_registry.md  <- Master spatial index (AI reads this at SOD via Section [14])
│   ├── wing_[name]/        <- One Wing per domain (e.g., wing_elasticsearch/)
│   │   └── room_[name]/    <- One Room per component
│   │       └── closet.md   <- Structured knowledge: decisions, bugs, patterns
│   └── room_uncategorised/ <- Staging area for unplaced discoveries
│       └── closet.md
│
└── member/                 <- THE SPOKES: Individual sandboxes.
    ├── haris/              <- Senior Systems Architect (Sovereign Lead)
    │   ├── task.md         <- Haris's specific daily checklist.
    │   └── walkthrough.md  <- Haris's technical logs/decisions.
    ├── hisham/             <- Security & Tuning (Wazuh Specialist)
    │   ├── task.md         <- Wazuh focus & deployment tasks.
    │   └── walkthrough.md  <- Installation and tuning logs.
    ├── mawi/               <- Automation & Orchestration (Shuffle)
    │   ├── task.md         <- Workflow automation milestones.
    │   └── walkthrough.md  <- Logic logs for SOAR automation.
    ├── hidzuan/            <- Documentation & Compliance (URS/UAT)
    │   ├── task.md         <- Document draft status.
    │   └── walkthrough.md  <- Feedback and revision logs.
    └── hadi/               <- Project Coordinator (Client Interface)
        ├── client-logs.md  <- Meeting minutes & client feedback.
        ├── task.md         <- Milestone tracking & coordination.
        └── walkthrough.md  <- Communication strategies & status updates.

​

3. 🤝 The 3 Golden Rules (Workflow)

​

Rule 1: Isolation (Conflict Prevention)

​

Rule 2: The Daily Branch Ritual

• Start of Day (SOD): Run ./tools/git-ritual.sh sod <username>. This creates a semantic personal branch (e.g., member/hisham-20260127).
  • Lead Architect (T2): Also run bash tools/sod-palace.sh # (Windows: .\tools\sod-palace.ps1) to pull, audit, and load the Palace Registry before starting.
• Active Work: Commit all technical progress and brain updates specifically to this branch.
• End of Day (EOD): Run ./tools/git-ritual.sh eod. This merges the day’s work into main and pushes it to the sovereign repository.
  • Lead Architect (T2): Also run bash tools/eod-palace.sh # (Windows: .\tools\eod-palace.ps1) to validate, palace-sync, and commit Palace updates atomically.

​

Rule 3: The Synchronisation (Lead Architect Role)

1. Summarise: Progress is pulled from Spokes into the global/task-master.md.
2. Archive: Major technical milestones are recorded in the HISTORY.md Ledger.
3. Coordinate: Use the task-master.md as the agenda for team sync meetings.
4. Palace Sync: Review the palace_update_proposal_YYYY-MM-DD.md generated by eod-palace.yml and update relevant closets in wings/ to keep the spatial knowledge current.

​

4. 💻 Operational Commands

​

Visualise the Full State

tree -a .agents/brain

​

Discovery (Post-Absence)

git pull origin main
ls .agents/brain/member/

​

🧠 Pedagogical Logic: Why this format?

1. Separation of Concerns: By including Hadi (Coordination) as a Spoke, we acknowledge that project management is as critical to the “Brain” as technical code. This follows the ITIL 4 Service Value Chain.
2. Operational Sovereignty: The 3 Golden Rules ensure that the project is not dependent on any one person’s memory; the repository is the memory.
3. LDP Compliance: The clear structure and command examples follow the Linux Documentation Project standards for technical manuals.