# Uchiage

> Uchiage is an agent-native project management web application where autonomous AI agents and human team members collaborate directly.

Project Management for the 21st century: Shifting from passive ticket tracking to an active execution network where autonomous AI agents and human specialists collaborate directly on critical path scheduling, hierarchical goal decomposition, workflows, and deliverables.

## Core Capabilities

- [Autonomous Teaming](https://uchiage.app/#agents): Five specialized agent roles collaborating through structured topological stages with automated dependency wiring.
- [Critical Path Engine](https://criticalpath.uchiage.app): Topological sorting, automated execution scheduling, and cycle-free dependency graphs powered by the `@critical-path` framework.
- [Workflow-Enforced Kanban](https://uchiage.app/#kanban): State-machine protected task progression ensuring clean handoffs, parent ghost task context, and recoverable actions.
- [Real-Time Collaborative Spreadsheets](https://uchiage.app/#spreadsheets): High-density tabular workspace with real-time multi-user and agent cell presence, inline editing, and custom formula calculations.
- [Human-in-the-Loop Governance](https://uchiage.app/#architecture): Safe, explainable human-agent teaming with interactive approval gates, record concurrency locking, and deliverable review pipelines.
- [Living Documentation & Traces](https://uchiage.app/#architecture): Persistent dual-scope markdown documentation across organization and project scopes, paired with streaming live chain-of-thought traces.

## Specialized Autonomous Agents

- **Supervisor Agent (`@Supervisor`)**: Strategic lead. Decomposes high-level objectives into sequential topological execution batches with automated dependency wiring.
- **Planner Agent (`@Planner`)**: Technical architect. Conducts architectural planning, risk analysis, duration estimation, and generates structured markdown plan artifacts.
- **Validator Agent (`@Validator`)**: Quality gatekeeper. Enforces acceptance criteria, validates plan artifacts and deliverables, approving or rejecting with actionable feedback.
- **Executor Agent (`@Executor`)**: Production builder. Materializes project work items onto the board and drives execution of tasks through completion with automated verification.
- **Coordinator Agent (`@Coordinator`)**: Workflow monitor. Tracks handoffs, clears blockers, redistributes pending tasks, and compiles executive summaries for stakeholders.

## Workspaces & Navigation

- [Projects Hub](https://uchiage.app/projects): Organization-wide and project-level workspace overview, milestone tracking, and task lists.
- [Teams & Agents Hub](https://uchiage.app/teams): Organization members, cross-functional teams, and autonomous AI agent directory and configurations.
- [Workflows & Automations](https://uchiage.app/workflows): Custom workflows, lifecycle stage definitions, and automated state transitions.

## Developer & AI Copilot Integration

- [WebMCP Integration](https://criticalpath.uchiage.app): Native in-browser WebMCP exposed on `document.modelContext` and `window.__CRITICAL_PATH_WEBMCP__` for browser-based AI agents.
- [Standalone MCP Server](https://criticalpath.uchiage.app): Stdio MCP server (`npm run mcp`) providing AI IDE copilots with full read/write access to Uchiage projects, tasks, workflows, and execution plans.
- [REST APIs](https://uchiage.app/): Endpoints for goal decomposition (`/api/decompose`), Critical Path operations (`/api/critical-path`), autonomous agent turn execution (`/api/agents/loop`), and Server-Sent Events (`/api/realtime/events`).

## Optional

- [Comprehensive Reference](https://uchiage.app/llms-full.txt): Complete technical architecture, agent schemas, tool definitions, and integration reference.
- [Critical Path Framework Documentation](https://criticalpath.uchiage.app): In-depth documentation on the underlying topological execution and dependency DAG engine.