Repository navigation
Open
6 / 96 of 9 issues completedOpen
6 / 96 of 9 issues completed
Copy link
Labels
area: knowledgeStore, indexes, retrieval, memory tiersStore, indexes, retrieval, memory tiersepicLarge feature split into smaller issuesLarge feature split into smaller issuespriority: lowNice to haveNice to have
Milestone
Description
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 underderived/; 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/indexon 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
llmconfigured.
Evidence
- Unblocked derives conventions from PR review feedback and maps expertise: https://getunblocked.com/
- PR review comments with file/line context are already ingested by the GitHub PR connector (MVP):
renderPullinsrc/connectors/github/index.ts.
Metadata
Metadata
Assignees
Labels
area: knowledgeStore, indexes, retrieval, memory tiersStore, indexes, retrieval, memory tiersepicLarge feature split into smaller issuesLarge feature split into smaller issuespriority: lowNice to haveNice to have
Activity
waymark experts <path>and MCP toolwho_knows#86conventionsand start-up context #88llmconfig) #89