prj-unattended-progress-company/AGENTS.md

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

# 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)

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:

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.

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.