Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,24 +10,24 @@ See [docs/architecture.md](docs/architecture.md) for the boundary.

Hadron is the platform's institutional memory. Relevant memories:

- `hrn:memory:hadronmemory.com::hadrontool-pdf` — this tool's own findings/conventions
- `hrn:memory:hadronmemory.com::dev` — shared findings, conventions, ops, the `preflight` routing index
- `hrn:memory:hadronmemory.com::hadron-server` — the caller; newer server findings/conventions
- `hrn:memory:hadronmemory.com::specs` — product specs (loc-as-citation). This service implements
- `hrn:mem:hadronmemory.com:hadrontool-pdf` — this tool's own findings/conventions
- `hrn:mem:hadronmemory.com:dev` — shared findings, conventions, ops, the `preflight` routing index
- `hrn:mem:hadronmemory.com:hadron-server` — the caller; newer server findings/conventions
- `hrn:mem:hadronmemory.com:specs` — product specs (loc-as-citation). This service implements
the PDF render path of the **export contract** at `cor:int:020:02` (presentation export; HTML/PDF
phases tracked in hadron-server#394).

(1) **Query Hadron before reading code.** For the topics/entities in a request, run
`hadron_find_nodes` first, then `hadron_get_node` on promising hits; cite node `loc` values.

(2) Read `hadron_get_node hrn:node:hadronmemory.com::dev::instructions` once per session (what
Hadron is, URN grammar, the specs corpus), and `hadron_get_node hrn:node:hadronmemory.com::dev::preflight`
(2) Read `hadron_get_node hrn:node:hadronmemory.com:dev:instructions` once per session (what
Hadron is, URN grammar, the specs corpus), and `hadron_get_node hrn:node:hadronmemory.com:dev:preflight`
before a change (the shared server/platform routing index).

(3) Capture a non-obvious finding the moment it emerges (`hadron_create_node` / `hadron_update_node`) —
don't batch to end-of-session.

(4) The **Hadron CLI is a superset of the MCP tools**: e.g. `hadron spec get cor:int:020:02 -m hadronmemory.com::specs`.
(4) The **Hadron CLI is a superset of the MCP tools**: e.g. `hadron spec get cor:int:020:02 -m hadronmemory.com:specs`.

## Quick reference

Expand Down
2 changes: 1 addition & 1 deletion docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ implementation spec.

| Prior art | What we take from it |
|---|---|
| [`design:export-node-pdf`](hrn:node:hadronmemory.com::hadron-server::design:export-node-pdf) | The whole boundary analysis. It recommends **splitting the PDF pipeline at HTML→PDF**: hadron-server keeps auth + decryption + node loading; a **stateless renderer holds no DB, no keys, no access-control logic**. It also picks **Chromium (Puppeteer)** over pure-JS for Markdown fidelity, rules out hosted SaaS render APIs (in-infra privacy posture), and says **delete any `/tmp` "file mode."** This tool is that renderer. |
| [`design:export-node-pdf`](hrn:node:hadronmemory.com:hadron-server:design:export-node-pdf) | The whole boundary analysis. It recommends **splitting the PDF pipeline at HTML→PDF**: hadron-server keeps auth + decryption + node loading; a **stateless renderer holds no DB, no keys, no access-control logic**. It also picks **Chromium (Puppeteer)** over pure-JS for Markdown fidelity, rules out hosted SaaS render APIs (in-infra privacy posture), and says **delete any `/tmp` "file mode."** This tool is that renderer. |
| [hadrontool-email architecture](https://github.com/hadron-memory/hadrontool-email) | The "a tool is a separate process that owns one provider-specific concern" shape, and the deployment model (separate container alongside hadron-server). |

**One difference from the design node, by request:** the node's recommendation
Expand Down
Loading