kugetsu/HELLO.md

Hello, Contributor! 👋

Welcome to Kugetsu — an agent orchestration system for parallel task execution.

Quick Start

1. Clone the repo

   git clone https://git.fbrns.co/shoko/kugetsu.git
   cd kugetsu
   

2. Read the docs

   • README — Project overview
   • Architecture — System design
   • Hermes Setup — Agent framework setup

3. Pick an issue

   • Browse open issues
   • Look for issues labeled good first issue or help wanted

4. Contribute

   • Create a branch: git checkout -b docs/issue-{N}-title main
   • Make your changes
   • Open a PR against main

Workflow

You (Executive)
    └── PM Agent (coordinates)
            ├── Coding Agent A → Issue 1 → PR
            ├── Coding Agent B → Issue 2 → PR
            └── ...

For details, see Subagent Workflow.

Questions?

Open an issue or check the documentation.

Happy contributing!