$ show yan5xu/code-relay
Code Relay is a structured protocol for AI coding agents that enables self-bootstrapping, cross-session memory, multi-repo awareness, and safe scoped execution. It solves four core issues: cross-session amnesia via HANDOFF/CHECKPOINT mechanisms, limited context window through proactive state saving, lack of standardized workflow with defined processes like boot sequences and task management, and multi-repo blindness via a workspace structure that provides a global view of all repositories. The protocol operates in two modes: GitHub (using Issues and Project Board for state management) and Local (using files like STATUS.yml and HANDOFF.md). Key features include agent-led boot sequences, worktree isolation for task separation, sub-agent delegation to prevent context window overflow, and SCOPE-based write access control. The repository consists of Markdown and YAML templates that define workflows, configuration, and task structures, designed to be copied into a project and customized.
The LLM identified 2 files worth highlighting for reuse:
Defines a pattern for decomposing complex tasks into sub-agent tasks to avoid context window limits. Sub-agents communicate results via files, returning only a 4-line summary (status, report path, output count, decision points) to the main agent, preserving its context window while enabling parallel execution.
Establishes the core work protocol including HANDOFF for zero-loss context transfer across sessions (structured as 'completed/in progress/next steps/watch outs'), SCOPE for write access whitelisting to prevent unintended changes, and workflow standards like issue lifecycle management and branch naming conventions. This file isolates critical agent safety and context preservation mechanisms.