humanerd

humanerd.site — Vault to Site URL Mapping

3 min read

humanerd.site — Vault to Site URL Mapping

Date: 2026-05-20 Author: Drewgent (humanerd) Status: Phase 1 — URL Structure Design

Overview

This document maps every vault file that should appear on humanerd.kr to its public URL. The mapping drives two things:

  1. Aliases — added to each vault file’s frontmatter so Quartz generates SEO-friendly URLs
  2. Ignore patterns — files not listed here are excluded from the site

URL Hierarchy

/                   → index.md (home)
/about              → about.md
/blog/[year]/[slug] → memories/insights/ (monthly logs, chronological)
/projects/[slug]    → P4-cortex/growth/ (project writeups)
/lab/[slug]         → P4-cortex/growth/ (technical experiments)
/insights/[slug]    → P4-cortex/knowledge/ (conceptual articles)
/services/[slug]    → humanerd-site/content/services/ (product pages)

Content Already Native to Site

These files live in humanerd-site/content/ and are already at their correct URLs. No alias needed.

FileURLNotes
content/index.md/Home page
content/about.md/aboutAbout page
content/blog/index.md/blogBlog index
content/lab/index.md/labLab index
content/lab/drewgent-architecture.md/lab/drewgent-architecture
content/lab/qa-gate.md/lab/qa-gate
content/projects/index.md/projectsProjects index
content/services/index.md/servicesServices index
content/services/drewgent.md/services/drewgent
content/services/notion2web.md/services/notion2web
content/services/seo-harvester.md/services/seo-harvester

Vault → Site Mapping

/projects/ — P4-cortex/growth (Project Writeups)

Vault FilePublic URLTitleType
growth/drewgent-kanban-implementation-plan.md/projects/drewgent-kanbanDrewgent Kanban Implementationplan
growth/KANBAN-REVIEW-20260520.md/projects/kanban-reviewKanban Implementation Reviewreview
growth/KANBAN-USER-GUIDE.md/projects/kanban-user-guideKanban User Guideguide
growth/INTEGRATION_PROTOCOL.md/projects/integration-protocolIntegration Protocolworkflow
growth/cron-self-healing-protocol.md/projects/cron-self-healingCron Self-Healing Protocolprotocol
growth/humanerd-site-renovation-plan.md/projects/humanerd-site-renovationhumanerd.site Renovation Planplan
growth/humanerd-site-design-system.md/projects/humanerd-site-designhumanerd.kr Design Systemguide
growth/P0-brainstem-pilot-plan.md/projects/p0-brainstem-pilotP0-Brainstem Pilotplan
growth/kanban-maintenance-guide.md/projects/kanban-maintenanceKanban Maintenance Guideguide
growth/open-crab-ontology-drewgent-implementation.md/projects/ontology-implementationOpenCrab Ontology Implementationreport
growth/open-crab-ontology-pilot-20260520.md/projects/ontology-pilotOntology Pilot Reportreport
growth/patterns/KANBAN_WORKFLOW_PATTERNS.md/projects/kanban-patternsKanban Workflow Patternspatterns

/lab/ — P4-cortex/growth (Technical Experiments)

Vault FilePublic URLTitleType
growth/dream-system-SSPEC.md/lab/dream-systemDream System Specspec
growth/trend-harvester/index.md/lab/trend-harvesterTrend Harvesterindex

/insights/ — P4-cortex/knowledge (Articles)

Vault FilePublic URLTitleType
knowledge/garry-tan-building-with-ai-series.md/insights/garry-tan-building-with-aiGarry Tan: Building with AIreview
knowledge/garry-tan-complexity-ratchet-2026.md/insights/garry-tan-complexity-ratchetThe AI Agent Complexity Ratchetreview
knowledge/garry-tan-unified-architecture-drewgent-review.md/insights/garry-tan-architectureGarry Tan Architecture Reviewreview
knowledge/NEURONFS_RULES.md/insights/neuronfs-rulesNeuronFS Rulesconcept
knowledge/obsidian-vault-site-principle.md/insights/vault-site-principleVault + Site Architectureprinciple
knowledge/OPENCRAB_ONTOLOGY.md/insights/opencrab-ontologyOpenCrab Ontologyconcept

/blog/[year]/ — memories/insights (Monthly Logs)

Vault FilePublic URLTitleType
memories/insights/2026-05.md/blog/2026/05Insights Log: 2026-05log

Future monthly logs (2026-06.md, etc.) follow the same pattern: /blog/YYYY/MM.

Alias Generation Rules

For any new vault file added to the site, apply this rule to generate the alias:

type = "plan" | "report" | "review" → /projects/[slug]
type = "spec" | "experiment" → /lab/[slug]
type = "concept" | "principle" → /insights/[slug]
type = "log" (memories/insights/) → /blog/YYYY/MM

Slug conversion:

  • Remove timestamps: KANBAN-REVIEW-20260520 → kanban-review
  • Lowercase: Integration Protocol → integration-protocol
  • Remove article prefixes: The, A, An
  • Preserve meaningful words: open-crab-ontology stays as-is

Excluded Files (ignorePatterns)

These vault files are NOT published to the site:

PathReason
P0-*Internal brain rules (P0-brainstem)
P1-*Internal personality (P1-limbic)
P2-* except memories/insights/Internal memory (P2-hippocampus)
P3-*Internal sensors (P3-sensors)
P5-*Internal self-model (P5-ego)
P6-*Internal planning (P6-prefrontal)
memories/entities/User/entity wiki pages
memories/concepts/Internal knowledge wiki
P4-cortex/plans/Internal planning (not public)
skills/Agent skills (shown via services instead)
cron/Cron job configs
agent/Agent source code
gateway/Gateway source code
tools/Tool source code
knowledge/laws-of-ux-wiki/**External scraped content
landingpage/**Old landing page
scripts/**Automation scripts
*.md with heritage: truePreserved SEO articles (unchanged)

Content Structure

Symlink Architecture (content/)

content/
├── index.md                    ← native
├── about.md                    ← native
├── blog/
│   └── index.md                ← native (index for blog section)
│   └── (monthly logs symlinked from memories/insights/)
├── projects/
│   └── index.md                ← native (index for projects section)
├── lab/
│   ├── index.md                ← native
│   ├── drewgent-architecture.md  ← native
│   └── qa-gate.md              ← native
├── insights/                   ← symlink: P4-cortex/knowledge/
├── services/
│   ├── index.md                ← native
│   ├── drewgent.md             ← native
│   ├── seo-harvester.md        ← native
│   └── notion2web.md           ← native
├── growth/                     ← symlink: P4-cortex/growth/ (for alias resolution)
└── skills/                     ← symlink: skills/ (for alias resolution)

Blog Routing (memories/insights/ → blog/)

Monthly logs in memories/insights/ are symlinked into content/blog/ as read-only sources. Quartz processes them with aliases so:

  • Vault path: memories/insights/2026-05.md
  • Site URL: /blog/2026/05
  • Aliases frontmatter routes vault path → canonical URL

Implementation Checklist

  • Add aliases to all 12 growth files in /projects/ frontmatter
  • Add aliases to 2 lab files in /lab/ frontmatter
  • Add aliases to 6 knowledge files in /insights/ frontmatter
  • Add alias to memories/insights/2026-05.md for /blog/2026/05
  • Verify quartz.config.ts ignorePatterns covers all excluded paths
  • Build test: confirm all canonical URLs return 200
  • Verify vault paths redirect to canonical URLs (aliases working)

Generated by Drewgent — 2026-05-20 Phase 1: URL Structure & Aliases

그래프 뷰