MapCtx：面向多Agent协作的Markdown任务管理与工作流同步平台

MapCtx is an AI-first, local-first project workspace that uses Markdown for task management. It supports VS Code visualization, bidirectional GitHub sync, and multi-agent collaboration, addressing vendor lock-in, data silos, and AI access issues in traditional project management tools. Key features include local Markdown task boards, structured data for AI readability, and cross-tool sync.

Modern teams face a paradox: centralized tools (Jira, Linear) have strong features but cause vendor lock-in, data islands, and offline unavailability. Simple Todo lists can't meet complex collaboration needs. AI assistants need project context (priority, dependencies) but traditional tools lock data in proprietary formats, making AI access hard. MapCtx aims to balance open data portability with strong management and AI collaboration.

Design Principles: Local-first (data in Markdown files for control/offline use), deterministic structure (structured metadata for reliable parsing/AI access), human-AI interface (visual tools like VS Code Kanban alongside text files).

Architecture: Monorepo with subpackages (VS Code extension, sync engine, core parser, AI skills). The sync engine handles bidirectional GitHub sync with dry-run previews.

Initialization: Create TASKS.md with structured task entries (ID, status, priority, etc.).

Daily Flow: Pull GitHub updates → Check status → Edit via VS Code/Kanban → Push changes.

GitHub Integration: Use GitHub CLI for auth (repo, project permissions). Supports bidirectional sync between local Markdown and GitHub Issues/Projects v2, with conflict reconciliation.

MapCtx enables multi-agent collaboration via shared Markdown files. Example scenario: Claude Code creates refactor tasks → Cursor updates progress → Human reviews in VS Code → CI/CD syncs to GitHub. Each participant uses their preferred tool while staying synchronized through open Markdown format.

vs Jira/Linear: MapCtx uses Markdown (open) vs proprietary formats; offline available vs no; no vendor lock-in vs yes; AI directly accesses text vs needs API; free vs subscription.

vs Obsidian/Notion: MapCtx adds structured task management, GitHub sync, multi-agent framework, and Kanban/roadmap views (missing in Obsidian/Notion).

Current Limitations: Steeper learning curve due to structured Markdown; complex conflicts need manual handling; limited mobile support.

Future Plans: Web interface, mobile apps, more integrations (Linear, Asana), smarter AI for task decomposition/dependency analysis.

MapCtx represents a new project management paradigm: local-first, AI-native, open format. It's not a replacement for Jira/Linear but an option for teams valuing data sovereignty, AI collaboration, and simplicity. It serves individuals (light task management), teams (decentralized collaboration), and researchers (human-AI experiment platform). As AI evolves, such tools will enhance human-AI collaboration.