Skip to content

v0.16.0: knowledge pipeline — capture skill, explore→proposed/, lane discipline#8

Open
milstan wants to merge 1 commit into
mainfrom
milstan/knowledge-pipeline-fix
Open

v0.16.0: knowledge pipeline — capture skill, explore→proposed/, lane discipline#8
milstan wants to merge 1 commit into
mainfrom
milstan/knowledge-pipeline-fix

Conversation

@milstan

@milstan milstan commented May 26, 2026

Copy link
Copy Markdown
Contributor

Why

The shared knowledge base hasn't been getting updated. Diagnosis:

  • The cold-lane consolidator (.github/workflows/dream-light.yml + dream.yml) was deleted in leadbay/knowledge on 2026-05-01 with no local replacement. Result: wiki/, glossary.md, index.md, log.md frozen for 25 days while 288 journal entries piled up underneath.
  • The README references /knowledge-capture and /knowledge-dream — neither existed.
  • /knowledge-explore (the only skill that actively documents new surfaces) wrote directly to wiki/, breaking the two-lane discipline that's enforced everywhere else.
  • Only /relentless and /diagnose ever called lb-learnings-log, so the journal pipeline was fed by exactly two skills.

This PR fixes the producer side. The consolidator side is restored in a parallel PR on leadbay/knowledge (re-adding the workflows).

What

  • New /knowledge-capture — session-end durable-learning capture. Calls lb-learnings-log per insight; the launchd sync ships them to journal/; the dream promotes. Skip-on-no-discovery is the expected outcome for most sessions. Hard cap of ~5 captures per session per the "would save a future agent 10 min" filter.

  • /knowledge-explore v3.0.0 — rerouted output from wiki/journey/, wiki/concept/vocabulary.md, wiki/pitfall/ to proposed/<concept>/proposals/... with force_promote: true. Phase 6 (Persist) is now hot-lane only.

  • lb-knowledge-write — added --force-promote flag to the proposed subcommand. Emits force_promote: true in the proposal frontmatter so the dream's light pass promotes it on the next push without waiting for cross-source quorum (which is meant to catch accidental drift, not penalise deliberate live tours).

  • /knowledge-find — removed stale reference to a non-existent Stop hook.

What's NOT here

  • The working-with-milan skill that wires /knowledge-find/knowledge-question/knowledge-explore/knowledge-capture into explicit session-start / mid / end invocation points. That lives at ~/.claude/skills/working-with-milan/ on Milan's machine and isn't in any git repo. Each team member's equivalent skill should mirror the block.

  • Adding lb-learnings-log calls to other skills (/ship, /qa, /codex, /retro, etc.). Deliberate — those are gstack-upstream skills and would drift on update. The right path is /working-with-<owner> invoking /knowledge-capture at session end.

Test plan

  • Confirm bin/lb-knowledge-write proposed --force-promote ... emits force_promote: true in the YAML frontmatter.
  • Confirm ~/.leadbay-skills/setup --update after merge installs knowledge-capture/.
  • After the parallel leadbay/knowledge PR merges (restoring the dream workflows), invoke /knowledge-explore against any small surface and verify a proposed/<concept>/... file is created and promoted by dream-light.

🤖 Generated with Claude Code

…ne discipline

The shared knowledge base wasn't getting updated because the cold-lane
consolidator was deleted in 2026-05-01 with no replacement and no skill
captured durable learnings except /relentless + /diagnose. Three skills
referenced in the knowledge repo's README never actually existed
(/knowledge-capture, /knowledge-dream) or wrote to the wrong lane
(/knowledge-explore wrote directly to wiki/).

This change wires the producer side; the consolidator side is restored
in leadbay/knowledge in a parallel PR.

- new /knowledge-capture: session-end durable-learning capture. Calls
  lb-learnings-log so the launchd sync ships entries into journal/ and
  the dream folds them into wiki/. Skip-on-no-discovery is the expected
  outcome for most sessions.

- /knowledge-explore v3.0.0: rerouted from wiki/journey/, wiki/concept/,
  wiki/pitfall/ to proposed/<concept>/proposals/ with force_promote: true.
  The cold lane is the dream's exclusive domain — explore is a hot-lane
  producer like everything else.

- lb-knowledge-write: added --force-promote to the proposed subcommand so
  /knowledge-explore can mark its evidence-heavy output for immediate
  promotion (the dream's quorum check is for accidental drift, not for
  deliberate live tours).

- /knowledge-find: removed stale reference to a non-existent Stop hook.

Teammates whose harness doesn't run UserPromptSubmit hook should wire
/knowledge-find into their own session-start equivalent. The
working-with-milan skill carries the full invocation protocol; mirror it
in your team's equivalent skill.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant