diff --git a/Home.md b/Home.md index a9ef00e..619f97b 100644 --- a/Home.md +++ b/Home.md @@ -31,6 +31,11 @@ Welcome to the FalahOS wiki — infrastructure, architecture, design, and operat - **[[Skills-Reference]]** — Complete reference for all 5 installed agent skills: UI/UX design (ui-ux-pro-max), QA/testing, security audit, design auditor, and 31 DevOps skills. +## 🤖 AI Fleet & MCP + +- **[[MCP-Agent-Bridge]]** — Complete MCP agent infrastructure: Odysseus, Pi, OpenClaw, OpenHands, and all 8 MCP servers with endpoint details and usage +- **[[Social-Media-Strategy]]** — Social media content strategy for FalahOS: content pillars, platform strategy, 90-day plan, brand guidelines, and KPI framework + ## 🛠️ Infrastructure & Operations - **[[Infrastructure-Tool-Log]]** — Fleet-wide tool inventory: software, containers, services across all machines (Contabo, Synology, Mac Mini, MacBook Air, cPanel) @@ -48,7 +53,9 @@ Welcome to the FalahOS wiki — infrastructure, architecture, design, and operat | [[Design-System]] | 595-line design spec: colors, typography, components, motion, accessibility | | [[Infrastructure-Tool-Log]] | Last-7-days tool/container/status inventory per machine | | [[Falah-OS-Backend-QA-Gap-Analysis]] | 19 critical findings, ~10% QA readiness | -| [[Skills-Reference]] | All 5 installed agent skills with sub-skills, usage guides | +|| [[Skills-Reference]] | All 5 installed agent skills with sub-skills, usage guides | +|| [[MCP-Agent-Bridge]] | Agent infrastructure — 8 MCP servers, 19+ tools, endpoints | +|| [[Social-Media-Strategy]] | Content strategy, brand guidelines, 90-day plan | ## 🔗 Quick Links diff --git a/MCP-Agent-Bridge.md b/MCP-Agent-Bridge.md new file mode 100644 index 0000000..f5e43b2 --- /dev/null +++ b/MCP-Agent-Bridge.md @@ -0,0 +1,125 @@ +## MCP Agent Infrastructure + +> All agents are now accessible via MCP (Model Context Protocol) through a unified bridge system. + +--- + +## Bridge Architecture + +``` +Hermes Agent (Contabo) + ├── odysseus-bridge (localhost:7100) — 14 tools + │ ├── odysseus_health/version/runtime/memory + │ ├── openclaw_list_models/openclaw_chat + │ ├── pi_status/pi_health + │ └── openhands_status/openhands_list_mcp_tools + ├── openhands (localhost:3002 → Mac Mini:3000 via SSH tunnel) — 5 tools + │ ├── create_pr (GitHub) + │ ├── create_mr (GitLab) + │ ├── create_bitbucket_pr + │ ├── create_bitbucket_data_center_pr + │ └── create_azure_devops_pr + └── Direct MCP Servers (8 total) + ├── openspace | playwright | gstack + ├── superpower | uiux-tester | herdr + ├── odysseus-bridge | openhands +``` + +--- + +## Agent Details + +### 🧠 Odysseus (Mac Mini) +- **Status:** ✅ Running +- **Port:** 7000 (API), 7860 (Web UI) +- **Tools:** Memory management, sessions, runtime info, health +- **Backend:** Python FastAPI on Mac Mini M1 + +### 🤖 Pi Agent (Mac Mini) +- **Status:** ✅ Running v0.74.2 +- **Port:** 4747 +- **Workspace:** FalahMobile +- **Completed Tasks:** 15 +- **Tools:** Status check, health check + +### 🔮 OpenClaw (opencode.ai) +- **Status:** ✅ Running +- **Models:** 20 available, default: deepseek-v4-flash +- **Tools:** List models, chat completions + +### 🖐️ OpenHands (Mac Mini) +- **Status:** ✅ Running (Python venv, not Docker) +- **Port:** 3000 (MCP endpoint: /mcp/mcp) +- **Tools:** 5 PR/MR creation tools +- **Transport:** SSE MCP via SSH tunnel (localhost:3002) + +### Other Agents (Gitea bot users) +| Agent | Gitea User | Role | +|-------|:----------:|------| +| Claude Code | `claude-code` | Coding assistant | +| OpenCode MBA | `opencode-macbookair` | MacBook Air coding | +| Pi MBA | `pi-macbookair` | MacBook Air AI agent | +| Hermes MBA | `hermes-macbookair` | MacBook Air operations | +| Hermes Contabo | `hermes-contabo` | Contabo operations | + +--- + +## How to Use + +After a Hermes session reset (`/reset`), all MCP tools are available directly to the agent. No special commands needed — just call the tool by name. + +### MCP Server Management +```bash +# Add an SSE MCP server +hermes mcp add --url + +# List all MCP servers +hermes mcp list + +# Test connection +hermes mcp test + +# Start a new session to load tools +/reset +``` + +### Gitea API +```bash +# Base URL: http://13.140.161.244:3080 +# Auth: Basic (wmj:Abedib@99) +# API: /api/v1/repos/{owner}/{repo}/issues +``` + +--- + +## Infrastructure Hosts + +| Host | Role | IP | +|------|------|----| +| **Contabo** | Main compute, Docker Swarm, Hermes | 13.140.161.244 | +| **Mac Mini M1** | AI agents (Odysseus, Pi, OpenHands) | 100.72.2.115 | +| **Synology DS3617xs** | Docker Swarm manager, NAS | 100.126.73.29 | +| **MacBook Air** | Residential IP for cPanel access | 100.76.3.26 | +| **RoketServer** | cPanel WordPress hosting | 64.20.37.43 | + +--- + +## Ticket Management — July 2026 + +| Status | Count | Details | +|:------:|:-----:|---------| +| ✅ Closed | 15 | Stale tests, completed items, duplicate/docs | +| 🟢 Active | ~60 | Assigned to agents across 3 repos | +| 🆕 Created | 3 | Social media content epic | + +### Key Active Tickets +| # | Title | Agent | +|:-:|-------|:-----:| +| #130 | [EPIC] Social Media Content | openclaw + odysseus | +| #131 | Social Media Research | openclaw | +| #132 | Strategy & 90-Day Content | odysseus | +| #104 | Fix ody.falahos.my 503 | hermes-contabo | + +--- + +*Last updated: 2026-07-07 | Session: Full Team Onboarding Complete* diff --git a/Social-Media-Strategy.md b/Social-Media-Strategy.md new file mode 100644 index 0000000..76eee48 --- /dev/null +++ b/Social-Media-Strategy.md @@ -0,0 +1,118 @@ +## Social Media Content Strategy + +> **Status:** 🟢 Active +> **Gitea Epic:** [#130 Social Media Content](https://git.falahos.my/falah-os/war-room/issues/130) +> **Research:** [#131](https://git.falahos.my/falah-os/war-room/issues/131) (openclaw) + **Strategy:** [#132](https://git.falahos.my/falah-os/war-room/issues/132) (odysseus) + +--- + +## Mission + +Build a complete social media content engine for FalahOS — covering Islamic finance education, Faraid awareness, product launches, and community engagement. + +--- + +## Content Pillars + +| Pillar | Topics | % of Content | +|--------|--------|:------------:| +| 📚 **Faraid Education** | Inheritance law simplified, estate planning, will writing | 35% | +| 🛠️ **Product Features** | How FalahOS works, demos, feature highlights | 20% | +| 💡 **Islamic Finance Tips** | Savings, investments, zakat, general financial literacy | 20% | +| 🤝 **Community Stories** | User testimonials, behind-the-scenes, team spotlights | 15% | +| 📊 **Thought Leadership** | Islamic fintech in Malaysia, digital transformation | 10% | + +--- + +## Platforms & Strategy + +| Platform | Focus | Format | Frequency | Best Times (MY) | +|----------|-------|--------|:---------:|:----------------:| +| **TikTok** | Short-form education | 60s videos, trends | 5x/week | 8-10am, 8-11pm | +| **Instagram** | Reels + Carousel + Stories | Visual + educational | 5x/week | 9-11am, 7-9pm | +| **LinkedIn** | Thought leadership | Long-form articles | 2x/week | 7-9am, 12-1pm | +| **Twitter/X** | Community + quick tips | Threads, polls, news | 3x/week | 9-11am | +| **YouTube** | Long-form education | 10-15 min explainers | 1x/week | 3-5pm (weekends) | + +--- + +## Brand Guidelines + +| Element | Value | +|---------|-------| +| **Primary Gold** | `#C9A84C` | +| **Primary Green** | `#2ECC71` | +| **Background Dark** | `#070A0D` | +| **Tone** | Educational, warm, authoritative, Islamic values | +| **Language** | Malay (primary) + English (secondary), bilingual where relevant | +| **Typography** | Cinzel (headings), DM Sans (body), JetBrains Mono (labels) | +| **Hashtags (Primary)** | #Faraid #IslamicFinance #FalahOS #Pusaka #EdisiFaraid | +| **Hashtags (Secondary)** | #Malaysia #Fintech #EstatePlanning #Muslim #DigitalInheritance | + +--- + +## Content Roadmap + +### Phase 1: Research (Week 1) — OpenClaw +- [ ] Competitor analysis — top 10 Islamic finance accounts +- [ ] Audience personas — primary + secondary demographics +- [ ] Hashtag bank — 100+ organised hashtags +- [ ] Platform analysis — content format performance +- [ ] Best posting times confirmed + +### Phase 2: Strategy (Week 1-2) — Odysseus +- [ ] 90-day content calendar (platform-by-platform) +- [ ] Content pillar framework & messaging matrix +- [ ] Content repurposing workflow (1 blog → 5 posts) +- [ ] KPI framework & measurement dashboard +- [ ] Visual template designs (Canva) + +### Phase 3: Creation — Batch 1 (Week 2-3) — Both +- [ ] 10 posts: Faraid education + Product awareness +- [ ] 5 posts: Community/culture +- [ ] 5 posts: Thought leadership +- [ ] Video scripts for TikTok/Reels +- [ ] Carousel/Infographic designs + +--- + +## First Batch — Content Ideas + +| # | Topic | Format | Platform | +|:-:|-------|--------|----------| +| 1 | "What Happens to Your Property Without a Will?" | Carousel | IG + LinkedIn | +| 2 | "Faraid Inheritance Split Explained in 60s" | Short video | TikTok + Reels | +| 3 | "3 Reasons Islamic Estate Planning Matters" | Quote card | All platforms | +| 4 | "How FalahOS Simplifies Inheritance" | Product demo | TikTok + IG | +| 5 | "Your Digital Inheritance — Secure Your Family" | Storytelling | IG Stories | +| 6 | "Why Malaysia Needs Digital Faraid" | Long-form | LinkedIn | +| 7 | "Quiz: Do You Know Your Faraid Rights?" | Interactive | IG + Twitter | +| 8 | "Meet the Team Behind FalahOS" | Behind-scenes | All platforms | +| 9 | "Islamic Finance Myth vs Fact" | Carousel | IG + LinkedIn | +| 10 | "Weekly Faraid Tip" | Short tip | Twitter + Stories | + +--- + +## KPI Dashboard + +| Metric | Target (30 days) | Measurement | +|--------|:----------------:|-------------| +| **Total Reach** | 50,000 | Platform analytics | +| **Engagement Rate** | 5% | Likes + shares + comments / impressions | +| **Follower Growth** | 500 | Net new followers | +| **Website Clicks** | 200 | Bitly + analytics | +| **Content Output** | 30 posts | Actual posted / planned | + +--- + +## Related Repos & Tickets + +- **Epic Ticket:** [#130](https://git.falahos.my/falah-os/war-room/issues/130) +- **Research:** [#131](https://git.falahos.my/falah-os/war-room/issues/131) +- **Strategy & Creation:** [#132](https://git.falahos.my/falah-os/war-room/issues/132) +- **War Room:** [falah-os/war-room](https://git.falahos.my/falah-os/war-room) +- **Falah Mobile Wiki:** [Home](https://git.falahos.my/wmj/falah-mobile/wiki/Home) + +--- + +*Last updated: 2026-07-07*