docs: add initial Kugetsu architecture and update README
This commit is contained in:
41
README.md
41
README.md
@@ -1,22 +1,37 @@
|
||||
# kugetsu
|
||||
# Kugetsu
|
||||
|
||||
Research notes and documentation repository.
|
||||
|
||||
> **Name background:** _to be documented_
|
||||
> **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
|
||||
|
||||
This repository contains research findings, experiments, and documentation on various topics.
|
||||
Kugetsu is an **agent orchestration system** that enables parallel task execution across multiple repositories. Inspired by the IT department metaphor:
|
||||
|
||||
## Structure
|
||||
- **Human** acts as executive, reviewing and approving
|
||||
- **PM (Project Manager) Agent** coordinates and delegates tasks
|
||||
- **Coding Agents** execute tasks autonomously on assigned issues
|
||||
|
||||
```
|
||||
├── README.md
|
||||
├── CONTRIBUTING.md
|
||||
├── LICENSE
|
||||
└── docs/
|
||||
└── ...
|
||||
```
|
||||
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 1: Research & PoC**
|
||||
|
||||
Current focus: Documenting architecture and researching Hermes/OpenClaw capabilities for multi-agent parallelization.
|
||||
|
||||
## Documentation
|
||||
|
||||
- [Architecture](./docs/kugetsu-architecture.md) — Full system design
|
||||
- [Research Index](./docs/_index.md) — All research topics
|
||||
|
||||
## License
|
||||
|
||||
|
||||
Reference in New Issue
Block a user