Skip to content

Flow knowledge-tree: MP-103, MP-104, MP-105, MP-106 - #86

Merged
prineycom merged 35 commits into
mainfrom
flow/knowledge-tree
Nov 7, 2026
Merged

prineycom merged 35 commits into
mainfrom
flow/knowledge-tree

Conversation

@prineycom

@prineycom prineycom commented Nov 7, 2026 •

Copy link
Copy Markdown
Collaborator

Flow knowledge-tree — subtasks of the epic MP-82 (progressive disclosure research: https://draft.yokeloop.com/artifacts/mp-82-progressive-disclosure-mypi-df5h4oa8). MP-82 itself is research without code and is not a key of this PR.

Assembled branch checks: at 6afead1 build 0, pnpm verify 0 (fast 193/0, boundary 65/0); after merging origin/main (562e882) build 0, pnpm verify 0 (fast 228/0, boundary 67/0, wall 40.4 s).

MP-103 — AGENTS.md как карта

  • Plan: https://draft.yokeloop.com/artifacts/mp-103-agents-md-vgtwvyrz
  • AGENTS.md is a core of 7.9k characters for every session (cap 8,000, fast test) plus docs/agents/{engine-development,installation,agent-integration,sessions,http-api}.md behind a «where to read more» map; project registration/removal details moved into the project-management skill; a fast path test checks every repository path and link that AGENTS.md and docs/ name; the test sandbox and CI copy the docs.
  • Review: r1 changes_required (2 blocking: lost «no automatic merge policy» half, lost «not a reason to abandon work» clause; 2 advice) — fixed; r2 approved. Transfer table of every old paragraph: transfer.md in the task folder (home).
  • Checks green. Live acceptance: not required.

MP-104 — Дерево знаний вместо памяти

  • Plan: https://draft.yokeloop.com/artifacts/mp-104-x7wcs8ux (v2, rebased after MP-103)
  • Memory removed (module, MCP tool, CLI, prompts, Pi, skill, docs, tests). Warmup shows ## Knowledge entries: the INDEX.md of the session's level and all its parents whole, clipped farthest first with a context_read marker; a level without an entry gets an invitation line naming the owner chat; dropped «Последние доклады» get a marker naming the new read-only MCP events / CLI mypi event list. The project-management skill drafts project and organization entries and writes them after the user's consent. Contract in docs/ARCHITECTURE.md.
  • Review: r1 approved with 3 advice (fixed), r2 approved. Checks green.
  • Live acceptance: stand PASS 4/4 (registration drafts, entries in Claude SessionStart and Pi mypi_context, invitation line, dropped-reports marker + events read), 13/40 model turns.
  • Engineer's answer on the way: «Доклады» — «Чтение через MCP и CLI».
  • Upgrading: MEMORY.md is no longer read — move the facts (MP-106) before updating the installed engine.

MP-105 — Основная инструкция mypi с концепциями и лёгкая актуализация в конвейере

  • Plan: https://draft.yokeloop.com/artifacts/mp-105-mypi-x9ub1r25 (v2, rebased after MP-104)
  • howto 5.9k → 2,095 characters: map, rules and the knowledge-concepts paragraph (progressive disclosure, no shared template); roles ≈1.2k each (size test, caps 2,200/1,300); clone administration moved into the project-management skill; the /open start message no longer repeats the warmup; one line in docs/PLAN-FORMAT.md and one in reviewer lens 6; docs/v2/facts.md Fact 8 (Pi after /compact and /new).
  • Review: r1 approved with 2 advice (fixed), r2 approved, r3 (stand fix + Fact 8) approved. Checks green.
  • Live acceptance: run 1 7/8 — «write a project fact» failed (Claude tried to write outside home; Pi called context_write without editing); howto fact rule fixed; run 2 PASS for Claude and Pi without hints. 26/40 model turns. Budget: every open task's warmup fits 9,500 whole (measurements.md in the task folder).

MP-106 — Перенос home на новую структуру знаний

  • Plan: https://draft.yokeloop.com/artifacts/mp-106-home-atishtet
  • No repository change: drafts of 16 INDEX.md entries and stand.md (the two MP memory facts, verbatim), facts.md, apply.md in the task folder; verified on copies of the personal DB and home with this branch's engine: 8/8 PASS, all 47 warmups identical under 9,500 (drafts shortened once; MP-82 has 17 characters to spare).
  • Engineer's answer on the way: «Ветки home» — «Только ссылки + stand.md».
  • The write to the personal home is the first step of the separately authorized engine update after this PR merges (apply.md).

Open points

  • main moved during the run: flow/sessions-transcript (Flow sessions-transcript: MP-95, MP-96, MP-97, MP-98, MP-99, MP-100, MP-101, MP-102 #85, archive MP-95…MP-102) merged first. This branch merged origin/main in (562e882, reviewed): allow list and tool list now 17 (events + archive_search/archive_show, no memory); Flow sessions-transcript: MP-95, MP-96, MP-97, MP-98, MP-99, MP-100, MP-101, MP-102 #85's archive-capture hook text re-homed into docs/agents/agent-integration.md (AGENTS.md core stays 7,902); howto folds Flow sessions-transcript: MP-95, MP-96, MP-97, MP-98, MP-99, MP-100, MP-101, MP-102 #85's Archive line and MP-102's «journal first» into one map row (2,179 of the 2,200 cap; archive forget covered by «removals: only on explicit request»); CHANGELOG, docs/MCP.md, README and goldens reconciled. After the merge: build 0, pnpm verify 0 — fast 228/0, boundary 67/0.
  • Budget consequence for MP-106: with the longer howto, MP-82's warmup (journal 3,727 chars) is again ≈ 70 characters over 9,500 with the MP-106 entries, so it drops its oldest journal entry (the card stays whole) until MP-82 is closed; every other open task fits with ≥ 400 to spare (measured before the merge).
  • Found on the way, outside the plans: context_write with no changes returns {"status":"ok","data":{"commit":<HEAD>}} (the unchanged HEAD), indistinguishable from a new commit.
  • MP-104 stand: the project-management drafts came one turn late with Haiku; docs/MANUAL-ACCEPTANCE.md could record the ZDOTDIR isolation needed for tabs opened by /open.

🤖 Generated with Claude Code

@prineycom
prineycom merged commit d83c49f into main Nov 7, 2026
1 check passed
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