From a59c5ff0aa283be4ce383844554a8094a92bfa70 Mon Sep 17 00:00:00 2001 From: Alex Blank Date: Mon, 27 Jul 2026 15:24:00 +0200 Subject: [PATCH] docs: refresh README --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..1f2c934 --- /dev/null +++ b/README.md @@ -0,0 +1,30 @@ +# AgentHub + +> **Status: specification-only baseline.** This repository does not yet contain a runnable AgentHub implementation. + +AgentHub is specified as a self-hosted, general-purpose platform for orchestrating and governing agent workflows. The initial reference workflow is Gitea issue-to-specification-to-pull-request automation for small engineering teams; the specification also calls for non-Git workflows such as webhook processing, scheduled monitoring, and document generation. + +## What is in this repository + +- [`agent_hub_spec.md`](agent_hub_spec.md) — the accepted AgentHub v0.3 baseline and primary product specification. +- [`git_agent_hub_spec.md`](git_agent_hub_spec.md) — an earlier/alternate specification using the working name **RepoPilot**. + +The two documents describe intended architecture, workflows, security boundaries, and deployment goals. They are not an implementation contract. + +## Current limitations + +There is no application source, package manifest, Compose file, Dockerfile, Makefile, test suite, or executable configuration in this checkout. Consequently, there are no verified prerequisites or setup, run, test, configuration, or deployment commands to provide. + +Docker Compose deployment is a design goal described by the AgentHub specification, not a currently available deployment method. Do not treat the specifications as instructions for operating a service. + +## Repository layout + +```text +. +├── agent_hub_spec.md # Accepted AgentHub baseline +└── git_agent_hub_spec.md # Earlier RepoPilot specification +``` + +## Next step + +Use `agent_hub_spec.md` as the baseline for implementation planning. Add operational documentation only with the implementation, its manifests, and verified commands.