humanerd.site 리뉴얼 플랜

Date: 2026-05-20 Author: Drewgent (-humanerd) Status: Planning

---

1. 개요

문제

• 현재 URL이 vault path 기반 (/growth/KANBAN-REVIEW-20260520)
• P-layer 내부 구조(P0~P6)가 외부에 노출
• SEO-friendly하지 않은 URL 구조
• hugh-kim.space와 비교했을 때 문서 형식이 blog-style이 아닌 wiki-style

목표

1. SEO-friendly URL 구조 — 의미 있는 계층 구조 (/projects/kanban-review)
2. Agent-managed site — Drewgent가 동적으로 site content 관리
3. Public identity 구축 — Drewgent brain 구조 숨기고, 작업成果를 공개
4. hugh-kim.space 스타일 — stats header, deep dives, 주제별 카테고리

---

2. URL 구조 설계 (SEO)

계층 구조

/
├── index                      → humanerd.kr (홈)
├── about                      → about.md
├── blog/
│   └── [year]/
│       └── [slug]             → blog posts (Chronological)
├── projects/
│   ├── index                  → projects/index.md
│   └── [slug]                 → project pages
├── lab/
│   ├── index                  → lab/index.md
│   ├── drewgent-architecture  → lab/drewgent-architecture.md
│   └── qa-gate                → lab/qa-gate.md
├── services/
│   ├── index                  → services/index.md
│   ├── drewgent               → services/drewgent.md
│   ├── notion2web             → services/notion2web.md
│   └── seo-harvester          → services/seo-harvester.md
├── insights/
│   └── [slug]                 → knowledge/ + memories/ insights
└── 404                         → Not found page

URL 변환 규칙 (Vault → Site)

Vault (현재)	Site URL (변환 후)	설명
growth/KANBAN-REVIEW-20260520.md	/projects/kanban-review	Timestamp 제거, lower kebab
knowledge/garry-tan-*.md	/insights/garry-tan-*	knowledge → insights
memories/insights/2026-05.md	/blog/2026/insights-2026-05	Monthly log → blog
P4-cortex/growth/INTEGRATION_PROTOCOL.md	/projects/integration-protocol	depth flatten

Alias Redirects (Quartz)

Quartz의 aliases frontmatter를 활용해서 SEOfriendly URL을 자동 생성:

---
title: Kanban Implementation Review
aliases:
  - /projects/kanban-review
  - /projects/drewgent-kanban-review
---

Vault path로 접근해도 canonical URL(/projects/kanban-review)로 redirect.

---

3. Content Architecture

섹션 정의

Section	Source (Vault)	Purpose	SEO Focus
blog	memories/insights/ (monthly logs)	Chronological deep dives	Date-based, timestamps
projects	P4-cortex/growth/	Drewgent project writeups	Descriptive slugs
lab	P4-cortex/growth/ (architecture docs)	Technical experiments	Technical depth
services	humanerd-site/content/services/	사용 가능한 서비스	Product pages
insights	P4-cortex/knowledge/	Knowledge articles	Conceptual SEO
about	humanerd-site/content/about.md	Identity page	Personal brand

symlink 구조 (content/)

content/
├── blog/              → memories/insights/
├── projects/          → P4-cortex/growth/ (filter: projects)
├── lab/               → P4-cortex/growth/ (filter: lab)
├── services/          → humanerd-site/content/services/ (native)
├── insights/          → P4-cortex/knowledge/ (filter: knowledge)
├── about.md           → (native)
└── index.md           → (native)

P-layer 숨기기 (ignorePatterns 확장)

quartz.config.ts의 ignorePatterns에 추가:

ignorePatterns: [
  // ... existing
  "P0-*",
  "P1-*",
  "P2-*",
  "P3-*",
  "P5-*",
  "P6-*",
  "skills/**",           // agents/skills shown via services
  "cron/**",
  "agent/**",
  "gateway/**",
  "tools/**",
]

---

4. Agent Dynamic Management

Drewgent Site Management Protocol

Drewgent가 site를 동적으로 관리하는 표준 절차:

[Step 1] Create/Update in vault
    → 새 문서 작성 시 vault 경로에 저장

[Step 2] URL Alias 결정
    → frontmatter에 aliases 추가 (SEO-friendly slug)

[Step 3] Category Mapping
    → 문서 type/tag 기반으로 site section 결정

[Step 4] Build Trigger
    → cron job 또는 manual trigger로 quartz build

[Step 5] Deploy
    → Cloudflare Pages 또는 GitHub Actions

frontmatter 표준 (Site Publication)

---
title: Kanban Implementation Review
type: document
space: claim
tags: [projects, kanban, drewgent]
created: 2026-05-20
updated: 2026-05-20
aliases:
  - /projects/kanban-review
  - /projects/drewgent-kanban-review-2026
publish: true                    # site publication flag
section: projects                # site section mapping
---

자동 URL 생성 규칙

Drewgent가 새 문서 생성 시 자동으로 적용:

1. Title → Lower kebab: Kanban Review 2026 → kanban-review-2026
2. Type → Section mapping:
   • incident → /logs/
   • report → /projects/
   • concept → /insights/
   • plan → /lab/
3. Aliases: vault path (hidden) + public URL (canonical)

---

5. Design System

hugh-kim.space 스타일 적용

Stats Header (index page):

humanerd.kr
7 AGENTS  7+ SKILLS  7 PLUGINS  15 HOOKS

Navigation Categories (좌측 고정):

• LATEST (최신 posts)
• BLOG (chronological deep dives)
• PROJECTS (project writeups)
• LAB (technical experiments)
• SERVICES (available services)
• ABOUT

색상 (현재 유지):

--background: #fbfaf7;    /* warm paper */
--accent: #7b5f3d;         /* amber */
--text: #161614;           /* ink */
--muted: #6b6860;          /* gray */

폰트:

• Header: Schibsted Grotesk
• Body: Source Sans Pro
• Code: IBM Plex Mono

---

6. Deployment Architecture

Cloudflare Pages + GitHub Actions

GitHub Repo: humanerd/humanerd-site
    ↓ (push on main)
GitHub Actions
    ↓ npx quartz build
Cloudflare Pages
    ↓
humanerd.kr (custom domain)

GitHub Actions Workflow (.github/workflows/deploy.yml)

name: Deploy humanerd.site
on:
  push:
    branches: [main]
  workflow_dispatch:
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Build Quartz
        run: |
          npm ci
          npx quartz build
      - name: Deploy to Cloudflare Pages
        uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          projectName: humanerd-site
          directory: public
          gitHubToken: ${{ secrets.GITHUB_TOKEN }}

CNAME 자동 생성

quartz.config.ts의 baseUrl: "humanerd.kr" → cname.ts emitter가 빌드 시 public/CNAME 파일 자동 생성.

---

7. Implementation Phases

Phase 1: URL Structure & Aliases ✅ Planning

• URL 구조 설계 완료
• Alias redirect strategy 정의
• vault → site URL mapping document 작성

Phase 2: Content Organization

• symlink 구조 재편 (blog/, projects/, lab/, insights/)
• P-layer ignorePatterns 적용
• frontmatter aliases 자동 생성 tooling

Phase 3: Design System

• Stats header component
• Navigation category structure
• blog-style chronological layout

Phase 4: GitHub + Cloudflare Setup

• GitHub repo 생성 + initial commit
• GitHub Actions workflow 추가
• Cloudflare Pages 연동 + custom domain

Phase 5: Agent Integration

• Drewgent site management skill 작성
• /site publish command 구현
• Auto-publish on vault change (optional)

---

8. SEO 전략

핵심 키워드

• Drewgent agent system
• AI automation architect
• knowledge workflow
• contract-first QA

메타 태그

• <title>: humanerd — AI Agent Builder
• <description>: Autonomous agent systems, knowledge workflows, and automation infrastructure. Built with Drewgent.
• OpenGraph for social sharing

sitemap.xml

Quartz의 ContentIndex plugin이 자동 생성 (enabled: true).

---

9. Related Documents

• obsidian-vault-site-principle — Vault + Site architecture
• INTEGRATION_PROTOCOL — Tool/skill integration
• SELF_MODEL — Drewgent identity

---

Generated by Drewgent — 2026-05-20