Skip to content

context loader: single strategy file — rename directives slot, drop priorities slot, refresh README+docs #876

Description

@kokevidaurre

Founder decision 2026-06-12 (org doc simplification)

The org direction stack went from 4 hand-maintained files to 2:

  • STRATEGY.md (company repo) + .agents/memory/company/directives.md → merged into ONE .agents/memory/company/strategy.md read by humans and agents (no two-audience drift — red-team finding hq#464).
  • per-squad priorities.md → ELIMINATED (deleted in hq); ordering lives inside goals.md (P0 first, 'Not now' at bottom). Goals are OKR-shaped and aspirational.

CLI changes

  1. Rename the context slot: load .agents/memory/company/strategy.md where the loader currently reads directives.md. A directives.md → strategy.md symlink exists in hq as a bridge, so this is non-urgent but should land before any new instance is provisioned (symlinks may not survive all transports). Keep a fallback read of directives.md for older workspaces.
  2. Drop the priorities slot: roles that loaded priorities.md (scanner/worker tier) should load goals.md instead. Files are gone in hq — verify the loader degrades gracefully on missing priorities.md TODAY (if it errors, this becomes urgent).
  3. README + docs refresh (founder-requested): the context-system documentation (README, docs site pages describing SYSTEM.md → SQUAD.md → priorities → directives cascade) must be regenerated to describe the new chain: SYSTEM.md → SQUAD.md → goals.mdcompany strategy.md → feedback → state → briefs. Trigger the docs generators (docs#3 pipeline / cli#843 dispatch) after the loader change merges.
  4. squads memory / squads goals help text mentioning priorities.md updated accordingly.

Acceptance

  • A squad run's injected context contains strategy.md content and goals.md for worker-tier roles; no missing-file warnings.
  • README + docs pages describe the 2-file model.

Source: founder + cofounder session 2026-06-12; canonical text in hq .agents/memory/company/strategy.md §Goals Discipline.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions