Knowledge Hub session log

2026-04-08 — pi-teams prompting system and cheap-executor experiments

Outcomes

• Added project-local pi-teams prompt modes: frontier-open, mixed-guided, budget-scaffolded
• Added project-local agent definitions and prompting skill for Knowledge Hub
• Ran a mixed-guided tags-related team experiment
• Found and fixed a real backend integration gap in tag-filtered home navigation
• Ran a cheaper-executor experiment using explicit openai-codex/gpt-5.4-mini
• Completed and reviewed the home-page cross-vault quick switcher slice
• Committed and pushed repo changes
• Stored durable playbooks and lessons in Knowledge Hub

Repo changes

• 6d8825d Improve tag-filtered search and cross-vault quick switcher
• f11997e Add Knowledge Hub team prompting playbooks

Knowledge captured

• playbooks/pi-team-lead-playbook.md
• playbooks/cheap-executor-decision-checklist.md
• lessons/pi-teams-prompting-and-cheap-executor-lessons.md
• raw capture in inbox/2026/04/08/knowledge-hub-session-pi-teams-prompt-modes-and-cheap-executor-experiment.md

Key lessons

• Outcome-first prompting plus justified constraints was sufficient.
• Repo audits should happen before assigning roadmap slices.
• Cheap executors work well for bounded, visible, low-risk slices with strong review.
• Use provider-qualified model IDs for smaller-model experiments.

2026-04-08 — simplification decision

Decision

• Do not restart in a fresh repo.
• Reframe Knowledge Hub around the simpler core idea: a shared, web-accessible, markdown-first wiki for humans and agents.

Why

• The foundation is already right: markdown on disk, git history, remote HTTP access, and durable wiki pages.
• The main complexity problem is in workflow framing, not the substrate.

Artifact

• projects/knowledge-hub/simplification-plan.md

Next step

• Use a team to execute the simplification plan as a sequence of bounded changes instead of attempting a rewrite.

2026-04-08 — simplification wave 1 landed

Outcome

• Accepted and landed Wave 1 of the simplification plan.
• This wave stayed intentionally bounded: docs/skills reframing plus small UI copy updates.
• No backend rewrite, endpoint churn, or storage changes were introduced.

Files / surfaces updated

• docs/implementation-stack.md
• docs/live-deployment.md
• skills/knowledge-hub/SKILL.md
• skills/knowledge-hub/project-context-template.md
• server UI copy in base.html, home.html, vault.html, document.html, new_document.html
• test expectation updates in server/tests/test_capture_and_ui.py

Validation

• cd server && uv run --extra dev pytest -q
• Result: 28 passed

Commit

• 2bd61f8 Simplify docs and UI framing around the wiki-first model

Takeaway

• The right move was a framing reset, not a rewrite.
• The repo can be simplified by changing defaults, explanations, and copy while keeping advanced helpers available as optional tools.

2026-04-08 — live smoke test after simplification wave

Outcome

• Ran a live smoke test against https://kb.icvida.com focused on the simplified core workflow.
• Core workflow passed: search, capture, read, append, history, durable doc create/read/search/delete, activity, and tags.
• Live timings were roughly 316–420 ms end-to-end for reads/searches and ~379–418 ms for writes.

Artifact

• projects/knowledge-hub/live-smoke-test-2026-04-08.md

Interpretation

• The simplified workflow is usable right now.
• Search is useful but still exact-oriented.
• No rewrite is indicated; future changes should remain incremental.