Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

1.2 KB
Raw Blame

Design Plans

This directory archives the design plans behind significant PortOS features — a record of how and why each feature was designed, captured before implementation.

  • One file per plan, named YYYY-MM-DD-<slug>.md (date of approval).
  • Newest plans sort last by their date prefix.
  • Each plan typically opens with a Context section (the problem and intended outcome), then the architecture, data model, and a verification section.

Index of plans other docs point at:

  • 2026-10-18 — local-first merge gate: the CI/test latency audit and the six changes behind the test memo, the resource suites in pregate, and the pregate attestation CI honors.

  • 2026-10-20 — CoS task queue to PostgreSQL: why TASKS.md / COS-TASKS.md outgrew their files, the single cos_tasks table that replaced them (and the interim archive), and the migrations that bring existing installs to it.

These are point-in-time design records, not living docs — they are not updated to track implementation drift. For current behavior, see the code, CLAUDE.md, and the topic docs elsewhere under docs/.