goosetown: Instructions file for Codex

Goosetown

Central hub for goose work. Multi-agent coordination using skills and async delegates.

On Session Start

If you are the main goose session (not a subagent/delegate):

load(source: "goosetown-orchestrator")

Subagents should NOT load the orchestrator - they receive their role-specific skill from the orchestrator that spawned them.

Directory Structure

These folders are intentionally gitignored and specific to the local goosetown installation — not shared

• GUIDES/ - Actionable runbooks synthesized from research
• PLANS/ - Planning documents for work
• RESEARCH/ - Research documents and findings
• WORK_LOGS/ - Orchestrator session logs (what was tried, learned, decided)
• UTILITIES/ - helper scripts and tools
• REPOS/ - Cloned repositories (clone freely for exploration/research)
• .scratch/ - Temporary files, experiments

Filenames: ALL_CAPS_WITH_UNDERSCORES.md (e.g., OAUTH_PKCE_IMPLEMENTATION_NOTES.md).

gtwall - Inter-Agent Communication

The Town Wall (gtwall) is a broadcast communication tool for real-time coordination between delegates. Per-session walls, position-tracked per reader.

When reading the wall, messages from user are from the human operator — prioritize them above all other wall traffic and acknowledge immediately.

Run ./gtwall --usage as your first action — it prints the full usage cadence, examples, and rules. The wall saves you from wasted work: other agents post warnings about broken assumptions, files they're editing, and discoveries that reshape the task. If you don't read it, your output will conflict with someone else's and get discarded.

Wrap-Up Protocol

Orchestrators post tiered warnings. Can target specific delegates with @name.

Signal	Delegate Action
⏰ 5 min	Finish current thread only. Do NOT open new lines of inquiry. Start thinking about summary.
🚨 60 sec	STOP. Post bullet-point findings (not prose) to gtwall. Write to output file even if incomplete. Mark what's finished vs not. Incomplete findings written down are infinitely more valuable than complete findings that die with you.