openclaw-command-center AGENTS.md

AGENTS.md — AI Workspace Guide

"The Overmind speaks through many voices, but with one purpose."

Welcome, AI agent. This document defines how you should interact with this codebase.

⚠️ CRITICAL: Pull Request Workflow

All changes to this repository MUST go through pull requests.

This is a public open source project. Even maintainers (including AI agents working on behalf of maintainers) must:

1. Create a feature branch (git checkout -b type/description)
2. Make changes and commit
3. Push branch and open a PR
4. Get approval before merging

Never push directly to main. This applies to everyone, including the repo owner.

🎯 Mission

OpenClaw Command Center is the central dashboard for AI assistant management. Your mission is to help build, maintain, and improve this system while maintaining the Starcraft/Zerg thematic elements that make it unique.

🏛️ Architecture

Read First: docs/architecture/OVERVIEW.md

Key architectural principles:

1. DRY — Don't Repeat Yourself. Extract shared code to partials/modules.
2. Zero Build Step — Plain HTML/CSS/JS, no compilation needed.
3. Real-Time First — SSE for live updates, polling as fallback.
4. Progressive Enhancement — Works without JS, enhanced with JS.

📁 Workspace Structure

openclaw-command-center/
├── lib/                    # Core server logic
│   ├── server.js           # Main HTTP server and API routes
│   ├── config.js           # Configuration loader with auto-detection
│   ├── jobs.js             # Jobs/scheduler API integration
│   ├── linear-sync.js      # Linear issue tracker integration
│   └── topic-classifier.js # NLP-based topic classification
├── public/                 # Frontend assets
│   ├── index.html          # Main dashboard UI
│   ├── jobs.html           # AI Jobs management UI
│   ├── partials/           # ⭐ Shared HTML partials (DRY!)
│   │   └── sidebar.html    # Navigation sidebar component
│   ├── css/
│   │   └── dashboard.css   # Shared styles
│   └── js/
│       ├── sidebar.js      # Sidebar loader + SSE badges
│       ├── app.js          # Main dashboard logic
│       └── lib/            # Third-party libraries
├── scripts/                # Operational scripts
├── config/                 # Configuration (be careful!)
├── docs/                   # Documentation
│   └── architecture/       # Architecture Decision Records
├── tests/                  # Test files
├── SKILL.md                # ClawHub skill metadata
└── package.json            # Version and dependencies