Skip to content

Epic: Organisational memory (conventions, expertise, conflicts) #16

Open
6 of 9 issues completed
Open

Description

@AlanEdward19

Goal

Turn raw PR/issue/commit docs into team knowledge: unwritten conventions, who knows what, and which source wins when they disagree. Zero-LLM by default; an LLM is an optional upgrade. Every answer stays source-linked.

Issues

Issue What Depends on
#84 Path facts (PR file lists + paths index table) foundation: which files each doc touches, who, in which role –
#85 People aliases (people config, waymark people) one person across git names / logins –
#89 Optional LLM provider (llm config, waymark llm test) shared with epic #19 –
#91 Supersession signals (ADR status, reverts, supersedes on notes) conflict foundation –
#86 Expertise map (waymark experts, MCP who_knows) who knows a path #84, #85
#87 Convention candidates from review comments + accept/reject unwritten conventions #84, #85
#88 Conventions for agents (MCP conventions, start-up context) #87
#92 Conflict-aware ranking (authority, supersession, proximity) which source wins #84, #91

Order: #84, #85, #89 and #91 in parallel → #86, #87, #92 → #88. #84 and #91 both add an index schema version: whichever merges second bumps the number again.

Conventions for every issue

  • Derived data lives in the index (rebuildable by waymark reindex) or in wiki docs under derived/; connector documents are never edited by derivation (the next sync would overwrite them).
  • No new runtime dependency; no LLM required for any acceptance criterion.
  • New user-facing behaviour is documented in docs/memory.md (created by the first issue that needs it) and in the README command table.

Definition of done

  • waymark experts src/index on this repo names the people who changed it, with evidence ids.
  • On a fixture with repeated review comments, a convention is derived, accepted, and shown in the agent start-up context.
  • A superseded ADR ranks below its replacement and is marked in search results.
  • Everything works with no llm configured.

Evidence

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: knowledgeStore, indexes, retrieval, memory tiersepicLarge feature split into smaller issuespriority: lowNice to have

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions