Portal & Workflows
Decisions
Key Decisions Log
Historical decisions that shaped the Agentic Hub. Chronological. Rarely read, always findable. Moved from
architecture.mdto reduce noise — seecontext-engineering.mdrule.
| Date | Decision | Rationale |
|---|---|---|
| 2026-03-06 | Superseded by A108 (2026-03-17). Built portal-cli + portal-mcp. | |
| 2026-03-06 | Portal deploy is manual (wrangler pages deploy) | Git push does NOT auto-deploy. Run npm run deploy from portal/. |
| 2026-03-06 | Remote execution via queue polling (A33) | Air-gapped pull model: portal → D1 → Bifrost. No webhooks. |
| 2026-03-06 | Mini-wrap rule | Before notify_user: post to #dev + update ongoing. Full log deferred to /wrapup. |
| 2026-03-06 | D1-primary, local-cache pattern | D1 = source of truth. Local markdown = agent-readable cache. Dual-write via /log. |
| 2026-03-06 | Poller health heartbeat | Bifrost POSTs timestamp every 30s → portal shows health indicator. |
| 2026-03-06 | e:\server\ | Superseded: migrated to services/bifrost-api/ (2026-03-09). |
| 2026-03-06 | ⚠️ Auto-accept blacklist is broken | AntiGravity AutoAccept plugin doesn't filter commands. Upstream issue A41. |
| 2026-03-09 | Strategic alignment: defer hub meta-work | Real work (ATS, Surfstek, Career Page) takes priority through April. |
| 2026-03-09 | Proactive wellness monitoring | Agents detect stress signals. Clara includes stress/energy check-ins. |
| 2026-03-09 | Clara archives linked reports | Clara v2.3: archiving a task also archives its linked report. |
| 2026-03-09 | Portal V2 promoted to root | React 19 + Vite 7. V1 archived at /v1/. |
| 2026-03-09 | Bifrost: hub-native portal bridge (A55) | Moved to services/bifrost-api/. Hub-native CWD. |
| 2026-03-10 | Bifrost Node.js API upgrade | Replaced PS polling with Node.js Express + PM2. SSE streaming, cancellation. |
| 2026-03-10 | Automated mode paradigm | Two modes: Copilot (interactive) and Automated (portal→Bifrost→CLI). |
| 2026-03-10 | Memory folder nuked | memory/ (JSONL) replaced by .agent/rules/memory.md (auto-read rule). |
| 2026-03-10 | API middleware pattern (_utils.js) | Shared apiRouter for all endpoints. Centralizes auth, CORS, errors. |
| 2026-03-14 | Bifrost auto-resume (A83) | Rate-limited jobs auto-retry after cooldown via retry-queue.js. |
| 2026-03-17 | Portal CLI + MCP (A108) | Built CLI (5 command groups) + MCP (10+3 tools). Eliminates API friction. |
| 2026-03-17 | Report markdown companions (A106) | Reports have report.md alongside HTML. 80% fewer tokens for agent reading. |
| 2026-03-17 | Context engineering rule | Progressive disclosure principle. Less noise, no loss. See context-engineering.md. |
| 2026-03-18 | Nexus vision tree (nexus.yaml) | Recursive vision management — L0 "Free Adrian" down to L4 projects. Each node has a compass field. Replaces flat project lists with a tree agents can traverse. |
| 2026-03-18 | Clarity workflow (/clarity) | Measures crystallization of project/domain context across 7 dimensions. Modes: summary, report, handoff. Addresses the "where are we?" gap. |
| 2026-03-19 | Notion CLI skill | /notion CLI for reading, exporting, and creating Notion pages. Supports recursive tree export to markdown. Enables Notion → Hub migration. |
| 2026-03-20 | Workspace consolidation (A120/A121) | 8 repos → 4 monorepos. Each workspace (Dev, Life, Work) is self-contained. Eliminated scattered context files. ~50 files moved/reorganized. |
| 2026-03-20 | Hub-spoke architecture | Agentic is root in all VS Code workspaces. Workspace .agent/ = local overrides only. Hub rules/workflows/skills cascade to all workspaces. |
| 2026-03-20 | KB centralization to hub | All workspace KBs moved to kb/ (hub/mipos/dev/adrian). memory.md slimmed from ~17KB to ~8KB. memory/ folder retired. On-demand loading via kb/. |
| 2026-03-20 | Governance loop activation | Defined owners, checkers, and consequences for key governance points. Weekly management review process. First incidents logged. |
| 2026-03-21 | Workflow architecture redesign (A122) | 18 workflows reorganized into atomic/orchestrator layers. /handoff created. /task done slimmed. Duplicated logic eliminated. Composition map documented. |
| 2026-03-21 | Principles expansion (CE6-CE8, SC5, AC7-AC10) | Reality feedback loops, hypothesis-awareness, pragmatic effectiveness, composable/atomic. Epistemological chain: observe → hypothesize → test → prove → document. |
| 2026-03-21 | Workflow usage tracking (JSONL) | Every workflow invocation logged to clara/workflow-usage.jsonl. Powers the CE8 flywheel — usage data feeds optimization. Portal graduation planned. |
| 2026-03-21 | Workflow naming: verbs over agents | Workflows are actions (verbs), agents are identities (nouns). /akira evolve → /evolve, /akira learn → /learn, /audy → /audit. Any agent can run any workflow. Agent identity stays in identity/ files. SC5 applied to naming. |
| 2026-03-21 | Manual versioning removed | Removed evolved: v7.1 from architecture.md, deleted clara/changelog.md. Git + decisions.md tracks evolution. No consumer for manual version numbers. |
| 2026-03-29 | Workflow restructure: /clean + /archive (A132) | Extracted Clara tidy → /clean (data hygiene), Clara archive + /logarchive → /archive (archival). Clara slimmed from 6→4 modes (dispatch only). /audit extended with P15 memory size check. Separation: dispatch (Clara) / maintain (/clean) / archive (/archive) / inspect (/audit). |