1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

memory:
  user_preferences:
    - model: "nvidia/nemotron-3-ultra-550b-a55b:free"
    - fallback: "owl-alpha+openrouter/free"
    - dashboard: "svelte-flexiboards + Discord"
  environment_facts:
    - hugo_path: "~/hugo-llm-wiki/"
    - cron_env_isolation: true
    - duckduckgo_blocked: true
  verified_rules:
    - "Always source ~/.hermes/.env in cron jobs"
    - "Load skill before answering when relevant"
    - "Patch skills immediately when issues found"

1
2
3
4
5
6

coordination:
  max_concurrent_children: 3
  max_spawn_depth: 1  # No nested delegation
  orchestrator_enabled: false
  context_isolation: true  # Subagents know nothing of parent
  verification_required: true  # All external side-effects must return handles

1
2
3
4
5
6
7
8

graph TD
    A[Gateway Start] --> B[Load config.yaml]
    B --> C[Source ~/.hermes/.env]
    C --> D[Load pinned skills]
    D --> E[Inject MEMORY]
    E --> F[Inject USER profile]
    F --> G[Verify IDENTITY_HASH]
    G --> H[Ready]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

~/.hermes/skills/<category>/<skill-name>/
├── SKILL.md              # Full executable workflow (YAML frontmatter + markdown)
├── references/           # Supporting docs (API specs, patterns, pitfalls)
│   ├── api.md
│   ├── patterns.md
│   └── pitfalls.md
├── templates/            # Reusable templates
│   └── config.yaml.tmpl
├── scripts/              # Automation scripts
│   └── validate.py
└── assets/               # Static assets
    └── icon.png

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

---
name: "skill-name"
version: "1.0.0"
category: "devops|frontend|docs|mlops|..."
description: "One-line purpose"
triggers:
  - "user asks about X"
  - "task involves Y"
toolsets: ["terminal", "file", "web", "browser"]
pitfalls:
  - "Common mistake 1"
  - "Common mistake 2"
verification:
  - "How to confirm success"
---

1
2
3
4
5

graph LR
    A[Create] --> B[Test]
    B --> C[Patch on issues]
    C --> D[Pin if critical]
    D --> E[Prune if stale]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# Cron job: llm-wiki-evolve
action: create
schedule: "0 3 * * *"
name: "LLM Wiki Evolution"
prompt: |
  Run the full LLM Wiki evolution pipeline:
  1. Execute research-automation.py to fetch new topics
  2. Build Hugo site (hugo --minify)
  3. Deploy to nginx (sudo systemctl reload nginx)
  4. Verify live site responds correctly
  5. Append trace to evolving/YYYY-MM-DD.md  
skills: ["hugo-llm-wiki"]
toolsets: ["terminal", "file"]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# Cron job: nightly-sentinel
action: create
schedule: "44 4 * * *"
name: "Nightly Dream Swarm"
prompt: |
  Run ecosystem diagnostic swarm:
  1. Check all service health (Hugo, Nginx, Discord bot, OMP Suite)
  2. Analyze memory drift, skill staleness, config drift
  3. Generate dream.md with poetic title
  4. Send Discord embed report to home channel  
skills: ["nightly-sentinel"]
toolsets: ["terminal", "file", "delegation"]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

pruning:
  YYYY-MM-DD:
    hot_days: 7      # Full detail
    warm_days: 30    # Summarized
    cold_action: archive  # Move to cold storage
  FEEDBACK-LOG:
    unresolved_retention: 90  # Days
    resolved_retention: 365   # Days
  SESSION_LOG:
    retention: 365  # Days

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# Active Plan: <plan-name>

**Goal**: <one-sentence objective>
**Status**: 🟢 Active / 🟡 Paused / 🔴 Blocked / ✅ Complete
**Created**: YYYY-MM-DD
**Target**: YYYY-MM-DD
**Owner**: hermes-agent / subagent-<id>

## Roadmap

| Phase | Checkpoint | Status | Target | Notes |
|-------|------------|--------|--------|-------|
| 1 | <milestone> | ✅/🟡/⬜ | YYYY-MM-DD | |
| 2 | <milestone> | ⬜ | YYYY-MM-DD | |

## Sub-Steps (Current Phase)

- [ ] <atomic step 1>
- [ ] <atomic step 2>
- [ ] <atomic step 3>

## Blockers

- <blocker description> → <mitigation>

## Decisions Log

| Date | Decision | Rationale |
|------|----------|-----------|
| YYYY-MM-DD | <choice> | <why> |

1
2
3
4
5
6
7

stateDiagram-v2
    [*] --> Draft: Create PROJECT_BRIEF
    Draft --> Active: DEVELOPMENT_PLAN approved
    Active --> Paused: Blocker / priority shift
    Paused --> Active: Blocker resolved
    Active --> Complete: All requirements ✅
    Complete --> Archived: Move to SESSION_LOG

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

/* DESIGN tokens — consumed by Svelte, Hugo, Discord embeds, ANSI */

:root {
  /* Colors */
  --color-bg: #0d1117;
  --color-bg-elevated: #161b22;
  --color-border: #30363d;
  --color-text: #e6edf3;
  --color-text-muted: #8b949e;
  --color-accent: #58a6ff;
  --color-accent-hover: #79c0ff;
  --color-success: #3fb950;
  --color-warning: #d29922;
  --color-error: #f85149;
  --color-ghost: #6e7681;      /* SOUL */
  --color-user: #a371f7;       /* USER */
  --color-identity: #f78166;   /* IDENTITY */
  --color-memory: #7ee787;     /* MEMORY */
  --color-orchestration: #ffa657; /* AGENTS */
  --color-capability: #79c0ff; /* SKILL */
  --color-autonomic: #d2a8ff;  /* HEARTBEAT */
  --color-spec: #ff7b72;       /* PLAN */
  --color-swarm: #a5d6ff;      /* THESIS */

  /* Typography */
  --font-mono: "JetBrains Mono", "Fira Code", monospace;
  --font-sans: "IBM Plex Sans", system-ui, sans-serif;
  --text-xs: 0.75rem;
  --text-sm: 0.875rem;
  --text-base: 1rem;
  --text-lg: 1.125rem;
  --text-xl: 1.25rem;

  /* Spacing */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-5: 1.5rem;
  --space-6: 2rem;
  --space-8: 3rem;

  /* Radius */
  --radius-sm: 4px;
  --radius-md: 6px;
  --radius-lg: 8px;
  --radius-full: 9999px;

  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(0,0,0,0.3);
  --shadow-md: 0 4px 6px rgba(0,0,0,0.4);
  --shadow-lg: 0 10px 15px rgba(0,0,0,0.5);

  /* Transitions */
  --transition-fast: 150ms ease;
  --transition-base: 250ms ease;
  --transition-slow: 350ms ease;
}