Vuong Hoang
1240212ff2
Codex's CWD when invoked by the Volva daemon. Volva makes codex a peer on the althing bus; this directory holds the durable context codex reads on every call. Seeded with: - AGENTS.md — codex bootstrap entrypoint; defines two roles (research partner for brokkr-smithy-dev; code reviewer for project-dev callers), output discipline, and required-reads. - CONTEXT.md — Corviduo + Vast Blue ubiquitous-language glossary (17 terms: orgs, cross-cutting infra, Corviduo projects, Vast Blue SEA). Mirrors the user-level CONTEXT.md baseline. - INVENTORY.md — project inventory with on-disk paths, Gitea sources, spec entry-points. Drawn from brokkr-smithy/docs/improvement-targets. - PRINCIPLES.md — the four engineering principles (excellence / explicit / elegance-as-byproduct / action-relevance). - REVIEW-GUIDE.md — code-review discipline. Verdict + must-fix shape matches Sleipnir's review lex (trivial/small/systemic severity tags). Project-specific patterns for Sleipnir, Worldtree, Skaldsong. - RESEARCH-PARTNER-GUIDE.md — research-partner discipline. Nine named failure modes from Brokkr's own captured-feedback memory (listing categories anchors, negative claims close inquiry, search-by-shape, per-target known-gaps, critique pass, action-relevance for probes, layer-axis mitigation enumeration, consumer-side validation). - transient/ — per-call ephemera convention; caller drops transient/<slug>.md before the althing message references it. Gitignored except for the README. Attribution discipline carried throughout: no AI / Claude / Anthropic / Codex attribution in any artifact volva produces. Operator is Vuong Hoang.
8.5 KiB
CONTEXT.md — Corviduo + Vast Blue ubiquitous language
Names mean specific things across this stack. When you cite a project, system, or pattern, reach for the right name; don't invent aliases or fall back to generic phrasing when a precise term exists.
Resolution rule: most-local-wins — project-level CONTEXT.md files in individual repos shadow these definitions when they conflict. The definitions below are the user-level baseline carried across repos.
Organizations
Corviduo — the company where Vuong is Principal. "Corviduo Projects" defaults to the projects in this stack. SEA is the explicit exception (Vast-Blue-owned, Vuong-partnered). Avoid: the umbrella, the family, the stack, Vuong's projects.
Vast Blue AI — the company where Vuong is a Partner. Builds business AI orchestration as a SaaS product. Distinct from Corviduo. Avoid: Vuong's company, the SaaS, the AI company.
Cross-cutting infrastructure
Althing — inter-agent message bus for Corviduo. Markdown messages with YAML frontmatter (SQLite-backed v2 as of 2026-05-17); operated via althing-cli. Per-agent handles follow <project>-dev (brokkr-smithy-dev, worldtree-dev, etc.) plus a few non--dev role handles (forseti moderator, infra-ops). Web UI for multi-agent discussion in flight.
Avoid: the bus, the messenger, althing-cli (the operator surface, not the bus itself).
Bifrost — the MCP-in-reverse protocol. Platform mints per-session JWTs and dispatches tool calls outbound; consumer apps run their own MCP servers exposing tools back to the platform. Independent repo (vh/bifrost) on its own semver (v0.1.1 today, v0.2 in flight). Consumed by platforms (Worldtree), implemented by consumers (Skaldsong, Sleipnir verifier role).
Avoid: MCP (ambiguous), reverse-MCP, tool injection.
corviduo-project-template — canonical home for cross-cutting Corviduo specs and tooling. Lives at ~/development/corviduo-project-template/. Brokkr-Smithy is canonical-spec steward as of 2026-05-15. Hosts the v2.x contract-format spec, the four engineering principles, and the canonical-sync tooling. Operators bootstrap new projects by copy-cloning this template; consumers pin against it via .corviduo-canonicals.toml.
Avoid: the template, corviduo-template (slug drops the -project- clarifier).
Forseti — Althing's moderator / system-speaker handle. On the bus, forseti is a non--dev role handle distinct from per-project -dev handles. Norse god of justice. (Worldtree also has an internal Forseti — disambiguate by context: the bus handle is lowercase.)
Avoid: the moderator, the speaker.
Galdrabok — Corviduo's Claude Code skill collection ("spellbook"). Hosts SKILL.md-shaped files Claude Code loads on demand: /vor, /tdd, /tend-docs, /sleipnir-preflight, /glossary, /snapshot, etc. Install via symlink into ~/.claude/skills/.
Avoid: the spellbook, the skills repo.
Vor — Corviduo's pre-contract design partner. Invoked when there's an ask but no contract yet — surfaces assumptions, ambiguities, edge cases, counter-arguments before any code or contract is drafted. Two surfaces: the /vor skill (in Galdrabok) and the Vor UI sidecar (FastAPI web app, separate vh/Vor repo). Sister skill /vor-frame handles asks too shapeless for a Vor questionnaire. A contract whose ambiguity was resolved via Vor is Vor-graduated (frontmatter flag; Sleipnir skips plan-converge for these).
Avoid: the design grill, the question round, Vor UI (the sidecar, not the partner).
Corviduo projects
Brokkr-Smithy — Corviduo's research and forging lab. Empirical methodology spine for prompt, orchestration, and architectural-shape claims that ship to consumer projects. Opens R-numbered research targets with charter / hypothesis ledger / probes / actions / findings; authors SOTA literature surveys; runs calibration probes. Ships intelligence packages via althing — never drafts contracts for consumer repos (consumer repos run their own /vor sessions and own their specs). The assistant working in this repo is addressed as Brokkr (the dwarf-smith persona).
Avoid: the lab, the research repo, Snorri (the rename ghost — refers to the historical name or to the decision-rule engine subsystem), Edda (deeper rename ghost).
Domari — Worldtree's pan-judgment specialist agent. Routes verdict requests (likert / binary / pairwise / scalar / gap_list) to backbones (Selene / Skywork) per a dispatch table; returns a polymorphic discriminated-union response with verdict_kind discriminator. Returns 200 + ErrorVerdict envelope on backbone failures rather than 5xx. Norse: "the judges."
Avoid: the judge (Worldtree has a separate Judge agent for code review — distinct surface), the judgment agent.
Heimdall — Worldtree's auth-scope mechanism. Per-API-key tier (user, admin) maps to a set of scopes (domari:invoke, bifrost:invoke) via config/policies.yaml. Live policy resolution at every authz call; no per-key scope override. Norse: watchman of Asgard.
Avoid: auth, the scope mechanism (too generic outside Worldtree).
Mead Hall — A Corviduo Project — a Worldtree client application. A "Workspace Shell" designed flexibly enough to span use cases as different as business automation and multi-agent role-playing (personas, memories, GM/narrator, world history, goals) — these are bounding examples that pin the flexibility requirement. MVP ships the business-automation configuration. High-fidelity aesthetic non-negotiable. Avoid: the new client app, the workspace shell (architecture, not product), business-and-roleplay-from-one-shell (deprecated framing).
Skuld — Worldtree subsystem — token-spend ledger. Subscribes to LLMCallEvent (Worldtree's wire format for LLM calls) and persists per-call usage to a durable store, giving Worldtree clients cost attribution per request. Norse: future-Norn.
Avoid: the ledger, token-spend.
Sleipnir — Corviduo's AFK agent orchestrator. Invoke-and-exit (sleipnir run --until-empty re-polls between waves; no long-lived daemon). Given a target repo with ready-for-agent-labeled issues, fans out parallel agents into per-issue git worktrees, drives plan → implement → review → fixup → merge → done → corpus. State under ~/.local/state/sleipnir/projects/<slug>/. Gates dispatch on prd:-pinned contracts via /sleipnir-preflight.
Avoid: the orchestrator, the daemon (it's not), the runner.
Vili — Worldtree subsystem in flight (#177) — purpose-built async OCC/PAD emotional appraisal engine. R06 recommendation landed 2026-05-17: qwen3.6-35-a3b-heretic backbone with reasoning suppressed; richer envelope (event + appraiser OCEAN + current PAD + active goals + active fears + agent_id + user_id); answer-first JSON schema. Replaces core/persona/appraisal.py:appraise_llm_v2.
Avoid: the emotional engine, the appraisal LLM.
Volva — Corviduo Project — daemon that makes codex a peer on the althing bus. Norse seeress consulted for prophecy. Single-turn Q&A: althing-message in → codex-prompt → codex-response → althing-reply out. Stateless; thread continuity is the bus's job. Architecture-shape lifts sleipnir's LLMBackend pattern (host-side, no worktree). Distinct from sleipnir's codex wrapper (job-shaped with worktree + sandbox + verdict aggregation); Volva is the simpler oracle shape. This is you.
Avoid: the codex daemon, the oracle, Mímir (collides with Worldtree's Mimir agent).
Worldtree — Corviduo's multi-agent framework. Hosts named persona agents and routes their LLM calls. Originally named AIPA (vh/AIPA is the predecessor; current source-of-truth is vh/Worldtree). Heimdall is its auth-scope mechanism. Hosts Bifrost (consumes the protocol; clients implement it back).
Avoid: the framework, the platform, AIPA, Yggdrasil.
Vast Blue projects
SEA — Vast Blue AI's product. Scalable Enterprise Agency. A Worldtree client app sold as SaaS for AI-assisted automation. Vuong-adjacent via Vast Blue Partner role; explicitly not a Corviduo Project. Avoid: the Vast Blue product, the SaaS, the client app (overcounts — Skaldsong is also a Worldtree client app).
Operational reminders
- The operator is Vuong Hoang. Attributions go to him only. Don't sign artifacts as "an AI assistant," don't add "generated with" footers, don't add
Co-Authored-Bytrailers to commits. - When a project has its own
CONTEXT.md(project-level glossary), it shadows entries here on conflict. Read project-local definitions first if the caller is asking about a specific project.