Skip to content

docs: document HARD GATE archival in Scribe workflow #69

@diberry

Description

@diberry

Summary

The HARD GATE archival feature (two-tier threshold-based archival in the Scribe workflow) was shipped but has no documentation on the docs site.

Source

What needs documenting

  1. New docs page (or section in existing Scribe docs) explaining HARD GATE archival
  2. Two-tier threshold behavior: 20KB → archive >30 days, 50KB → archive >7 days
  3. How it integrates with the Scribe workflow (step 1 in Scribe spawn)
  4. The archiveDecisions() function contract
  5. Heading-aware archival behavior

Acceptance criteria

  • Docs page explains HARD GATE concept and two-tier thresholds
  • Examples showing what happens when decisions.md grows
  • Cross-links to Scribe documentation and decisions workflow
  • Navigation entry added
  • docs-quality tests pass

Requirements

  • Independent PR (single commit, squashed)
  • Full team review (Flight + FIDO) before merge

Metadata

Metadata

Assignees

No one assigned

    Labels

    go:needs-researchNeeds investigationsquadSquad triage inbox — Lead will assign to a membersquad:archiveResolved by upstream or no longer applicablesquad:dskyAssigned to DSKY (TUI Engineer)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions