Skip to content

feat: Generate decisions-index.md as separate summary file #28

@diberry

Description

@diberry

Problem

decisions.md has no compact summary. Agents must read the full file. An index inside the file fights the union merge driver (Scribe rewrites a section = mutable-in-place on an append-only file).

From

Flight review of #20 (A2 critique), Procedures review of #20.

Proposed

  1. Scribe generates decisions-index.md as a SEPARATE file (not inside decisions.md)
  2. Index format: compact table with Date | Topic | Status | By | Domain
  3. Regenerated wholesale on every Scribe merge (not append-only — full rewrite is safe)
  4. Spawn prompts reference the index for lightweight context
  5. Agents read index only; full decisions.md available on-demand
  6. Enables degraded mode: if decisions.md >50KB, agents read index only

Benefits

  • Union merge safe (index is regenerated, not appended)
  • ~2KB overhead vs ~86K for full file
  • Enables coordinator filtering (issue TBD)

Owner

EECOM (Core Dev) + Procedures (Prompt Engineer)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestgo:needs-researchNeeds investigationsquadSquad triage inbox — Lead will assign to a membersquad:flightAssigned to Flight (Lead)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions