Skip to content

Autonomous Wiki

Overview

Development of a self-maintaining community knowledge base system using MkDocs with Material theme, maintained by an autonomous Claude agent that processes Discord discussions and continuously improves its own behavior.

Recent Developments

  • August 26, 2025: Enhanced Bot Functionality - Discord bot now supports Claude Code SDK integration with direct response capability and full MCP server access
  • August 26, 2025: Security Implementation - Channel-restricted bot access to prevent abuse and protect internal communications
  • August 26, 2025: Newsletter Generation - Planning enhanced content summarization and newsletter generation capabilities (character limit considerations for Discord message splitting)
  • August 25, 2025: Open Source Planning - Discord bot server scheduled for public release as community contribution
  • August 22, 2025: Wiki is now live at wiki.firstloop.ai with DNS fully configured
  • August 22, 2025: Agent Self-Modification - Wiki curation agent now updates its own system prompt based on Discord feedback
  • August 22, 2025: Webhook Infrastructure Complete - Real-time Discord → GitHub Actions integration deployed and operational
  • August 21, 2025: Team decided on MkDocs over Wiki.js for markdown-based approach
  • Ambient agent successfully deployed and cataloging Discord discussions
  • Railway deployment completed with robust plugin ecosystem
  • Enhanced agent communication workflow with automatic Discord status updates

Architecture Decisions

Static Site Generator Choice

Selected: MkDocs with Material Theme - Pure markdown-based (no database required) - Easy GitHub Actions integration - Portable content format for future migrations - Material theme provides modern, clean UI

Alternatives Considered

  • Wiki.js (requires PostgreSQL, more complex)
  • Other markdown-based options researched via ChatGPT

Deployment Strategy

  • Railway MCP server for deployment automation
  • GitHub repository for version control
  • Automated updates via GitHub Actions
  • Ambient Claude agent for content curation

Features

  • Living document that evolves with community knowledge
  • Automatic extraction of discussions from Discord
  • Theme and pattern identification
  • Daily activity logs
  • Cross-referenced topic pages
  • Built-in search functionality (no additional programming required)
  • Robust plugin ecosystem for extensibility
  • Minimal configuration setup with maximum feature set
  • Agent Self-Improvement: Curation agent can modify its own behavior based on user feedback
  • Automated status reporting to Discord channel after updates

Performance Notes

  • MkDocs Material described as "crazy good" with minimal setup
  • Only required markdown files and plugin configuration
  • No custom programming needed for current feature set
  • Healthy plugin ecosystem for future enhancements

Webhook Infrastructure Integration

Real-time Discord Integration

Developing lightweight webhook infrastructure to enable immediate responses to Discord channel feedback and mentions.

Current Challenge

The wiki curation agent currently requires manual GitHub Actions pipeline triggers to pick up Discord channel feedback immediately, creating delays in: - Agent response to direct mentions - Real-time feedback integration
- Immediate system prompt updates based on user requests

Proposed Solutions

Discord Slash Commands - Replace @ mentions with Discord slash commands for triggering bot actions - More structured interaction patterns - Clearer action categorization - Better user experience for different bot functions

Lightweight Webhook Proxy - Bun-based HTTP server for webhook forwarding - Receive Discord webhooks and transform/route to GitHub Actions - Generic pattern for future platform integrations - Preference for Bun over Railway Functions for better reliability

Generic Webhook Service Vision - Reusable infrastructure for webhook proxying between services - Support for Discord → GitHub Actions, GitHub → Discord notifications - Foundation for custom automation pipelines

Implementation Status

  • August 26, 2025: Production Deployment - Discord bot server live on Railway with full functionality
  • August 26, 2025: Claude Code SDK Integration - Bot now runs Claude Code directly with MCP server access
  • August 26, 2025: Security Controls - Access restricted to specific channels (idea-discussion and internal only) to prevent abuse and protect sensitive communications
  • August 26, 2025: Enhanced Response System - Direct Claude responses piped back to Discord threads where bot is tagged
  • August 25, 2025: Open Source Strategy - Bot server prepared for public release to demonstrate Claude + MCP capabilities
  • August 25, 2025: Marketing Initiative - Open source release planned as proof-of-concept for broader community
  • August 22, 2025: Generic Discord bot server successfully deployed on Railway
  • Repository: discord-bot-server
  • Slash command architecture implemented and operational
  • Real-time webhook integration completed - Discord → GitHub Actions triggering now functional
  • Agent response time significantly improved for immediate feedback processing
  • Railway deployment praised for ease and reliability compared to alternatives

Resources & References