docs: compress README.md
This commit is contained in:
parent
c9fd672a04
commit
0427f29650
45
README.md
45
README.md
|
|
@ -2,29 +2,17 @@
|
||||||
|
|
||||||
GitHub issue thread assistant with an Agent Orchestrator style YAML config.
|
GitHub issue thread assistant with an Agent Orchestrator style YAML config.
|
||||||
|
|
||||||
The app polls configured GitHub repositories with `gh`, reads issue threads and
|
It polls configured GitHub repositories with `gh`, reads issue threads, and
|
||||||
issue comments, and uses configured CLI responders such as `codex`,
|
uses CLI responders such as `codex`, `opencode`, or `copilot-cli` to decide
|
||||||
`opencode`, or `copilot-cli` to reply when:
|
when to reply. It supports multi-repo config, responder fallback chains, and
|
||||||
|
optional Discord webhook notifications.
|
||||||
|
|
||||||
- a user explicitly mentions the assistant
|
## Highlights
|
||||||
- a new comment changes the thread enough that the responder decides a reply is
|
|
||||||
useful
|
|
||||||
|
|
||||||
It supports multi-repo configuration, responder fallback chains.
|
- Poll GitHub issues across multiple repositories
|
||||||
It can also emit non-fatal Discord webhook notifications for issue assistant
|
- Trigger replies from mentions or meaningful thread updates
|
||||||
events such as mentions, replies, no-reply decisions, and responder failures.
|
- Run planning and bug-verification flows in isolated worktrees
|
||||||
|
- Send optional Discord notifications for assistant events
|
||||||
## Features
|
|
||||||
|
|
||||||
- Agent Orchestrator style YAML config with `defaults` and `projects`
|
|
||||||
- Multiple repositories in one process
|
|
||||||
- Comment-triggered issue assistance
|
|
||||||
- Planning / architecture guidance in issue threads
|
|
||||||
- Bug verification flows in isolated temporary git worktrees
|
|
||||||
- CLI-based responder fallback chain
|
|
||||||
- Optional Discord webhook notifications
|
|
||||||
- Durable state with `drift` + SQLite
|
|
||||||
- BDD-style tests using `package:test` with Given / When / Then wording
|
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
|
|
@ -35,11 +23,9 @@ events such as mentions, replies, no-reply decisions, and responder failures.
|
||||||
|
|
||||||
## Config
|
## Config
|
||||||
|
|
||||||
Create a local `agent-orchestrator.yaml` and follow [`/examples/README.md`](examples/README.md) as a starting point.
|
Create a local `agent-orchestrator.yaml` and use
|
||||||
|
[`examples/README.md`](examples/README.md) plus
|
||||||
Notification config lives under `defaults.issueAssistant.notifications` or
|
[`examples/simple-github.yaml`](examples/simple-github.yaml) as the reference.
|
||||||
`projects.<key>.issueAssistant.notifications`. Supported events are
|
|
||||||
`mention_detected`, `reply_posted`, `no_reply`, and `responder_failed`.
|
|
||||||
|
|
||||||
Generate a starter config:
|
Generate a starter config:
|
||||||
|
|
||||||
|
|
@ -86,13 +72,6 @@ dart analyze
|
||||||
dart test
|
dart test
|
||||||
```
|
```
|
||||||
|
|
||||||
All Dart tests under `test/` must follow the repo's Gherkin doc-comment format:
|
|
||||||
|
|
||||||
- `group(...)` has a `Feature` doc block above it
|
|
||||||
- `test(...)` has a `Scenario` doc block above it
|
|
||||||
- runtime names stay plain, without `Feature:` or `Scenario:` prefixes
|
|
||||||
- test bodies include `Given` / `When` / `Then` inline comments
|
|
||||||
|
|
||||||
## ref
|
## ref
|
||||||
|
|
||||||
[agent-orchestrator](https://github.com/ComposioHQ/agent-orchestrator)
|
[agent-orchestrator](https://github.com/ComposioHQ/agent-orchestrator)
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue