Humagen design rules for every board¶
The boards these rules governed, and their GitHub Pages site, were removed on October 30, 2026. The rules stay as the design record that RFC 0001 and the gap analysis refer to.
Format¶
- Each board = one
.htmlfile inboards/:assets/boards.cssandassets/boards.jsin the head, the markup in<template data-board>(with a<helmet>for fonts and page basics), and one<script type="text/x-dc" data-props='{...}'>holdingclass Component extends DCLogicwithrenderVals().boards.jsrenders the template and re-renders onsetState. - Holes
{{x}}are dotted lookups only. Computed styles/labels come from renderVals. Lists via<sc-for list="{{ items }}" as="it" hint-placeholder-count="N">, branches via<sc-if value="{{ flag }}" hint-placeholder-val="{{ true }}">. Events:onClick="{{ fn }}". - Close every element, quote every attribute. No emoji, no gradients-as-decoration, no left-border cards, no iframes, no innerHTML.
- Real
<button>,<a href>,<input>+<label>.aria-labelon icon-only buttons. Decorative svgaria-hidden="true". - PAGE artboards (app screens): fluid root
width: 100%; min-height: <H>px; display:flex; flex-wrap:wrap, navflex: 1 1 220px, mainflex: 999 1 640px; min-width:0. Wide tables inoverflow-x:autobox. Must work at phone width. - Links between artboards:
<a href="Other.html">. - Write copy as literal markup unless it is genuinely data. No lorem ipsum. Use the Spring Launch story: Supplier ETA changed (packaging Nov 4 → Nov 8), Launch Planner recommends moving launch Nov 12 → Nov 19, Ops Agent holds 4 vendor notices pending approval, Media Analyst failed because Media buy tracker access expired, Research Analyst works on a private Pricing memo draft.
- People: Avery Park (AP, the viewer, "You"), Mira K. (MK, launch lead), Jon T. (JT, ops), Sam R. (SR, marketing). Agents: Launch Planner (LP), Ops Agent (OA), Monitor Agent (MA), Research Analyst (RA), Media Analyst (MD), Onboarding Guide (OB).
Tokens¶
- Font: Inter 400/500/600/700. Body 14px/1.45. Labels: 11px 600 uppercase letter-spacing .06em #5F6168. H1 22px 600. Section h2 13px 600 uppercase .04em #5F6168.
- Ground #F6F6F4 · Nav #EFEFEC · Surface #FFFFFF · Subtle surface #FAFAF8 · Line #E2E2DE · Inner line #F0F0ED · Control border #D5D5D0
- Ink #1B1C1E · Ink-2 #3A3C41 · Muted #5F6168 (min for any text)
- Accent #2E5B88 (hover #1F4166), accent tint #E3E8EE, selected row #F3F6FA
- Status pills (12px 600, radius 999, padding 2px 8px): ok #E6F2EC/#1F6B45 dot #1F7A4D · working #E3E8EE/#2E5B88 · waiting/attention #F4E6CC/#6B4100 dot #B86E00 (panel #FBF3E4 border #EED9B3) · error #F7E3DF/#8C2F22 dot #A33A2B · neutral #EEEEEB/#3A3C41 dot #8A8C92
- Radii: cards 12, inputs/buttons 8, chips 999, modal 16. Buttons 36–40px tall. Primary button #1B1C1E bg white text; secondary white bg 1px #D5D5D0. Touch targets ≥ 32px in dense tables, 36+ elsewhere.
- Cards: white, 1px #E2E2DE, radius 12. Stat tiles: label 12px muted + value 22px 600.
Object identity (always the same everywhere)¶
Each object type has ONE shape + ONE icon + ONE tint. Tints are for the badge/avatar only, never big fills. - Person: CIRCLE avatar, initials 600, warm tints (#D9C7B4, #BFD3C6, #C9C3DD, #E2CFC0), ink text. - Agent: ROUNDED SQUARE (radius = 25% of size), initials 700, bg #E3E8EE text #2E5B88. Type icon: bot. - Skill: rounded square badge bg #ECE6F4 fg #563A80, icon: wrench. - Memory: rounded square badge bg #E0EFEC fg #1E5A52, icon: bookmark. - Source (context): rounded square badge bg #EEEEEB fg #3A3C41, icon: database. - Decision: icon check-circle, uses accent. - Handoff: icon arrow-right in a 26px circle bg #F1ECE4 fg #6B4E2E. - Project: folder icon. Channel: hash icon. Conversation: message icon.
Scope (who it belongs to) - a small neutral chip with icon + word, always¶
display:inline-flex;gap:4px;font-size:11px;font-weight:600;padding:2px 7px;border-radius:6px;border:1px solid #E2E2DE;color:#3A3C41;background:#FFFFFF
- Workspace (icon: layout-grid) · Project (icon: folder) + project name · Personal (icon: user) "Only you" · Agent (icon: bot) + agent name.
Inheritance order: Workspace → Project → Agent → Personal (narrower wins only within what the wider allows; a workspace "Never" can't be loosened lower down).
Icons - stroke set, 24 viewBox, fill none, stroke currentColor, stroke-width 1.75, round caps & joins. Sizes 16 (inline/dense), 18 (buttons), 20 (nav). Copy these paths EXACTLY:¶
- search:
- plus:
- close:
- chevron-down:
chevron-right: - check:
- check-circle (decision):
- alert (attention):
- folder (project):
- hash (channel):
- message (conversation):
- bot (agent):
- user (person/personal):
- users (people/members):
- wrench (skill):
- bookmark (memory):
- database (source/context):
- arrow-right (handoff):
- pulse (activity):
- sliders (settings):
- shield (policy):
- bar-chart (usage):
- list (audit log):
- inbox (needs you):
- layout-grid (workspace):
- refresh (sync):
- camera (snapshot):
- live (radio):
- pause:
play: - lock (private):
- eye (visible to):
- clock (schedule):
- bell (notifications):
- link (connected account):
- doc (deliverable):
- attach:
- at (mention):
- send:
- more:
(Note: in board markup write every svg child with an explicit close tag, e.g. , never self-closing.)
Canonical workspace nav (used by every non-conversation page)¶
Left nav flex: 1 1 220px; background:#EFEFEC; border-right:1px solid #E2E2DE; padding:16px 12px; gap:18px; flex column:
1. Workspace row: 28px black rounded "H" mark + "Humagen" 15px 600.
2. Group "Projects" (folder icons): Spring Launch (→ Main.html), Q4 Research, Onboarding Revamp.
3. Group "Library": Skills (wrench, → Skills.html), Memory (bookmark, → Memory.html).
4. Group "Operations": Needs you (inbox, blue count pill 3), Agents (bot, → OpsAgents.html), Agent network (arrow-right, → AgentComms.html), Context health (database, amber dot, → OpsContext.html), Policies (shield, → Policies.html), Usage (bar-chart, → Usage.html), Audit log (list, → AuditLog.html).
5. Bottom (margin-top:auto): user row link → UserSettings.html: 28px circle avatar "AP" (#C9C3DD) + "Avery Park" + muted "Your settings".
Nav items: display:flex;align-items:center;gap:10px;padding:8px;border-radius:6px;color:#1B1C1E;text-decoration:none, icon 18px color #5F6168; current item: background #FFFFFF, font-weight 600, aria-current="page".
Added: hierarchy, integrations, forking¶
Model:
- Hierarchy: Workspace → Initiative (optional parent, e.g. "Spring 2027 Go-to-market", icon flag) → Project → Channel → Subchannel → Conversation. Projects may also have sub-projects (child projects).
- Parents pass DOWN: policies (tighten-only), shared context sources, skills, memory (children read parent memory; children promote up), initiative-level agents (e.g. "Portfolio Monitor" operating across child projects). Members optional-inherit.
- Children roll UP: status, decisions, Needs-you items, usage, risks.
- Integrations (GitHub, Slack, Google Drive, Notion): Connection (workspace-level auth) → Resources (repos, channels, folders, databases) → Links to projects (manual, suggested, or rule-based auto-link) → Access mode (Indexed / Live search / Hybrid) → Events (triggers for agents: PR opened, issue labeled, message in bridged Slack channel, page edited) → Actions (comment on PR, post to Slack; governed by policy "Message people outside the project").
- Auto project adding: link modes per integration = Suggest (default) · Auto-link by rule · Off. Rules e.g. "repo topic spring-launch → Spring Launch", "Slack channels starting #launch- → Spring Launch", "Notion pages under Launch HQ". Suggestions queue shows WHY (shared contributors, matching keywords) with Link / Ignore.
- External objects never use brand logos: show a neutral 32px rounded-square badge with a 2-letter monogram (GH, SL, GD, NO) in #EEEEEB/#3A3C41 plus the system name in text. Linked objects carry a "via GitHub" provenance chip.
- Context access modes (chip on every source): Indexed ("Indexed · synced 9:42": copied and indexed, has sync lifecycle; best for Drive folders) · Live search ("Live search · queried 9:51": no copy, queried at question time with the asker's permissions; always current, slower, unavailable if source down; best for a Notion workspace) · Hybrid ("Hybrid · 24 pages indexed, rest live": pinned key pages indexed + live search for the rest).
- Forking: Conversation fork = "Fork from here" on any message → new conversation with history up to that message as read-only context, chosen agents and sources, lineage chip "Forked from