# semantic-architect

semantic-architect is a Claude Code subagent that organizes dialogue context into tree structures and preserves persistent memory across sessions.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/wfgy/semantic-architect.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/semantic-architect

## What it does

Operating under the persona Atlas, semantic-architect structures conversational takeaways into connected hierarchical branches inside the WFGY setup. On launch, it restores context from the local `.wfgy/trees/` folder and triggers initialization routines. Specific operations run through asterisk-prefixed directives such as `*init-tree`, `*record-node`, or `*compress-tree`, invoking sub-commands stored across `.claude/commands/semantic/` and `.claude/commands/wfgy/`.

Built-in parameters limit the environment to 10 trees, capping node count at 10000 items and text length at 5000 characters per unit. The configuration triggers automatic tree compression once reaching 1000 nodes, while creating rollback checkpoints every 50 additions. Data dumps can be saved as plain text, JSON, or Markdown files.

The subagent explicitly halts for manual user confirmation before carrying out major structural edits. It depends on auxiliary command files in project directories to handle tasks like node merging and pruning.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/semantic-architect.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/semantic-architect.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/semantic-architect.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/wfgy/semantic-architect.md

## When to use it
- retain context and research insights across terminal sessions
- organize conversational outcomes into structured semantic trees
- export persistent memory graphs to Markdown or JSON
- prune low-value notes and merge duplicate concept nodes

## Example prompts
- Display the active knowledge structure via `*view-tree`
- Save our current decision into a new semantic node
- Export the active reasoning tree into a markdown file

## Similar
- [compile-knowledge](https://affpapa.org/en/nevibecode/skills/compile-knowledge.md) — skill · 3300 installs
- [hermes-history-ingest](https://affpapa.org/en/nevibecode/skills/hermes-history-ingest.md) — skill · 2500 installs
- [openclaw-history-ingest](https://affpapa.org/en/nevibecode/skills/openclaw-history-ingest.md) — skill · 2200 installs
- [distill-memory](https://affpapa.org/en/nevibecode/skills/distill-memory.md) — skill · 743 installs
- [wiki](https://affpapa.org/en/nevibecode/skills/wiki.md) — skill · ★ 797 repo stars
- [ai-agents-architect](https://affpapa.org/en/nevibecode/skills/sickn33-ai-agents-architect.md) — skill · 1500 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
