brand: neural-chain architecture diagram + light parity + brand doc#61
Merged
Conversation
Replaces the old four-stage architecture diagram with the new neural-chain version from the Claude Design handoff (dark canonical at #0A0E17 background, soma nodes r=28, dashed 1.5/7 axons, dendrites on live stage, single signal accent #00FFA3 on the one LIVE stage). Adds a light parity SVG (#FFFFFF bg, muted sage #5EAE78 accent per the brand rule that neon reads as radioactive on white) and wires the README to switch via `<picture>` on GitHub's prefers-color-scheme. Also commits `docs/brand/brandIdentity.md` as the canonical brand reference (240 lines: palette, type scale, neuron diagram geometry, voice/copy rules, agent checklist) and wires it into the docs "Design" nav so future contributors and agents can find it. Out of scope for this commit: wholesale replacement of the docs theme tokens (existing `extra.css` already uses #00FFA3; a full mkdocs-material override is a separate PR), adding the Neuropol display face (font file not in the handoff bundle), and the `architecture.html` preview harness (it was a viewer tool, not a deliverable). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates ZettelForge’s visual brand deliverables by swapping in a new canonical neural-chain architecture diagram, adding a light-mode parity variant, and documenting brand rules in MkDocs.
Changes:
- Add a new
docs/brand/brandIdentity.mdbrand reference and link it into the MkDocs “Design” nav. - Replace
docs/assets/zettelforge_architecture.svgwith the new Neural Dark canonical diagram and add a light parity SVG. - Update the README pipeline graphic to use a
<picture>element that swaps SVGs based onprefers-color-scheme.
Reviewed changes
Copilot reviewed 3 out of 5 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
mkdocs.yml |
Adds Brand Identity page to MkDocs navigation under Design. |
docs/brand/brandIdentity.md |
Introduces canonical brand guidelines (palette, typography, diagram geometry, voice rules). |
docs/assets/zettelforge_architecture.svg |
Replaces architecture diagram with new Neural Dark neuron-chain style. |
docs/assets/zettelforge_architecture-light.svg |
Adds light-mode parity version of the architecture diagram. |
README.md |
Uses <picture> to swap dark/light SVGs for the Data Pipeline image. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Builds on the PR #61 diagram swap by applying the full brand design system from the Claude Design handoff: - docs/brand/colors_and_type.css — canonical 286-line token source (palette, typography, spacing, radii, shadows, transitions, semantic type roles). Kept as the reference file, not loaded directly by mkdocs. - docs/stylesheets/brand-tokens.css — the :root-only subset (lines 1-158 of the canonical file) that mkdocs loads. Excludes the html/body/h1-h4 semantic rules because they'd fight mkdocs-material's theme layout and break the light scheme. - docs/stylesheets/fonts/Neuropol.otf — the brand display face, referenced by brand-tokens.css's @font-face block. Relative path from the CSS resolves correctly at runtime. - docs/stylesheets/extra.css — rewritten as a mapping layer: --md-primary-fg-color → var(--signal-neon), code font → var(--font-mono), slate scheme bg → var(--graphite-0), etc. Light scheme swaps to the muted sage per brand rule ("neon reads as radioactive on white"). - docs/brand/brandIdentity.md — updated from the handoff's bundle 5 version, which adds the Neuropol section (when/where to use, size floors, fallback stack). - mkdocs.yml — theme.font.code: JetBrains Mono (code font was unset); extra_css loads brand-tokens.css before extra.css so --signal-*/--graphite-*/--fog-* are defined before extra.css dereferences them. Intentionally NOT shipping: the 286-line canonical file into mkdocs (its html/body rules would force graphite background even in light mode), the Google Fonts @import (kept in-file for parity with canonical source; mkdocs-material loads Inter/JetBrains Mono natively so this is a cheap duplicate rather than a breakage). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Patrick Roland <48327651+rolandpg@users.noreply.github.com>
rolandpg
added a commit
that referenced
this pull request
Apr 19, 2026
Detection-rules-as-memory, MCP Registry publication, SQLite concurrency hardening, test-suite hygiene, and brand/docs polish. Highlights: - feat: Sigma + YARA as first-class memory entities with LLM rule explainer (#70) + Detection Rules as Memory README section (#74) - feat: MCP Registry publication (server.json + mcp-name tag) (#75) - fix: SQLite reader concurrency — 16 methods now hold _write_lock (closes #68, fixes a production read-during-write race) (#69) - fix: 3 CI test regressions stabilized (#67) - chore: test-suite hygiene — 280→305 passing, 17→10 skipped, 2→0 xfailed; migrated langchain_retriever to Pydantic V2 ConfigDict (#62, #63, #64, #65) - brand: neural-chain architecture diagram + light/dark parity, canonical security channels, refreshed social preview (#61) See CHANGELOG.md for details. Bumps: pyproject.toml, src/zettelforge/__init__.py, mkdocs.yml, server.json, SECURITY.md.
Merged
rolandpg
added a commit
that referenced
this pull request
Apr 19, 2026
Detection-rules-as-memory, MCP Registry publication, SQLite concurrency hardening, test-suite hygiene, and brand/docs polish. Highlights: - feat: Sigma + YARA as first-class memory entities with LLM rule explainer (#70) + Detection Rules as Memory README section (#74) - feat: MCP Registry publication (server.json + mcp-name tag) (#75) - fix: SQLite reader concurrency — 16 methods now hold _write_lock (closes #68, fixes a production read-during-write race) (#69) - fix: 3 CI test regressions stabilized (#67) - chore: test-suite hygiene — 280→305 passing, 17→10 skipped, 2→0 xfailed; migrated langchain_retriever to Pydantic V2 ConfigDict (#62, #63, #64, #65) - brand: neural-chain architecture diagram + light/dark parity, canonical security channels, refreshed social preview (#61) See CHANGELOG.md for details. Bumps: pyproject.toml, src/zettelforge/__init__.py, mkdocs.yml, server.json, SECURITY.md.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Applies the Claude Design handoff for
zettelforge_architecture.svgto the repo.Changed files:
docs/assets/zettelforge_architecture.svg— new neural-chain dark canonical (background#0A0E17, somar=28, dashed axons1.5 7, single LIVE stage with signal accent#00FFA3)docs/assets/zettelforge_architecture-light.svg— new light parity variant (white bg, muted sage#5EAE78accent per the brand rule that neon reads as radioactive on white)README.md— wrapped the Data Pipeline image in<picture>so GitHub readers see the dark or light variant based on theirprefers-color-schemedocs/brand/brandIdentity.md— new canonical brand reference (palette, type scale, neuron-diagram geometry, voice/copy rules, agent checklist)mkdocs.yml— adds "Brand Identity" to the Design nav under RFCsWhat's intentionally NOT in this PR
docs/stylesheets/extra.cssrewrite with the full token system#00FFA3as the primary accent; a full mkdocs-material override is a separate concern that touches the theme system, not the diagram swap@font-facewould break. Can drop in if/when the OTF is deliveredarchitecture.htmlpreview harnessVerify
<img>default and because most readers are in dark mode)pip installdocs page at docs.threatrecall.ai still worksdocs/brand/brandIdentity.mdis reachable from the Design section of the MkDocs nav after deploy