Design Specifications¶

This directory contains design specifications and architectural proposals for the Foreman project.

Table of Contents¶

01-agent-harness¶

The core specification for the Foreman project.

• Objective: Build a minimal Python harness for always-on AI co-maintainers that handles process lifecycle, credential injection, and message routing.
• Key Documents:
  • Specification: Technical details and requirements.
  • Idea: Problem statement and recommended direction.
  • Plan: Implementation roadmap.
  • Todo: Tracked tasks.

02-messaging-update¶

A proposal for improving the messaging system.

• Objective: Address the issue where messages sent to disconnected nodes are lost.
• Key Documents:
  • Idea: Problem statement regarding the wire protocol and recovery mechanisms.