night-market-collective-memory

Night Market Collective Memory

This repo treats GitHub Discussions as agent collective memory

(ADR-0007, docs/adr/0007-github-discussions-integration.md,

accepted 2026-02-19). Sessions are amnesiac by default. The memory

system fixes that with four layers: Discussions (cross-session,

searchable), the decision journal (append-only tradeoff and lesson

logs), numbered ADRs (architecture decisions), and dated research

syntheses in docs/research/. One caveat on the fourth layer:

docs/research/ is gitignored and machine-local, so it exists only

on the authoring machine and is empty on fresh clones. A synthesis

counts as collective memory only after promotion to a Discussion,

ADR, or rule. This skill tells you where each kind of knowledge

lives, how to read it, and how to write to it.

One hard fact first: there is NO gh discussion subcommand.

Discussions are GraphQL-only. Minister playbooks once referenced a

CLI that does not exist, and ADR-0007 replaced every reference with

gh api graphql calls. Never guess a gh discussion command.

Routing table: which memory layer

| You have | Record or read it via |

|----------|----------------------|

| Settled battle, revert, dead end | night-market-failure-archaeology skill (read only, do not relitigate) |

| Tradeoff (chose A, sacrificed B) | Decision journal docs/tradeoffs.md, TR-NNN entry |

| Lesson, failed approach, rework | Decision journal docs/lessons-learned.md, LL-NNN entry |

| Architecture decision | Numbered ADR in docs/adr/ (0001-0017 exist today) |

| Session insight, skill stats | [Learning] Discussion (auto-posted daily, see below) |

| Strategy debate, big design | [War Room] Discussion (Decisions category) |

| Durable synthesis, audit result | [Knowledge] Discussion (Knowledge category) |

| PR review finding worth keeping | [PR Finding] Discussion (Learnings category) |

| Multi-source research output | Dated file in docs/research/ (LOCAL ONLY: gitignored, absent on fresh clones). Promote durable syntheses to a [Knowledge] Discussion, ADR, or rule to make them collective memory |

Retrieval discipline: search before re-investigating

Before investigating any question about this repo's history, design,

or past failures, run these searches first. Re-deriving a settled

answer wastes a session and risks contradicting an accepted decision.

# 1. Search Discussions by keyword (tested 2026-07-02)
gh api graphql -f query='
query($q: String!) {
  search(query: $q, type: DISCUSSION, first: 10) {
    nodes { ... on Discussion { number title url category { name } } }
  }
}' -f q='repo:athola/claude-night-market YOUR SEARCH TERMS'

# 2. Search local docs of record. Note: docs/research/ is gitignored
#    and machine-local, so it is empty on fresh clones and this
#    search only helps on the authoring machine.
rg -il "your terms" docs/research/ docs/adr/ CHANGELOG.md

# 3. Check the decision journal (if the files exist yet, see below)
rg -in "your terms" docs/tradeoffs.md docs/lessons-learned.md

Also check the night-market-failure-archaeology sibling for

settled battles. A leyline SessionStart hook

(plugins/leyline/hooks/fetch-recent-discussions.sh) already

injects the 5 most recent Decisions discussions at session start,

bounded to under 600 tokens with a 3-second timeout.

Discussion taxonomy (verified live 2026-07-02)

Repo categories include the four ADR-0007 ones (Decisions,

Deliberations, Learnings, Knowledge) plus GitHub defaults. Title

prefixes are the working taxonomy:

| Prefix | Category | What it is | Verified examples |

|--------|----------|------------|-------------------|

| [Learning] | Learnings | Daily digest, auto-posted | #601, #602 (2026-07-01/02) |

| [Knowledge] | Knowledge | Durable syntheses | #448, #449 (April 2026 skill audit synthesis and Wave-3 backlog) |

| [War Room] | Decisions | Strategy deliberations | #222 (collective memory design), #271 (wiring publishing into workflows) |

| [PR Finding] | Learnings | Review findings worth keeping | #424, #595 |

The [Learning] pipeline

Daily digests are auto-posted by abstract's Stop hook, part of the

improvement feedback loop (Issue #69). The chain:

1. plugins/abstract/hooks/skill_execution_logger.py

(PreToolUse/PostToolUse) logs skill executions.

1. plugins/abstract/scripts/aggregate_skill_logs.py writes

~/.claude/skills/LEARNINGS.md with skill-performance stats

(skills analyzed, high-impact issues, slow and low-rated skills).

1. plugins/abstract/hooks/post_learnings_stop.py (Stop hook,

registered in plugins/abstract/hooks/hooks.json) posts a

[Learning] YYYY-MM-DD digest, deduplicated by title. Opt-out:

~/.claude/skills/discussions/config.json.

1. Promotion: 3 or more fire-emoji reactions on a Learnings

discussion promote it to a GitHub Issue via

plugins/abstract/scripts/promote_discussion_to_issue.py

(default threshold 3, configurable via promotion_threshold).

Reading Discussions (tested queries)

List recent discussions, newest first (tested 2026-07-02, returned

#602 and siblings):

gh api graphql -f query='
query($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    discussions(first: 10,
                orderBy: {field: CREATED_AT, direction: DESC}) {
      nodes { number title category { name } createdAt url }
    }
  }
}' -f owner=athola -f name=claude-night-market

Fetch one discussion by number. The number is a GraphQL Int, so

pass it with -F (typed), not -f (string). Passing -f fails

with a type error:

gh api graphql -f query='
query($owner: String!, $name: String!, $number: Int!) {
  repository(owner: $owner, name: $name) {
    discussion(number: $number) {
      title body url category { name }
      comments(first: 10) { nodes { body } }
    }
  }
}' -f owner=athola -f name=claude-night-market -F number=222

Writing Discussions (mutations: shapes verified, NOT executed)

Publishing rules from ADR-0007: prompt the user [Y/n] before any

create or comment (no auto-publish), cap bodies at 2000 words and

link to local files for detail, and pass all values as -f/-F

variables (never string-interpolate into the query).

Mutations need node IDs. Resolve them first (this read query was

tested 2026-07-02):

gh api graphql -f query='
query($owner: String!, $repo: String!) {
  repository(owner: $owner, name: $repo) {
    id
    hasDiscussionsEnabled
    discussionCategories(first: 25) { nodes { id name slug } }
  }
}' -f owner=athola -f repo=claude-night-market

Create a comment (mutation shape from the canonical leyline

templates, untested here to avoid posting):

gh api graphql -f query='
mutation($discussionId: ID!, $body: String!) {
  addDiscussionComment(input: {
    discussionId: $discussionId,
    body: $body
  }) {
    comment { id url }
  }
}' -f discussionId="$DISCUSSION_ID" -f body="$COMMENT_BODY"

Creating a discussion uses `createDiscussion(input: {repositoryId,

categoryId, title, body})` (same status: shape verified against the

canonical templates, untested here). For threaded replies, mark-as-

answer, and updates, use the canonical template file:

plugins/leyline/skills/git-platform/modules/command-mapping.md,

section "Discussion Operations". GitHub only: GitLab and Bitbucket

have no Discussions equivalent, so skip with a warning there.

Decision journal (leyline:decision-journal contract)

The contract lives in

plugins/leyline/skills/decision-journal/SKILL.md. Two append-only

logs, co-located with the code:

• docs/tradeoffs.md: decisions and the alternatives sacrificed.

Entry IDs TR-NNN, status proposed, then accepted, then

superseded-by: TR-NNN or deprecated.

• docs/lessons-learned.md: failed approaches and rework, framed

blamelessly. Entry IDs LL-NNN, status open, then actioned,

then closed.

Discipline: append-only, never edit or delete an accepted entry. A

reversal adds a new entry, flips the old one's status, and links

both ways. Every entry links to its PR, commit, or issue. Draft the

entry, show it to the human, and append only on confirm.

Status as of 2026-07-02: neither docs/tradeoffs.md nor

docs/lessons-learned.md exists in the repo yet. The contract is

defined and the files are created on first use (scaffolding belongs

to attune:project-init). The append helper:

python3 plugins/leyline/scripts/journal_append.py tradeoffs \
  --project-root . --title "Compliance check" \
  --field context="verify" --dry-run

Big decisions do not go in the journal. They get a numbered ADR in

docs/adr/, and a journal entry may reference the ADR number.

Monitoring: a starved digest is an alert

If the newest [Learning] discussion is more than about 2 days

old, treat it as an incident signal. Precedent: the digest was once

starved for two months because hooks read CLAUDE_TOOL_* env vars

Claude Code never sets, and the missing digest was the only visible

symptom (full record: night-market-failure-archaeology SB9; fix:

stdin-first shared/hook_io.read_hook_payload, CHANGELOG 1.9.14).

Check the gap with the tested list query above. If starved, verify

each chain segment in order: is ~/.claude/skills/LEARNINGS.md

fresh, is the Stop hook registered in

plugins/abstract/hooks/hooks.json, and does the logger receive a

stdin payload. Then follow night-market-debugging-playbook for

hook triage.

When NOT to use

• Settled failures, reverts, and dead ends you are tempted to

re-try: read night-market-failure-archaeology instead.

• Classifying or gating a change you are about to make: use

night-market-change-control.

• Running the hunch-to-accepted-result pipeline that produces

docs/research/ syntheses: use

night-market-research-methodology. This skill only covers where

the outputs are stored and retrieved.

• House style for the documents themselves: use

night-market-docs-and-writing.

Exit Criteria

• [ ] Before any re-investigation, a Discussions search and a

docs/research/ search ran, and hits (or "no hits") were stated.

• [ ] Any Discussions access used gh api graphql. Zero

gh discussion invocations appear in the transcript.

• [ ] New knowledge was routed per the routing table (correct layer

named before writing anything).

• [ ] Any journal write produced a stable TR-NNN/LL-NNN entry with

an index row, and no prior entry was edited or deleted.

• [ ] Any Discussion create or comment was confirmed by the user

first, and used -f/-F variables (no string interpolation).

• [ ] The newest [Learning] digest date was checked, and any gap

over 2 days was reported as a starvation alert.

Provenance and maintenance

Compiled 2026-07-02 against repo v1.9.15, branch

discussions-fix-1.9.14. Read queries in this file were executed live

against athola/claude-night-market on 2026-07-02. Mutation snippets

were checked against the leyline templates but not executed.

Re-verification one-liners for facts that may drift:

# Taxonomy and digest freshness (also the starvation check)
gh api graphql -f query='query($o:String!,$n:String!){repository(owner:$o,name:$n){discussions(first:5,orderBy:{field:CREATED_AT,direction:DESC}){nodes{number title createdAt}}}}' -f o=athola -f n=claude-night-market

# Decision journal files exist yet?
ls docs/tradeoffs.md docs/lessons-learned.md

# Promotion threshold still 3 fire reactions?
rg -n "promotion_threshold" plugins/abstract/scripts/promote_discussion_to_issue.py

# Stop hook still registered?
rg -n "post_learnings_stop" plugins/abstract/hooks/hooks.json

# Canonical GraphQL templates still present?
rg -n "Discussion Operations" plugins/leyline/skills/git-platform/modules/command-mapping.md

# ADR count and 0007 status
ls docs/adr/ && rg -n "^Accepted" docs/adr/0007-github-discussions-integration.md