# prj-unattended-progress-company — Agent Instructions

## Repo Identity

**Purpose:** Temporary cross-repository project to make Binky Hedgehog GmbH a
profitable, self-organizing company with minimal CEO time and governance.

**Domain:** infotech  
**Repo slug:** `prj-unattended-progress-company`  
**Workplan prefix:** `UPC-WP-`  
**Primary durable partner:** `binky-control` (company control plane / canon)

---

## State Hub Integration

The Custodian State Hub tracks work across domains. Prefer HTTP REST and the
`statehub` / `custodian` CLI. MCP (`dev-hub`) is optional.

| Context | URL |
|---------|-----|
| Local workstation | `http://127.0.0.1:8000` |
| Remote (railiance01, in-cluster) | `http://10.43.68.154:8000` |
Canonical health endpoint: `/state/health` (not `/health`).

### Orient at session start

```bash
# Offline brief when present
cat .custodian-brief.md 2>/dev/null || true

# Project goal (authoritative outcome)
cat GOAL.md

# Active workplans for this repo (after registration)
curl -s "http://127.0.0.1:8000/repos/prj-unattended-progress-company/dispatch" \
  | python3 -m json.tool

# Inbox
curl -s "http://127.0.0.1:8000/messages/?to_agent=prj-unattended-progress-company&unread_only=true" \
  | python3 -m json.tool
```

### Log progress (required at session close)

```bash
curl -s -X POST http://127.0.0.1:8000/progress/ \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "what was done",
    "event_type": "note",
    "author": "agent",
    "workplan_id": "<uuid-or-omit>",
    "task_id": "<uuid-or-omit>"
  }'
```

After workplan file changes:

```bash
statehub fix-consistency
```

---

## Session Protocol

**Start:**
1. Read `GOAL.md` — outcome, invariants, success gates, retirement.
2. Read `SCOPE.md` — authority boundary and participating repos.
3. Scan `workplans/` for `ready` / `active` / `blocked` items.
4. Prefer advancing Green/Blue work; package Yellow; batch Orange; never
   invent Red-lane authority.

**During work:**
- Implementation lands in participating repos, not here.
- Link child workplans by stable ID; do not duplicate their task lists.
- Record binding cross-repo decisions as work records (decision docs /
  hub decisions) with evidence.

**Close:**
1. Update workplan task statuses in files.
2. Hand off residuals as live work records before finishing a workplan.
3. `POST /progress/` with a concrete summary.
4. `statehub fix-consistency` when workplan files changed.

---

## Security

Before requesting credentials, use `warden route find "<need>" --json` when
available. Never record secret values in project files, State Hub, workplans,
evidence, or chat.

<!-- REPO-AGENTS-EXTENSIONS -->

## Project protocol

This is a temporary **project** repository. It has `GOAL.md`, not `INTENT.md`.

Read order at session start:

1. `GOAL.md`
2. `SCOPE.md`
3. Active files under `workplans/`
4. Relevant sections of `binky-control` only when advancing a linked gate

Complete only when every `GOAL.md` retirement condition is met with evidence.