47 nodes / one connected world
The connected workshop
Every expression has an identity. Follow the relationships between the ideas, the work, and Hugo Web.
This is the graph beneath the site—not a second collection of copies. Each expression lives in its publishing folder and contributes its node to this index.
Entities
entity nodesAI Assistant
A tool-mediated collaborator that helps analyze, model, implement, and review work within explicit human-approved boundaries.
ai-assistantroleBuilder
A visitor who learns, judges, and creates; an audience role distinct from Hugo Web himself.
buildertechnologyGit
A distributed version-control system for recording, comparing, and sharing changes.
gitserviceGitHub
A hosted collaboration service for Git repositories, reviews, issues, and automation.
githubtechnologyGo
A compiled programming language with a standard library and tooling for building maintainable software.
gotechnologyHugo
A static site generator that transforms content, data, templates, and assets into publishable files.
hugopersonaHugo Web
The personified Hugo Web philosophy: a hands-on developer, architect, builder, researcher, entrepreneur, and craftsman who helps people turn what they imagine into useful realities while learning through creation.
hugo-websystemHugo Web Site
The public publishing system that expresses Hugo Web’s philosophy through five pillars and a connected knowledge graph.
hugo-web-sitetechnologyModel Context Protocol
An open protocol for connecting AI applications to external tools, resources, and contextual capabilities.
model-context-protocolserviceNetlify
A deployment platform that can build and deliver static sites and provide optional runtime capabilities.
netlifyConcepts
concept nodesAdapter pattern
Translate one interface into another interface a client expects without changing the underlying meaning.
adapter-patternprocessBuild
The phase of turning an approved model into working, inspectable expressions.
buildprincipleBuilder sovereignty
Practical ownership of knowledge, tools, and decisions, including the ability to inspect and leave a system.
builder-sovereigntypracticeCode Generation Contract
The project-specific guidance for turning approved Hugo Web intent into working, inspectable site code while preserving semantic identity, human authority, simplicity, and publication safety.
code-generation-contractprocessDesign
The phase of choosing intent, outcomes, and constraints before committing to implementation.
designpracticeDeveloper’s Notebook
A place for technical investigation, implementation mechanisms, reproducible questions, and architectural judgment.
developers-notebookmodeling-patternDomain-Driven Design
An approach to software design that develops a shared domain language and models within explicit boundaries.
domain-driven-designpracticeEvidence and revision
Use observed results to correct the model while distinguishing measurement, interpretation, and uncertainty.
evidence-and-revisionmodeling-patternExpression
An outward artifact of structured meaning; on this site every published expression also has its own canonical node.
expressionpracticeFrontier models
A time-sensitive category for highly capable AI models, evaluated by task, evidence, operational constraints, and risk rather than a permanent ranking.
frontier-modelsdesign-patternGang of Four design patterns
A catalog of recurring object-oriented design solutions described by Gamma, Helm, Johnson, and Vlissides.
gang-of-four-patternsprincipleHuman agency
The builder’s retained ability to set intent, judge evidence, choose actions, and accept responsibility.
human-agencymodeling-patternKnowledge graph
A model of identified things connected by explicit relationships under a shared vocabulary.
knowledge-graphprocessModel
The phase of making important distinctions, intrinsic facts, and relationships explicit.
modelmodeling-patternOntology
The small controlled vocabulary that governs node types, kinds, relationship predicates, and explicit contracts.
ontologyarchitecture-stylePorts and adapters
Separate application policy from external mechanisms through explicit interaction boundaries.
ports-and-adapterspracticeRetrieval-augmented generation
Supply retrieved source material as context for generation, then evaluate the result against that evidence.
retrieval-augmented-generationmodeling-patternSemantic node
A stable, structured representation of one meaningful thing in the modeled world.
semantic-nodeprocessShip
The phase of placing approved expressions into reality and learning from their use.
shipprincipleSimplest-capable architecture
Prefer the least complexity that genuinely satisfies the whole system’s requirements.
simplest-capable-architectureprincipleSingle Responsibility Principle
A module should have one coherent reason to change, understood in relation to the actors or policies it serves.
single-responsibility-principleprincipleSOLID
Five object-oriented design principles concerned with responsibility, extensibility, substitutability, interface focus, and dependency direction.
solidarchitecture-styleStatic-first publishing
Precompute publishable information when freshness and interaction requirements permit, adding runtime work only where it creates value.
static-firstdesign-patternStrategy pattern
Encapsulate interchangeable algorithms behind a shared behavioral contract when variation is a real requirement.
strategy-patternExpressions
expression nodesBuild an ID index, not a path dependency
A technical explanation of two-pass graph indexing and publication-scoped relationship resolution.
build-an-id-indexreferenceChoose a publishing boundary, not a platform identity
An architectural map of optional static publishing services and their responsibilities.
choose-a-publishing-boundaryguideClose the learning loop
A method for using observed outcomes to revise a model after publication.
close-the-learning-loopguideConnect things without over-modeling them
A guide to explicit outbound relationships and compact ontology design.
connect-without-over-modelingreferenceThe developer’s field references
A categorized directory of external sources for Hugo, delivery systems, software design, and AI-assisted development.
developer-resource-directorynoteFollow the render path
A technical note on inspecting Hugo page data, template selection, and serialization boundaries.
follow-the-render-pathguideGive AI a bounded task
A review-first workflow for AI-assisted building with clear authority and limited scope.
give-ai-a-bounded-tasktutorialModel one meaningful thing
An introduction to creating a minimal semantic node without unnecessary fields.
model-one-meaningful-thingguideOld principles. New leverage.
A practical application of established software-design principles to AI-assisted code generation.
old-principles-new-leveragetutorialPublish one source two ways
A Hugo pattern for generating HTML and JSON from the same canonical node.
publish-one-source-two-waysreferenceShip a release you can reverse
A release procedure covering validation, artifact review, deployment checks, and rollback.
release-you-can-reverseguideChoose the simplest capable system
An architectural decision method that weighs complexity against concrete requirements.
simplest-capable-systemguideStart with an outcome, not a stack
A practical method for stating intent before selecting implementation tools.
start-with-an-outcome