Files
kugetsu/README.md

43 lines
1.7 KiB
Markdown

# Kugetsu
> **Name background:** Kugetsu (月掴, "grasping the moon") is derived from Jujutsu Kaisen's "Tokusa no Kage Boujutsu" (Shadow Art Style) — a technique that summons up to ten different creatures from the user's shadow. This project embodies the concept of one orchestrator managing multiple specialized agents working in parallel.
## Overview
Kugetsu is an **agent orchestration system** that enables parallel task execution across multiple repositories. Inspired by the IT department metaphor:
- **Human** acts as executive, reviewing and approving
- **PM (Project Manager) Agent** coordinates and delegates tasks
- **Coding Agents** execute tasks autonomously on assigned issues
The core idea: instead of working through issues one-by-one, a PM spawns multiple coding agents in parallel — similar to Hermes running multiple tasks, but scaled to a full team workflow.
## Why
When you have 10 issues, typically you work through them sequentially. With Kugetsu:
- PM prioritizes and splits tasks
- Coding agents work in parallel on their own branches
- PM reviews and merges to a release branch
- Human provides final approval to master/main
This means your focus shifts from doing to overseeing — reviewing PRs, not writing code.
## Status
**Phase 3: Chat Integration (Implemented)**
- PM Agent with git worktree isolation per session
- Chat Agent via Telegram gateway
- Parallel capacity testing tool available
See [Architecture](./docs/kugetsu-architecture.md) for full system design and phase status.
## Documentation
- [Architecture](./docs/kugetsu-architecture.md) — Full system design
- [Research Index](./docs/_index.md) — All research topics
## License
MIT