Skip to content

feat: critical file resilience framework — architecture, tests, and CI gates #732

Closed

Description

@diberry

Overview

Issue #730 exposed a class of bugs where squad.agent.md can silently disappear after upgrade/init. The immediate fix is tracked in #730/#731, but the root cause is systemic: the CLI lacks a principled approach to critical file integrity.

This issue tracks the systemic fix — a tiered resilience framework that prevents this class of bugs for all critical files, not just squad.agent.md.

Goals

  1. Architecture principles — define which files are critical, what invariants they must satisfy, and how the CLI enforces those invariants
  2. Test principles — establish test patterns that catch silent degradation before it ships
  3. CI gates — automated checks that block PRs introducing silent-skip patterns

Linked Issues

Deliverable

A tiered PRD with concrete implementation specs for each layer:

See PRD in docs/proposals/critical-file-resilience.md (to be created).

Activity

  1. diberry commented on Apr 1, 2026

    @diberry
    ContributorAuthor

    Closing as subset of #670 (Versioned File Layout Manifest). The critical file resilience requirements from this issue fold naturally into #670's architecture — the manifest already defines canonical paths, and silent-disappearance is a failure mode within that framework. Specific items: Tier 1 (immediate bug fixes) tracked in #730/#731. Tier 2/3 (framework + CI gates) absorbed by #670 Phases 2-3. PRD written at docs/proposals/critical-file-resilience.md — its principles (fail-loud, empty=missing, recovery cascade) should inform #670's implementation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or improvement

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions