chore: reorganize — tools/ subfolder, README as central index with linked projects

README.md

@@ -1,26 +1,40 @@
 # hans-tools
 
-Personal tooling for Hans — GitHub PR monitoring, automation hooks, and utilities.
+Central reference for all tools built for Hans — small utilities live here,
+larger standalone projects are linked below.
 
-## Tools
+---
+
+## Small Tools (`tools/`)
 
 | Tool | Description | Status |
 |---|---|---|
-| `gh-monitor` | Polls GitHub for PR activity and notifies Hans via OpenClaw | Spec review |
+| [gh-monitor](tools/gh-monitor/) | Polls GitHub for PR activity, notifies Hans via OpenClaw | Spec review |
+
+---
+
+## Larger Projects
+
+| Project | Repo | Description | Status |
+|---|---|---|---|
+| the-agency | [coding-with-hans-heinemann/the-agency](https://github.com/coding-with-hans-heinemann/the-agency) | Tiered multi-agent orchestration pipeline (T1–T5) | Phase 2 complete |
+
+---
 
 ## Structure
 
 ```
 hans-tools/
-├── gh-monitor/           # GitHub PR polling monitor
+├── tools/                  # Self-contained small tools
-│   ├── design.md         # Design doc
+│   └── <tool-name>/
-│   ├── buildspec.md      # Build spec
+│       ├── design.md
-│   └── ...               # Implementation (pending review)
+│       ├── buildspec.md
-└── README.md
+│       └── ...
+└── README.md               # This index
 ```
 
-## Principles
+## Conventions
 
-- Every tool has a design doc and build spec reviewed before implementation
+- Every tool has a `design.md` and `buildspec.md` reviewed before implementation
-- No secrets in the repo — all credentials via environment variables
+- No secrets in the repo — credentials via environment variables only
-- Tools run as cron jobs or daemons managed by OpenClaw
+- All work on feature branches (`hans/...`), never directly to `main`