Skip to content

Add identity layer (wisdom.md + now.md) to .squad/ structure #107

Closed

Description

@bradygaster

Context

During the v0.4.2 release session, the team reviewed Brady's Memory Architecture Upgrade proposal. Keaton, Verbal, and Fenster all agreed that wisdom.md and now.md are the two files worth shipping from the proposal — everything else (hooks, social modeling, RAG, JSONL) was rejected.

The team originally planned this for v0.6.0, but Brady pointed out that v0.5.0 (the .ai-team/ → .squad/ rename) is the natural time to add these — we're already touching every path and the migration tool can scaffold them.

What

Add two files to the .squad/ directory structure:

.squad/identity/now.md

  • What the agent is currently focused on
  • Updated at session start and when focus shifts
  • Read by coordinator + agents at spawn time
  • Minimal schema: frontmatter (updated_at, focus_area, active_issues) + narrative

.squad/identity/wisdom.md

  • Learned heuristics and patterns (NOT transcripts)
  • Appended when agents identify reusable lessons
  • Read by agents at spawn time alongside decisions.md
  • Minimal schema: frontmatter (last_updated) + categorized entries
  • Verbal's insight: prototype by restructuring history.md's existing learnings sections

Implementation

  • Define minimal YAML frontmatter schema for both files
  • Add to squad init scaffolding (index.js)
  • Add to squad upgrade --migrate-directory flow
  • Update spawn template in squad.agent.md to read these files
  • Add templates to .squad-templates/ (or equivalent)
  • Update docs

Team Analysis

  • Keaton: 'The rename enables this — adding subdirectories under .squad/ is a clean follow-on.'
  • Verbal: 'wisdom.md could be prototyped by restructuring history.md sections.'
  • Fenster: Feasible, ~9 hours estimated for both files. No runtime changes needed — just file reads at spawn time.

Parent

Part of #69 (v0.5.0 .ai-team/ → .squad/ rename)

Activity

  1. added this to the v0.5.0 milestone on Feb 20, 2026
  2. bradygaster commented on Feb 20, 2026

    @bradygaster
    CollaboratorAuthor

    Implemented by PR #121 (merged to dev). Identity files .squad/identity/now.md and wisdom.md now scaffolded on both init and upgrade. Tests added in test/init-flow.test.js.

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions