lhumina_code/docs_hero
0
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions

docs: Phase 1 Tier B/C — multi-context, intelligence stack, common prompts #2

Merged
mik-tf merged 1 commit from development_mik_phase1_tier_bc into development 2026-05-08 15:32:14 +00:00
Conversation 0 Commits 1 Files changed 6 +362
mik-tf commented 2026-05-08 15:31:33 +00:00
Owner
Copy link

Summary

Lands the 3 unmerged concept/task pages from the original development_mik_capability_pages draft branch (s51), surgically selected so this PR adds new content only and does not regress dev.

The 10 Tier A service pages from the original draft already landed via 6ed62f6 in s52; this PR completes Phase 1 by adding the three "concept explainer" pages the AI Assistant grounds on alongside the per-service docs.

What's in

  • collections/hero_os_guide/concept_intelligence_stack.md — Embedder + Books + Indexer + AI Broker + Agent layered design
  • collections/hero_os_guide/concept_multi_context.md — How Hero OS enforces per-tenant isolation across services and the AI Assistant
  • collections/hero_os_guide/tasks_common_prompts.md — Ten canonical AI Assistant prompts that work today

Plus three ebook manifest entries:

  • ebooks/hero_os_guide/14_concept_multi_context.hero
  • ebooks/hero_os_guide/15_concept_intelligence_stack.hero
  • ebooks/hero_os_guide/16_tasks_common_prompts.hero

Why surgical, not a merge of the draft branch

The original draft branch also holds older versions of three Tier A ebook entries (calendar, videos, foundry) that have since been improved on dev by ~30–40 bytes each. Merging the whole branch would regress those. Cherry-picking only the six unique-to-branch files preserves dev's improvements.

Staleness fix

One line in concept_intelligence_stack.md was updated: hero_embedder_ui / ui.sock → hero_embedder_web / web.sock, matching the current crate layout on origin/development. The naming itself is in the home#230 phase 3 outlier audit (embedder is the only repo with _web instead of _admin for its admin dashboard), but for now the doc reflects current reality.

Test plan

  • All 3 new markdown files scan clean for stale _ui / ui.sock / BASE_PATH references after the embedder fix.
  • All 5 cross-referenced forge issue links resolve (hero_osis#42/43, hero_agent#15/16, hero_demo#53 — closed/open both valid).
  • After merge: hero_books re-indexes the 3 new pages on the next hero_indexer cycle so the AI Assistant can ground on them.
  • After merge: the obsolete development_mik_capability_pages draft branch can be deleted.

Refs

  • docs_hero#1 — content roadmap
  • home#230 phase 3 — embedder _web vs _admin outlier audit
  • s51 narrative — original draft kept as branch
  • s52 narrative — Tier A landed via 6ed62f6

Signed-off-by: mik-tf

## Summary Lands the 3 unmerged concept/task pages from the original `development_mik_capability_pages` draft branch (s51), surgically selected so this PR adds **new content only** and does not regress dev. The 10 Tier A service pages from the original draft already landed via `6ed62f6` in s52; this PR completes Phase 1 by adding the three "concept explainer" pages the AI Assistant grounds on alongside the per-service docs. ## What's in - `collections/hero_os_guide/concept_intelligence_stack.md` — Embedder + Books + Indexer + AI Broker + Agent layered design - `collections/hero_os_guide/concept_multi_context.md` — How Hero OS enforces per-tenant isolation across services and the AI Assistant - `collections/hero_os_guide/tasks_common_prompts.md` — Ten canonical AI Assistant prompts that work today Plus three ebook manifest entries: - `ebooks/hero_os_guide/14_concept_multi_context.hero` - `ebooks/hero_os_guide/15_concept_intelligence_stack.hero` - `ebooks/hero_os_guide/16_tasks_common_prompts.hero` ## Why surgical, not a merge of the draft branch The original draft branch also holds **older** versions of three Tier A ebook entries (calendar, videos, foundry) that have since been improved on dev by ~30–40 bytes each. Merging the whole branch would regress those. Cherry-picking only the six unique-to-branch files preserves dev's improvements. ## Staleness fix One line in `concept_intelligence_stack.md` was updated: `hero_embedder_ui` / `ui.sock` → `hero_embedder_web` / `web.sock`, matching the current crate layout on origin/development. The naming itself is in the [home#230](https://forge.ourworld.tf/lhumina_code/home/issues/230) phase 3 outlier audit (embedder is the only repo with `_web` instead of `_admin` for its admin dashboard), but for now the doc reflects current reality. ## Test plan - [x] All 3 new markdown files scan clean for stale `_ui` / `ui.sock` / `BASE_PATH` references after the embedder fix. - [x] All 5 cross-referenced forge issue links resolve (hero_osis#42/43, hero_agent#15/16, hero_demo#53 — closed/open both valid). - [ ] After merge: hero_books re-indexes the 3 new pages on the next `hero_indexer` cycle so the AI Assistant can ground on them. - [ ] After merge: the obsolete `development_mik_capability_pages` draft branch can be deleted. ## Refs - [docs_hero#1](https://forge.ourworld.tf/lhumina_code/docs_hero/issues/1) — content roadmap - [home#230](https://forge.ourworld.tf/lhumina_code/home/issues/230) phase 3 — embedder `_web` vs `_admin` outlier audit - s51 narrative — original draft kept as branch - s52 narrative — Tier A landed via `6ed62f6` Signed-off-by: mik-tf 
Lands the 3 unmerged concept/task pages from the original
`development_mik_capability_pages` draft branch (s51), surgically
selected so this PR adds new content only and does not regress dev.

The 10 Tier A service pages from the original draft already landed via
6ed62f6 in s52; this PR completes Phase 1 by adding the three "concept
explainer" pages the AI Assistant grounds on alongside the per-service
docs:

- collections/hero_os_guide/concept_intelligence_stack.md
- collections/hero_os_guide/concept_multi_context.md
- collections/hero_os_guide/tasks_common_prompts.md

Plus their three ebook manifest entries:
- ebooks/hero_os_guide/14_concept_multi_context.hero
- ebooks/hero_os_guide/15_concept_intelligence_stack.hero
- ebooks/hero_os_guide/16_tasks_common_prompts.hero

Why surgical, not a merge of the draft branch: the draft branch also
holds older versions of three Tier A ebook entries (calendar, videos,
foundry) that have since been improved on dev by ~30-40 bytes each.
Merging the whole branch would regress those. Cherry-picking only the
six unique-to-branch files preserves dev's improvements.

Note on staleness: one line in concept_intelligence_stack.md was
updated in this PR — `hero_embedder_ui` / `ui.sock` → `hero_embedder_web`
/ `web.sock`, matching the current crate layout on origin/development.
The naming itself is in the home#230 phase 3 outlier audit (embedder is
the only repo with `_web` instead of `_admin` for its admin dashboard),
but for now the doc reflects current reality.

Closes the s51 carryover. After merge, the obsolete
`development_mik_capability_pages` draft branch can be deleted.

Refs:
- #1 — content roadmap
- lhumina_code/home#230 phase 3 — embedder _web vs _admin

Signed-off-by: mik-tf
mik-tf merged commit ddc81532d1 into development 2026-05-08 15:32:14 +00:00
mik-tf deleted branch development_mik_phase1_tier_bc 2026-05-08 15:32:14 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lhumina_code/docs_hero!2
No description provided.